生成 & 查询

此页面包含生成音乐，生成歌词，上传音频至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-5+ chirp-v5 chirp-v4-5-all 默认chirp-v4-5+
custom	boolean	是	音频是否自定义 true - 音频将从歌词中生成 false - 音频将根据灵感模式提示词生成
instrumental	boolean	是	是否生成纯音乐 true 为生成纯音乐，true的情况下会忽略自定义歌词 默认为false
gpt_description_prompt	string	否	灵感模式提示词 根据此提示词自动生成歌词
prompt	string	否	歌词，自定义模式专用
title	string	否	标题，自定义模式专用
tags	string	否	风格标签，自定义模式专用，最大长度200字符
negative_tags	string	否	不希望生成的风格标签 自定义模式专用
style_weight	number	否	音频风格权重 0-1之间 自定义模式专用
weirdness_constraint	number	否	音频奇妙度权重 0-1之间 自定义模式专用
audio_weight	number	否	音频权重 0-1之间，自定义模式专用
auto_lyrics	boolean	否	是否自动生成歌词 自定义模式专用。 false - 使用输入的歌词生成音乐 true - 根据输入的歌词进行二次创作，与灵感模式提示词效果一致 默认false
vocal_gender	string	否	音色性别 Male - 男性 Female - 女性
persona_id	string	否	歌手风格ID
isStorage	boolean	否	是否转存，false即返回官方源地址。 可选值 true false，默认true
hookUrl	string	否	回调通知地址，当设置此参数，任务成功或者失败降会向该地址发送一个post请求，携带数据与查询任务结果中返回一致
generateVideo（废弃）	boolean	否	是否需要生成音频的同时生成视频，可选值 true false，默认false

Response

200

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

400

生成歌词

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

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

Headers

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

Body

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

Response

200

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

400

上传音频【免费】

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

上传音频至suno，得到music_id用以完成后续操作，此接口为免费接口

Headers

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

Body

参数	类型	是否必须	描述
audio_url	string	是	音频地址 必须是可公开访问的音频地址
is_async	boolean	否	是否异步 false - 同步等待 true - 异步查询 默认：false
hookUrl	string	否	回调通知地址，当设置此参数，任务成功或者失败降会向该地址发送一个post请求，携带数据与查询任务结果中返回一致

Response

200

{
    "status": "SUCCESS",
    "message": "success",
    "data": {
        "music_id": "51dd4085-7cbb-4b18-bba2-7e14f37299d4"
    }
}

400

查询任务结果

GET 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（歌词生成结果）

200（词曲分离结果）

200（全轨道词曲分离结果）

查询任务结果-V2

注意：v2版本目前对比v1仅歌词查询结果返回结构不一致

GET https://api.ttapi.io/suno/v2/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（歌词生成结果）

200（词曲分离结果）

200（全轨道词曲分离结果）