接口与鉴权

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

请求头为 Authorization: Bearer YOUR_API_KEY 和 Content-Type: application/json。路径自动选择 suno_music，无需再填写 model。

参数与调用步骤

  1. 用 gpt_description_prompt 描述歌曲，make_instrumental 设为 false。
  2. 提交 JSON 后检查 HTTP 状态与业务字段 code，成功时保存 data 中的任务 ID。
  3. 查询任务，等 status 为 SUCCESS 后下载音频。

不要同时传入自定义歌词 prompt；非空描述会让上游采用灵感分支。mv 示例使用插件默认值 chirp-v3-0，版本含义及可用性见参数说明。

代码示例

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": false,
  "mv": "chirp-v3-0"
}'

提交响应

成功提交的结构示例，ID 是占位符：

{"code":"success","message":"","data":"TASK_ID"}

data 是任务 ID 字符串，不是歌曲 ID、音频链接或完整歌曲。查询时原样使用它，不要自行改前缀。一个任务可能返回多首歌曲，每首歌另有自己的 id。

常见问题

如果创建超时且没有拿到任务 ID，先到控制台核对是否已经提交，避免重复计费。若返回 FAILURE，检查 fail_reason；更换模型版本应依据已确认的上游能力，不能靠枚举旧文档中的版本逐个重试。