Suno Sounds API 文档

curl --request POST \ --url https://api.ttapi.io/suno/v1/sounds \ --header 'Content-Type: application/json' \ --header 'TT-API-KEY: <api-key>' \ --data ' { "sound": "<string>", "mv": "chirp-v5", "type": "one-shot", "bpm": 123, "isStorage": true, "hookUrl": "<string>" } '

授权

TT-API-KEY

string

header

必填

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

请求体

application/json

sound

string

必填

描述你想要的声音

enum<string>

默认值:chirp-v5

必填

使用模型

可用选项:

chirp-v5-5,

chirp-v5

type

enum<string>

默认值:one-shot

必填

音效类型， one-shot=单拍音效、loop=循环音效

可用选项:

one-shot,

loop

bpm

integer

每分钟节拍数, 可选值：300 ≥ bpm ≥ 1

key

enum<string>

音调

可用选项:

C,

C#,

Cm,

C#m,

D,

D#,

Dm,

D#m,

F,

F#,

Fm,

F#m,

G,

G#,

Gm,

G#m,

A,

A#,

Am,

A#m,

B,

B#,

Bm,

B#m

isStorage

boolean

默认值:true

是否转存

true：音频将进行转存，返回TTAPI CDN地址
false：返回官方源地址

hookUrl

string

回调通知地址

响应

请求成功

status

string

必填

示例:

"SUCCESS"

message

string

必填

示例:

"success"

data

object

必填

示例:

{
  "job_id": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}