接口与鉴权

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

请求头:Authorization: Bearer YOUR_API_KEY、Content-Type: application/json。

参数与模式

灵感方式使用 gpt_description_prompt 描述器乐场景,再设 make_instrumental: true。自定义方式改用 title 和 tags,将 prompt 留空,省略 gpt_description_prompt。两种模式的字段不要混填。

true 必须是 JSON 布尔值,不能写成字符串 "true"。mv 与普通歌曲共用规则;没有单独的 suno_instrumental 模型。

灵感纯音乐示例

curl --fail-with-body "https://top.qingyuntop.ai/suno/submit/music" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "gpt_description_prompt": "适合安静阅读的纯器乐,柔和钢琴与弦乐,舒缓节奏。",
  "make_instrumental": true,
  "mv": "chirp-v3-0"
}'

自定义纯音乐可将上述请求体替换为:

{"prompt":"","title":"静读时光","tags":"instrumental, soft piano, strings, slow tempo","make_instrumental":true,"mv":"chirp-v3-0"}

提交返回任务 ID,之后查询任务并下载 MP3。本接口的纯音乐开关不表示后期人声分离或伴奏提取。