查询任务状态

GET

/suno/music/getState

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

30 = 该 item 成功 → 取 cld2AudioUrl、cld2ImageUrl

40 = 该 item 失败

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

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Query 参数

返回响应

🟢200成功

application/json

Bodyapplication/json

请求示例

Shell

JavaScript

Java

Swift

curl --location 'https://api.uniapi.io/suno/music/getState?taskBatchId=undefined' \
--header 'Authorization: Bearer <token>'

响应示例

{
    "code": 200,
    "msg": "您已成功提交创作任务,目前剩余并发任务数为99",
    "data": {
        "taskBatchId": "1261459775314190337",
        "taskStatus": "create",
        "items": [
            {
                "id": "2054580119347007490",
                "inputType": "10",
                "clipId": "8f8bf4ba-7b7d-4012-ab49-8f12862789b0",
                "title": "Peach Popsicle",
                "tags": "string",
                "prompt": "string",
                "gptDescriptionPrompt": "string",
                "duration": 194.56,
                "progress": 100,
                "status": 10,
                "progressMsg": "Production completed",
                "cld2AudioUrl": "http://example.com",
                "cld2VideoUrl": "http://example.com",
                "cld2ImageUrl": "http://example.com",
                "createTime": "2019-08-24T14:15:22.123Z"
            }
        ]
    }
}

修改于 2026-05-14 10:22:22

生成歌词

图像编辑