Suno Cover API 文档

curl --request POST \ --url https://api.ttapi.io/suno/v1/cover \ --header 'Content-Type: application/json' \ --header 'TT-API-KEY: <api-key>' \ --data ' { "custom": false, "mv": "chirp-v5", "music_id": "<string>", "gpt_description_prompt": "夜晚城市 lo-fi 钢琴搭配雨声，柔和人声唱段，主题：“在灯火阑珊处”", "prompt": "<string>", "title": "<string>", "tags": "rock, blues, hip-hop, r&b", "negative_tags": "<string>", "style_weight": 0.5, "weirdness_constraint": 0.5, "audio_weight": 0.5, "persona_id": "<string>", "isStorage": true, "hookUrl": "<string>" } '

授权

TT-API-KEY

string

header

必填

请前往 TTAPI 控制台获取 API 密钥。

请求体

application/json

custom

boolean

默认值:false

必填

是否使用自定义模式。

true：音频将从歌词中生成
false：音频将根据灵感模式提示词生成

enum<string>

默认值:chirp-v5

必填

使用模型

可用选项:

chirp-v5-5,

chirp-v5,

chirp-v4-5+,

chirp-v4-5,

chirp-v4-5-all,

chirp-v4,

chirp-v3-5,

chirp-v3-0

music_id

string

必填

要翻唱的音轨的音频ID

gpt_description_prompt

string

灵感模式提示词

非自定义模式下(custom=false)：始终必填。将根据此提示词自动生成歌词，最多3000字符。

示例:

"夜晚城市 lo-fi 钢琴搭配雨声，柔和人声唱段，主题：“在灯火阑珊处”"

prompt

string

歌词

custom=true时，prompt为空，默认生成纯乐器音频；prompt不为空，生成人声歌词音频

title

string

音乐标题

自定义模式下(custom=true)使用，最多80字符。

响应

请求成功

status

string

必填

示例:

"SUCCESS"

message

string

必填

示例:

"success"

data

object

必填

示例:

{
  "job_id": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}