跳转到主要内容
POST
音效生成
也可以用统一任务接口 POST /v1/task/submit 提交:model 填 suno/sounds,参数放进 input。两种写法效果与计费完全一样。
任务成功后,data.musics 里是产出的曲目,一次 1 条。部分成功时按实际成功的条数计费。
string
必填
曲目 ID。续写、翻唱、分轨、导出等后续操作都填它。
string
标题。
string
风格标签。
string
歌词,纯伴奏没有这个字段。
string
音频地址,可直接下载。
string
封面图地址。
string
大尺寸封面图地址。
string
视频地址,没有视频时不返回。
number
时长,单位秒。

授权

Authorization
string
header
必填

在请求头 Authorization: Bearer YOUR_API_KEY 里带上 API Key。

请求体

application/json
sound
string
必填

音效描述:描述想要的音效,例如「一声轻柔的雨滴」。

mv
enum<string>
默认值:chirp-v6

模型版本:三个版本价格相同,按需要的风格选择。可选值:chirp-v6 v6(默认,均衡);chirp-v6-wild v6 Wild(风格更奔放);chirp-v6-mini v6 Mini(更快)。

可用选项:
chirp-v6,
chirp-v6-wild,
chirp-v6-mini
type
enum<string>
默认值:one-shot

音效类型:单次触发的音效,还是可以无缝循环的音效。可选值:one-shot 单次触发;loop 无缝循环。

可用选项:
one-shot,
loop
bpm
string

节拍:每分钟拍数,1 到 300 之间。

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
audio_format
enum<string>

输出格式:成品音频的格式,不填默认 mp3。可选值:mp3 MP3(通用);m4a M4A;wav WAV(无损)。

可用选项:
mp3,
m4a,
wav
notify_hook
string<uri>

推送地址:任务结束后,把和查询结果相同的内容 POST 到这个地址(公网可以访问的 http / https 地址)。不传就自己查询。

响应

OK

code
enum<string>
必填
可用选项:
success
data
object
必填
message
string