自定义歌词生成歌曲

接口与鉴权

POST https://top.qingyuntop.ai/suno/submit/music

使用 Authorization: Bearer YOUR_API_KEY 和 Content-Type: application/json。和灵感模式是同一个入口，通过请求字段区分创作模式。

参数

• prompt：歌词正文，可用换行和 [Verse]、[Chorus] 等段落提示；这些提示不保证逐字控制编曲。
• title：歌曲标题。
• tags：风格、配器和人声描述，如 Mandarin folk, acoustic guitar。
• make_instrumental：设为 false，生成有歌词的歌曲。
• mv：上游歌曲版本，示例使用插件默认值。完整规则见参数说明。

必须省略 gpt_description_prompt 或保持为空；非空时上游会改用灵感模式并清空歌词。若还没有歌词，先使用生成歌词。

代码示例

curl --fail-with-body "https://top.qingyuntop.ai/suno/submit/music" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "prompt": "[Verse]\n清晨的风吹过海岸\n你的笑容像阳光\n[Chorus]\n让我们向着远方歌唱",
  "title": "清晨海岸",
  "tags": "Mandarin folk, acoustic guitar, warm female vocal",
  "make_instrumental": false,
  "mv": "chirp-v3-0"
}'

获取结果

确认 code 为 success，保存 data 中的任务 ID，再查询单个任务。成功后结果 data 通常是歌曲数组；不要只取数组的第一项就丢弃其余歌曲。下载方法见下载音乐与封面。