Suno 接口说明

接口

方法	路径	用途
POST	/suno/submit/music	生成音乐、纯音乐或续写
POST	/suno/submit/lyrics	生成歌词
POST	/suno/fetch	批量查询任务
GET	/suno/fetch/{task_id}	查询单个任务

请求头：

生成音乐

描述成歌：

{"gpt_description_prompt":"一首轻快的夏日中文流行歌曲","mv":"chirp-v5","make_instrumental":false}

自定义歌词：

{
  "prompt": "[Verse]\n海风吹过夏日海岸\n\n[Chorus]\n我们向着明天奔跑",
  "title": "夏日海岸",
  "tags": "mandopop, acoustic guitar, upbeat",
  "mv": "chirp-v5",
  "make_instrumental": false
}

gpt_description_prompt：歌曲描述；prompt：自定义歌词。

mv / model：模型名称，按请求传递，不补默认值；同时填写须一致。

make_instrumental：true 为纯音乐，false 为带人声歌曲。

歌词使用 \n 换行；[Style: ...] 可提取为 tags，已有非空 tags 优先。

续写传 continue_clip_id 和 continue_at（秒）；clip ID 取原歌曲结果的 id。

可选高级参数：negative_tags、metadata。

生成歌词

{"prompt":"写一首关于海边黄昏的中文歌词","mv":"chirp-v5"}

也支持 title、tags；混编时使用 prompt 和 lyrics_b。歌词接口只返回文本，生成歌曲使用音乐接口。

查询任务

提交成功后，使用响应 data 中的任务 ID 查询：

{"code":"success","message":"任务已接收","data":"task_EXAMPLE"}

批量查询请求体：

{"ids":["task_EXAMPLE"]}

GET 查询的外层 data 为单个任务，POST 查询为任务数组。以任务 status 判断结果：

状态	含义
NOT_START / SUBMITTED / QUEUED	等待中
IN_PROGRESS	生成中
SUCCESS	已完成，读取任务 `data`
FAILURE	已失败，查看 `fail_reason`
UNKNOWN	状态未知

音乐结果包含 audio_url、image_url、title、text；歌词结果读取 title、text。时间戳为 Unix 秒。外层 code=success 表示接口请求成功，不代表生成完成。

接口#

生成音乐#

生成歌词#

查询任务#

接口

生成音乐

生成歌词

查询任务