Suno 音乐生成 API 文档

curl --request POST \ --url https://api.ttapi.io/suno/v1/music \ --header 'Content-Type: application/json' \ --header 'TT-API-KEY: <api-key>' \ --data ' { "custom": false, "instrumental": false, "mv": "chirp-v5", "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, "auto_lyrics": false, "persona_id": "<string>", "isStorage": true, "hookUrl": "<string>" } '

授权

TT-API-KEY

string

header

必填

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

请求体

application/json

custom

boolean

默认值:false

必填

是否使用自定义模式。

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

instrumental

boolean

默认值:false

必填

是否生成纯音乐。

true：生成纯音乐
false：生成含歌词音轨，
- 灵感模式下 gpt_description_prompt 参数必填
- 自定义模型下 prompt 参数必填

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

gpt_description_prompt

string

灵感模式提示词

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

示例:

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

prompt

string

歌词

自定义模式下(custom=true)：当 instrumental 为 false 时必填。将作为歌词使用并在生成的音轨中演唱，最多5000字符。

title

string

音乐标题

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

响应

请求成功

status

string

必填

示例:

"SUCCESS"

message

string

必填

示例:

"success"

data

object

必填

示例:

{
  "job_id": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}