查询任务状态

轮询任意 Producer 异步任务的状态。

状态流转

NOT_START -> SUBMITTED -> QUEUED -> IN_PROGRESS -> SUCCESS / FAILURE

轮询

单任务查询：GET /producer/fetch/{id}

批量任务查询：POST /producer/fetch，请求体 {"ids":["task_xxx"]}

建议轮询间隔：10-15 秒

返回的记录仅限于当前身份验证用户或 token 持有者

失败任务自动退费

结果结构

data 是 CCAPI 持久化的任务记录

data.status 是任务状态

data.progress 是进度字符串，如 20% 或 100%

data.data 是归一化的操作结果数据

音乐类操作通常返回 data.data.clips[]

CCAPI 保持响应结构稳定，不暴露上游 provider 内部细节。

返回响应

🟢200成功

application/json

任务状态

Body

示例

任务进行中任务已完成

{
    "code": "success",
    "message": "",
    "data": {
        "id": 3,
        "created_at": 1773385820,
        "updated_at": 1773385828,
        "task_id": "task_BE5vsWPK0pWHyONbGVEXqsPqD6IkcBY6",
        "platform": "producer",
        "user_id": 3,
        "group": "producer-A",
        "channel_id": 28,
        "quota": 30000,
        "action": "MUSIC",
        "status": "IN_PROGRESS",
        "fail_reason": "",
        "submit_time": 1773385820,
        "start_time": 1773385828,
        "finish_time": 0,
        "progress": "20%",
        "properties": {
            "input": "",
            "upstream_model_name": "producer_music",
            "origin_model_name": "producer_music"
        },
        "data": {
            "progress": "20%",
            "status": "IN_PROGRESS",
            "task_id": "ef74a9d9-6c9f-47aa-a771-1006e987e331"
        }
    }
}

🟠400请求有误

🟠401未认证

查询任务状态

状态流转

轮询

结果结构

请求参数

请求示例代码

返回响应

查询任务状态

状态流转#

轮询#

结果结构#

请求参数

请求示例代码

返回响应

状态流转

轮询

结果结构