查询任务状态

轮询任何 Suno 异步任务的状态（音乐生成、音轨提取、翻唱等）。

状态流转

NOT_START → SUBMITTED → QUEUED → IN_PROGRESS → SUCCESS / FAILURE

轮询建议

建议轮询间隔：5-10 秒

任务完成后，data.data 包含归一化的结果

data.progress 显示进度百分比（如 "50%"）

失败任务的 data.fail_reason 包含错误原因

返回响应

🟢200成功

application/json

任务状态

Body

示例

Task in progressTask completed

{
    "code": "success",
    "message": "",
    "data": {
        "id": 4,
        "created_at": 1773385996,
        "updated_at": 1773386004,
        "task_id": "task_xoHpRiNr8KXFmmXLWkKczlSJwycIkD1X",
        "platform": "suno",
        "user_id": 3,
        "group": "suno-A",
        "channel_id": 27,
        "quota": 40000,
        "action": "MUSIC",
        "status": "IN_PROGRESS",
        "fail_reason": "",
        "submit_time": 1773385996,
        "start_time": 1773386004,
        "finish_time": 0,
        "progress": "20%",
        "properties": {
            "input": "",
            "upstream_model_name": "suno_music",
            "origin_model_name": "suno_music"
        },
        "data": {
            "progress": "20%",
            "status": "IN_PROGRESS",
            "task_id": "abf7366c-e769-4cdd-be0f-256d10399f33"
        }
    }
}

🟠400请求有误

🟠401未认证

查询任务状态

状态流转

轮询建议

请求参数

请求示例代码

返回响应

查询任务状态

状态流转#

轮询建议#

请求参数

请求示例代码

返回响应

状态流转

轮询建议