Suno 生成音乐
提交 Suno 音乐生成任务,成功后返回 Suno 任务 ID,可通过 /suno/fetch/{task_id} 查询结果。生成音乐接口只提交任务,不直接返回最终音频;部分兼容接口会一次返回两个 Suno 任务 ID,客户端需要分别轮询或等待 Webhook 回调。
支持 Suno 灵感模式、固定自定义歌词模式、续写、纯音乐和音轨分离等参数组合。灵感模式通常传入 gpt_description_prompt、tags、mv 和 title;固定自定义歌词模式传入 prompt 歌词文本;音轨分离可传入 task: gen_stem、continue_clip_id、stem_task 等字段。prompt 在自定义模式最多 3000 字,灵感模式最多 200 字;tags 风格标签最多 120 字。传入知名艺术家名称可能无法生成。
mv 表示 Suno 模型版本,常用可选值包括 chirp-v4、chirp-v3-5、chirp-bluejay、chirp-auk、chirp-fenix。其中 chirp-fenix 对应 Suno 5.5 / 最新版;不传时通常按渠道默认模型处理。
已兼容 GoAmz 格式,GoAmz 接入地址前缀为 {{BaseURL}}/suno/v1,GoAmz 切换 v3.5 接入地址前缀为 {{BaseURL}}/suno/v1/mv-3.5。已兼容 SunoAPI 格式,SunoAPI 接入地址前缀为 {{BaseURL}}/suno。
Authorization
bearerAuth 使用 Authorization Bearer API Key 进行鉴权。
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
curl -X POST "https://example.com/suno/submit/music" \ -H "Content-Type: application/json" \ -d '{ "gpt_description_prompt": "", "tags": "emotional punk", "mv": "chirp-fenix", "title": "乡愁" }'{
"code": "success",
"msg": "成功",
"data": "c47ec1cf-7e79-4e61-b9fb-2ca2ac36e57b",
"message": "",
"exec_time": 0,
"ip": "string"
}{
"error": {
"code": "string",
"message": "string",
"request_id": "string"
}
}