Skip to Content
goldflow.cc 文档
音频与其他Suno

Suno 生成音乐

POST
/suno/submit/music

提交 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 字。传入知名艺术家名称可能无法生成。

Suno 已上线 v6,并下线此前所有版本。v6 的 mv 为 chirp-hawk。此前所有模型的请求均已直接重定向至 v6。

mv 表示 Suno 模型版本,建议显式传入 chirp-hawk。历史模型代码包括 chirp-v4、chirp-v3-5、chirp-bluejay、chirp-auk、chirp-fenix,旧代码仅作为兼容入口保留,不再提供旧版本生成能力。渠道选用与计费仍按 suno_music,无需额外添加同名渠道模型。

已兼容 GoAmz 格式,GoAmz 接入地址前缀为 {{BaseURL}}/suno/v1,GoAmz 切换 v3.5 接入地址前缀为 {{BaseURL}}/suno/v1/mv-3.5。已兼容 SunoAPI 格式,SunoAPI 接入地址前缀为 {{BaseURL}}/suno。

Authorization

bearerAuth
headerAuthorizationBearer <API key>

使用 Authorization Bearer API Key 进行鉴权。

Request Body

application/json
  1. body

Suno 音乐生成请求。

gpt_description_prompt?string

灵感模式下的音乐描述提示词,为空时可结合 tags 和标题生成。

prompt?string

固定自定义歌词模式下的歌词文本,也可用于其他 Suno 兼容格式的提示词。自定义模式最多 3000 字,灵感模式最多 200 字;传入知名艺术家名称可能无法生成。

tags?string

音乐风格标签最多 120 字,可填写风格、乐器、人声、节奏等提示。

negative_tags?string

排除风格或不希望出现的元素。

mv?string

Suno 已上线 v6,模型版本 mv 为 chirp-hawk。此前所有版本均已下线,使用旧模型代码的请求均直接重定向至 v6;建议显式传入 chirp-hawk。

title?string

歌曲标题。

make_instrumental?|

是否纯音乐,传 1 表示生成纯音乐,传 0 或 false 表示非纯音乐;在特定任务中也可作为音轨分离参数使用。

task?string

Suno 任务类型,例如 gen_stem 表示音轨分离。

stem_task?string

音轨分离任务类型。

task_id?string

需要继续处理的 Suno 任务 ID。

continue_clip_id?string

续写或音轨分离时使用的上一段官方 clip_id,也可传已有 task_id。

continue_at?|

续写时间点,即从上一段的什么时间点开始续写,单位通常为秒。

cover_clip_id?string

用作封面或参考的歌曲片段 ID。

custom_mode?|

是否自定义模式,默认 0 表示灵感模式,1 表示自定义模式。

metadata?

扩展元数据。可包含 control_sliders 等上游高级控制参数。

callback_url?string

Webhook 回调 URL。音乐生成完毕后,生成结果会主动以 POST 形式发送到该地址。

Formaturi
gen_params?

Suno 兼容格式或上游扩展生成参数。

[key: string]?any

Response Body

Suno 音乐任务提交响应。

application/json
  1. response

Suno 任务提交响应。

code?|

提交结果状态。

msg?string

提交结果消息,兼容部分上游返回字段。

data?|array<>

Suno 任务 ID 或任务列表。

message?string

提交结果消息。

exec_time?number

上游接口执行耗时,单位通常为秒。

ip?string

上游返回的请求来源 IP。

[key: string]?any
curl -X POST 'https://goldflow.cc/suno/submit/music' \  -H 'Content-Type: application/json' \  -d '{  "gpt_description_prompt": "",  "tags": "emotional punk",  "mv": "chirp-hawk",  "title": "乡愁"}'
Example Response
{  "code": "string",  "msg": "string",  "data": "string",  "message": "string",  "exec_time": 0,  "ip": "string"}