SunoAPI · 批量查询

POST

/suno/fetch

SunoAPI，插件 sunoapi 1.1.0。源码：plugins/tasks/sunoapi/plugin.js。

单任务查询的 data 是任务对象，批量查询的 data 是任务数组（最多 100 个 ID）。批量请求中的任一 ID 不存在、不可检索或不属于当前用户时，整个请求返回 404。

使用网关 Bearer 令牌。查询返回当前用户的任务快照，上游状态由后台轮询更新。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数application/json必填

示例

返回响应

🟢200

application/json

创建确认或任务查询结果，字段随任务状态和厂商结果变化。

Bodyapplication/json

🟠400

🟠401

🟠404

🟠415

⚪default

请求示例

Shell

JavaScript

Java

Swift

curl --location '/suno/fetch' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "ids": [
        "task_example"
    ]
}'

响应示例

200 - 提交确认或等待中

示例使用固定任务数据，通过当前插件的响应函数生成。

{
  "code": "success",
  "message": "",
  "data": [
    {
      "created_at": 1792195200,
      "updated_at": 1792195230,
      "task_id": "task_example",
      "platform": "sunoapi",
      "status": "SUBMITTED",
      "fail_reason": "",
      "submit_time": 1792195200,
      "finish_time": 0,
      "progress": "0%",
      "data": {
        "message": "accepted"
      }
    }
  ]
}

修改于 2026-10-17 05:04:57

SunoAPI · 提交任务

SunoAPI · 查询任务