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

Suno 生成歌词

POST
/suno/submit/lyrics

提交 Suno 歌词生成任务,成功后返回任务 ID,可通过任务查询接口读取歌词结果。

Authorization

bearerAuth
headerAuthorizationBearer <API key>

使用 Authorization Bearer API Key 进行鉴权。

Request Body

application/json
  1. body
prompt*string

歌词生成提示词。

[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
Example Request
curl -X POST 'https://goldflow.cc/suno/submit/lyrics' \  -H 'Content-Type: application/json' \  -d '{  "prompt": "dance"}'
Example Response
{  "code": "string",  "msg": "string",  "data": "string",  "message": "string",  "exec_time": 0,  "ip": "string"}

生成音乐

提交 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`。

查询音乐任务

根据 Suno 任务 ID 查询单个音乐或歌词任务详情,包括状态、进度、音频 URL、封面、歌词文本和元数据。