🎵Suno

TTAPI Suno接口服务

生成音乐

POST https://api.ttapi.io/suno/v1/music

通过文字提示词或者自定义歌词生成音乐，注：每次请求生成两首音乐，不可拆分，定价详见

Headers

Name	Value
Content-Type	application/json
TT-API-KEY	用于请求授权 TT-API 的API密钥

Body

参数	类型	是否必须	描述
mv	string	是	使用模型 suno使用模型，支持 chirp-v3-0 chirp-v3-5 chirp-v4 chirp-v4-5 当前默认chirp-v4
custom	boolean	是	音频是否自定义 true - 音频将从歌词中生成 false - 音频将根据灵感模式提示词生成
instrumental	boolean	是	是否生成纯音乐 true 为生成纯音乐，true的情况下会忽略自定义歌词 默认为false
gpt_description_prompt	string	否	灵感模式提示词 根据此提示词自动生成歌词
prompt	string	否	歌词，自定义模式专用
title	string	否	标题，自定义模式专用
tags	string	否	风格标签，自定义模式专用，最大长度200字符
generateVideo	boolean	否	是否需要生成音频的同时生成视频，可选值 true false，默认false
hookUrl	string	否	回调通知地址，当设置此参数，任务成功或者失败降会向该地址发送一个post请求，携带数据与查询任务结果中返回一致

Response

200

{
  "status": "SUCCESS",
  "message": "",
  "data": {
    "jobId": "ed1a1b01-7d64-4c8a-acaa-71185d23a2f3"
  }
}

400

{
  "status": "FAILED",
  "message": "error message",
  "data": {}
}

音乐延伸

POST https://api.ttapi.io/suno/v1/extend

延伸生成音乐返回的两首歌其中的一首

Headers

Name	Value
Content-Type	application/json
TT-API-KEY	用于请求授权 TT-API 的API密钥

Body

参数	类型	是否必须	描述
music_id	string	是	歌曲ID，需要延长的歌曲
continue_at	int	是	延长的歌曲从上一首歌曲的多少秒开始延长，单位秒
prompt	string	否	歌词，自定义模式专用
title	string	否	标题，自定义模式专用
tags	string	否	风格标签，自定义模式专用
generateVideo	boolean	否	是否需要生成音频的同时生成视频，可选值 true false，默认false
hookUrl	string	否	回调通知地址，当设置此参数，任务成功或者失败降会向该地址发送一个post请求，携带数据与查询任务结果中返回一致

Response

200

{
  "status": "SUCCESS",
  "message": "",
  "data": {
    "jobId": "ed1a1b01-7d64-4c8a-acaa-71185d23a2f3"
  }
}

400

{
  "status": "FAILED",
  "message": "error message",
  "data": {}
}

获取完整音乐

POST https://api.ttapi.io/suno/v1/concat

获取延长音乐后的完整音乐内容，此接口免费

Headers

Name	Value
Content-Type	application/json
TT-API-KEY	用于请求授权 TT-API 的API密钥

Body

参数	类型	是否必须	描述
music_id	string	是	歌曲ID，上一步返回的music_id
hookUrl	string	否	回调通知地址，当设置此参数，任务成功或者失败降会向该地址发送一个post请求，携带数据与查询任务结果中返回一致

Response

200

{
  "status": "SUCCESS",
  "message": "",
  "data": {
    "jobId": "ed1a1b01-7d64-4c8a-acaa-71185d23a2f3"
  }
}

400

{
  "status": "FAILED",
  "message": "error message",
  "data": {}
}

生成歌词

POST https://api.ttapi.io/suno/v1/lyrics

根据提示词生成歌词，定价详见

Headers

Name	Value
Content-Type	application/json
TT-API-KEY	用于请求授权 TT-API 的API密钥

Body

参数	类型	是否必须	描述
prompt	string	是	提示词
hookUrl	string	否	回调通知地址，当设置此参数，任务成功或者失败将会向该地址发送一个post请求，携带数据与查询任务结果返回一致

Response

200

{
  "status": "SUCCESS",
  "message": "",
  "data": {
    "jobId": "ed1a1b01-7d64-4c8a-acaa-71185d23a2f3"
  }
}

400

{
  "status": "FAILED",
  "message": "error message",
  "data": {}
}

获取歌词时间线

POST https://api.ttapi.io/suno/v1/alignedLyrics

Headers

Name	Value
Content-Type	application/json
TT-API-KEY	用于请求授权 TT-API 的API密钥

Body

参数	类型	是否必须	描述
music_id	string	是	返回在每条歌曲数组中的musicId，注意非jobId

Response

200

{
  "status": "SUCCESS",
  "message": "success",
  "data": {
    "alignment": [
      {
        "end_s": 0.4787234042553192,
        "p_align": 1,
        "start_s": 0.39893617021276595,
        "success": true,
        "word": "[female voice][female vocals][verse]\nЧто"
      },
      {
        "end_s": 0.5585106382978724,
        "p_align": 1,
        "start_s": 0.4787234042553192,
        "success": true,
        "word": "б"
      },
      ...
     ]
   }
}   

