SunoAPI · 查询任务

GET

/suno/fetch/{task_id}

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 ********************

Path 参数

返回响应

🟢200

application/json

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

Bodyapplication/json

🟠400

🟠401

🟠404

⚪default

请求示例

Shell

JavaScript

Java

Swift

curl --location '/suno/fetch/task_example' \
--header 'Authorization: Bearer <token>'

响应示例

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:58

SunoAPI · 批量查询

Google Veo (Gemini API) · 创建 Veo 视频任务