查询单个创作任务状态(轮询)

Draw

https://drwa.openai-next.com

GET

/_open/suno/music/getState

免费

所有异步任务都用这个接口轮询(除了 voxStem 用 voxStemStatus、MP4 用 getMp4State)。

轮询逻辑:每 10 秒调用一次,直到 data.taskStatus == "finished"。然后根据 data.items[].status 判断真实结果:

30 = 该 item 成功 → 取 cld2AudioUrl、cld2ImageUrl

40 = 该 item 失败

⚠️ taskStatus=finished 不等于 全部成功 — 真实成功要看每个 item 的 status。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Query 参数

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://drwa.openai-next.com/_open/suno/music/getState?taskBatchId=1261459775314190337' \
--header 'Authorization: Bearer <token>'

返回响应

🟢200

application/json

任务状态

Bodyapplication/json

示例

任务还在跑任务完成且全部成功taskStatus=finished 但部分 item 失败

{
    "code": 200,
    "msg": "操作成功",
    "data": {
        "taskBatchId": "1261459775314190337",
        "taskStatus": "processing",
        "items": [
            {
                "id": "2054580119347007490",
                "clipId": "8f8bf4ba-7b7d-4012-ab49-8f12862789b0",
                "status": 20,
                "progress": 99,
                "progressMsg": "Creating music, this may take approximately 2-4 minutes"
            }
        ]
    }
}

修改于 2026-06-16 07:43:39

通过 URL 异步上传参考音频

批量查询任务状态