400

{
  "status": "FAILED",
  "message": "error message",
  "data": {}
}

查询任务结果

POST https://api.ttapi.io/suno/v1/fetch

通过jobId查询当前音乐&歌词生成结果，免费接口

Headers

Name	Value
Content-Type	application/json
TT-API-KEY	用于请求授权 TT-API 的API密钥

Query参数

参数	类型	是否必须	描述
jobId	string	是	生成的音乐或者歌词的jobId

Response

异步回调josn结构与fetch接口查询返回结构一致

生成音乐接口、延伸音乐接口、延伸音乐合并接口返回的数据格式是一致的

200（音乐生成结果）

{
    "status": "SUCCESS",
    "message": "success",
    "jobId": "34505837-41f0-4c68-b830-e8e051b72148",
    "data": {
        "jobId": "34505837-41f0-4c68-b830-e8e051b72148",
        "action": "extend",
        "progress": "100%",
        "mv": "chirp-v3-0",
        "quota": "5",
        "hookUrl": null,
        "musics": [
            {
                "musicId": "a7d3712d-2507-4d87-80d0-b60bb375a049",
                "prompt": "[Verse]\n远方你的微笑\n穿越时空寻找\n夜晚的风轻飘\n心跳为你燃烧\n\n[Bridge]\n梦里花落几场\n想你思念成霜\n星光作伴凄凉\n入骨相思难忘\n\n[Chorus]\n思念入骨髓\n心已随风飞\n两地相隔泪\n只为与你归",
                "title": "思念入骨髓 (Longing in My Bones)",
                "tags": "harmonized melancholic traditional chinese",
                "imageUrl": "https://cdn2.suno.ai/image_a7d3712d-2507-4d87-80d0-b60bb375a049.jpeg",
                "imageLargeUrl": "https://cdn2.suno.ai/image_large_a7d3712d-2507-4d87-80d0-b60bb375a049.jpeg",
                "audioUrl": "https://cdn1.suno.ai/a7d3712d-2507-4d87-80d0-b60bb375a049.mp3",
                "videoUrl": "https://cdn1.suno.ai/a7d3712d-2507-4d87-80d0-b60bb375a049.mp4"
            },
            {
                "musicId": "ab763675-b371-44d5-ae1b-6aea35fe4403",
                "prompt": "[Verse]\n远方你的微笑\n穿越时空寻找\n夜晚的风轻飘\n心跳为你燃烧\n\n[Bridge]\n梦里花落几场\n想你思念成霜\n星光作伴凄凉\n入骨相思难忘\n\n[Chorus]\n思念入骨髓\n心已随风飞\n两地相隔泪\n只为与你归",
                "title": "思念入骨髓 (Longing in My Bones)",
                "tags": "harmonized melancholic traditional chinese",
                "imageUrl": "https://cdn2.suno.ai/image_ab763675-b371-44d5-ae1b-6aea35fe4403.jpeg",
                "imageLargeUrl": "https://cdn2.suno.ai/image_large_ab763675-b371-44d5-ae1b-6aea35fe4403.jpeg",
                "audioUrl": "https://cdn1.suno.ai/ab763675-b371-44d5-ae1b-6aea35fe4403.mp3",
                "videoUrl": "https://cdn1.suno.ai/ab763675-b371-44d5-ae1b-6aea35fe4403.mp4"
            }
        ]
    }
}

200（歌词生成结果）

{
    "status": "SUCCESS",
    "message": "success",
    "jobId": "f106f560-e148-4ea0-ab1a-d94e11a0f4f5",
    "data": {
        "jobId": "f106f560-e148-4ea0-ab1a-d94e11a0f4f5",
        "action": "lyrics",
        "progress": "100%",
        "prompt": "海阔天空",
        "text": "[Verse]\n在风中呼喊我还在等候\n远方的光芒犹如梦幻泡影\n世界太大我却无路可走\n海阔天空却迷失了方向\n\n[Verse 2]\n天边的云朵飘散在风中\n岁月像水流淌不停冲动\n心中的欲望如野火燃烧\n走向远方不问前路远\n\n[Chorus]\n海阔天空我的心依然自由\n穿越黑暗寻找那道光芒\n海浪拍打着心灵的执着\n信念无畏在风雨中闯荡\n\n[Verse 3]\n心灵的旅行无边的冲突\n找不到归途没有终点站\n生命的狂欢如烟花绽放\n梦醒时分泪洒满眼眶\n\n[Bridge]\n不怕跌倒不怕失去\n心中执念一路到底\n回头看那脚印深深\n海阔天空无怨无悔\n\n[Chorus]\n海阔天空我的心依然自由\n穿越黑暗寻找那道光芒\n海浪拍打着心灵的执着\n信念无畏在风雨中闯荡",
        "title": "海阔天空",
        "quota": "1",
        "hookUrl": "https://webhook-test.com/a9b086dc0e5a18c26053791aa93bd2c7"
    }
}