Responses 生成音乐

接口与鉴权

POST https://top.qingyuntop.ai/v1/responses

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

参数与转换

model 填 suno_music。input 写主题、语言和风格；插件会把提取出的文本放入上游 gpt_description_prompt。metadata.mv 选择上游歌曲版本，metadata.make_instrumental 控制纯音乐；两者不要放在请求顶层。

如果 metadata 已经有非空 gpt_description_prompt，会优先使用该字段，不再用 input 覆盖它。自定义歌词请改用专门示例，不要将歌词直接作为灵感描述发送。

代码示例

curl --fail-with-body "https://top.qingyuntop.ai/v1/responses" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "suno_music",
  "input": "一首描写清晨海边的中文民谣，温暖女声，木吉他伴奏。",
  "metadata": {
    "mv": "chirp-v3-0",
    "make_instrumental": false
  },
  "background": true
}'

保存 ID 后查询

后台提交响应的简化结构如下；status 也可能是 in_progress：

{"id":"resp_EXAMPLE","object":"response","status":"queued","background":true,"model":"suno_music","output":[],"metadata":{"task_id":"task_EXAMPLE","task_status":"queued","retrieval_path":"/v1/responses/resp_EXAMPLE"}}

用 id 调用 GET /v1/responses/{response_id}，按查询与结果解析处理完成结果。创建时没有立即拿到音频是正常行为。