批量获取任务

POSThttps://www.aipro2.com/suno/fetch

轮询入口之一。请求体为 task_id / clip id 列表（ids）。

注意：task_id 用于轮询任务；clip_id 用于续写/补段等，二者勿混用（API-Doc-Standards §2.4）。

根据任务 ID 列表批量查询任务或作品状态。

请求体参数

application/json

• action*string
  可空
• ids*array<string>
  数组

响应

成功

application/jsonSunoFetchResponse

• codestring
  业务状态码
• dataarray<object>
  数据载荷（常为 Base64 或结构化对象）
• messagestring
  提示信息

请求体示例示例 1

1{2  "ids": ["1264606079846457344"],                        // taskBatchId 数组3  "action": ""                                           // 可空4}

代码示例cURLPythonJavaScriptGoPHP

1curl -X POST "https://www.aipro2.com/suno/fetch" \2  -H "Authorization: Bearer <API Key>" \3  -H "Content-Type: application/json" \4  -d '"{\n  \"ids\": [\"1264606079846457344\"],                        // taskBatchId 数组\n  \"action\": \"\"                                           // 可空\n}"'

响应示例 · 200example

1{2  "code": "string",3  "data": [4    {5      "action": "string",6      "data": {},7      "fail_reason": "string",8      "status": "string",9      "task_id": "string"10    }11  ],12  "message": "string"13}