生成 & 查询

此页面包含生成音乐，生成歌词，上传音频至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-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

negative_tags

string

否

不希望生成的风格标签 自定义模式专用

style_weight

number

否

音频风格权重 0-1之间 自定义模式专用

weirdness_constraint

number

否

音频奇妙度权重 0-1之间 自定义模式专用

isStorage

boolean

否

是否转存，false即返回官方源地址。 可选值 true false，默认true

hookUrl

string

否

回调通知地址，当设置此参数，任务成功或者失败降会向该地址发送一个post请求，携带数据与查询任务结果中返回一致

Response

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

生成歌词

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

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

上传音频【免费】

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

是

音频地址 必须是可公开访问的音频地址

Response

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

查询任务结果

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接口查询返回结构一致

生成音乐接口、延伸音乐接口、延伸音乐合并接口、音乐翻版、添加声线、添加伴奏 返回的数据格式是一致的

{
    "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"
            }
        ]
    }
}
PreviousSunoNext修改、延续操作

Last updated

Was this helpful?