Responses 自定义歌词与纯音乐

接口与鉴权

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

使用 Authorization: Bearer YOUR_API_KEY 和 Content-Type: application/json，model 填 suno_music。

自定义参数

将已有歌词放在 metadata.prompt，标题放在 metadata.title，风格放在 metadata.tags，人声开关使用 metadata.make_instrumental: false。歌曲版本为 metadata.mv。

省略 input 和顶层 prompt，并且不要传 metadata.gpt_description_prompt。原因是插件先把 input 或顶层 prompt 变为歌曲描述，上游再优先采用灵感模式；仅仅存在 metadata.prompt 并不能阻止这个转换。

自定义歌词示例

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",
  "metadata": {
    "prompt": "[Verse]\n清晨的风吹过海岸\n[Chorus]\n让我们向着远方歌唱",
    "title": "清晨海岸",
    "tags": "Mandarin folk, acoustic guitar",
    "make_instrumental": false,
    "mv": "chirp-v3-0"
  },
  "background": true
}'

以上请求即使没有 input 也能通过插件检查，因为 metadata.prompt 已提供非空歌词。返回 Response ID 后查询结果。

纯音乐的区别

Responses 纯音乐推荐使用描述性 input 加 metadata.make_instrumental: true，即灵感纯音乐：

{"model":"suno_music","input":"适合阅读的柔和钢琴纯器乐。","metadata":{"make_instrumental":true,"mv":"chirp-v3-0"},"background":true}

仅有 title、tags、make_instrumental，而 input、gpt_description_prompt、prompt 全空时，Responses 插件会报 input is required。需要空歌词的自定义纯音乐请使用 SunoAPI 纯音乐接口，该入口没有这项 Responses 非空输入限制。

不支持的参数布局

不要把 title、tags、mv 或 make_instrumental 放到 Responses 顶层；插件不会自动读取它们。metadata.parameters 也不会自动展开。这里的 metadata 已经直接对应 SunoAPI 请求体。