批量查询任务

批量查询任务

一次读取多个音乐或歌词任务的当前状态，适合任务列表和后台轮询。查询不会创建新歌曲。

API Key application/json

接口与鉴权

POST https://top.qingyuntop.ai/suno/fetch

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

Request

请求

/suno/fetch

Body

必填

Bodyobject

clip_idstring必填

extend 后的歌曲ID

is_infillstring必填

路径、查询与 Header 参数

参数	位置	类型	必填	说明	示例
`Content-Type`	Header	string	是	-	application/json
`Accept`	Header	string	是	-	application/json
`Authorization`	Header	string	是	必填。使用青云TOP API 的 API Key，保留 Bearer 后的空格。	Bearer YOUR_API_KEY

请求示例application/json

curl --fail-with-body "https://top.qingyuntop.ai/suno/fetch" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "ids": [
    "TASK_ID_1",
    "TASK_ID_2"
  ]
}'

Response

返回响应 `200`

HTTP 响应

响应 200object

codestring必填

datastring必填

messagestring必填

代码示例

curl --fail-with-body "https://top.qingyuntop.ai/suno/fetch" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "ids": [
    "TASK_ID_1",
    "TASK_ID_2"
  ]
}'

返回与轮询

返回 code: "success"、message 与 data 数组；每个元素的结构与单任务查询中 data 的任务对象一致。

按 task_id 关联结果，分别处理 SUCCESS 和 FAILURE。其余状态保持等待。建议每 5–10 秒查询一次，将已完成任务从下一批中移除。

任一 ID 不存在、不可见或不属于该插件可查询的任务集合时，rc.38 会使整批查询返回 404，不会为其插入空对象。发生 404 时拆分查询定位错误 ID，不要直接判定整批生成失败。