Logo

任务管理

任务管理接口提供任务列表查询和任务取消能力。所有图片、音频、视频任务都会落到统一的任务系统中，因此这些接口适用于全站所有异步处理能力。

任务进度查询

每个异步处理任务创建后都会返回 task_id。你可以继续使用各图片、音频、视频能力页里的查询接口轮询任务状态；如果前端需要更及时的进度条或状态变化通知，也可以通过 WebSocket 订阅任务进度。任务进度查询会在订阅成功后立即返回一次任务快照，并继续推送 queued、processing、completed、failed、cancelled 等状态变化。

详见 任务进度查询。

获取任务列表

基本信息

项目值
请求方法GET
请求路径/task/list
鉴权方式Authorization 请求头直接传 API Key

Query 参数

参数名类型必填默认值说明
statusstring否—任务状态筛选：queued / processing / completed / failed / cancelled
task_typestring否—任务类型，如 asr、image_purify、video_stabilizer
pagenumber否1页码
page_sizenumber否20每页数量

请求示例

curl -X GET "https://api.ai-mcn.tv:10000/task/list?status=completed&page=1&page_size=10" \
  -H "Authorization: YOUR_API_KEY"

成功响应示例

{
  "code": 200,
  "msg": "success",
  "data": {
    "list": [
      {
        "id": "537489015178247",
        "status": "completed",
        "priority": "normal",
        "progress": 100,
        "estimated_duration": 8.5,
        "estimated_queue_wait_duration": 1.2,
        "actual_duration": 7.6,
        "process_start_time": "2026-04-05T08:00:02Z",
        "finish_time": "2026-04-05T08:00:10Z",
        "create_time": "2026-04-05T08:00:01Z",
        "task_type_key": "image_purify",
        "task_type_name": "图片去水印"
      }
    ],
    "total": 1,
    "page": 1,
    "page_size": 10
  }
}

取消任务

基本信息

项目值
请求方法POST
请求路径/task/{task_id}/cancel
鉴权方式Authorization 请求头直接传 API Key

路径参数

参数名类型必填说明
task_idstring是任务唯一 ID

⚠️ 注意：仅 created 和 queued 状态允许取消。

请求示例

curl -X POST https://api.ai-mcn.tv:10000/task/537489015178247/cancel \
  -H "Authorization: YOUR_API_KEY"

成功响应示例

{
  "code": 200,
  "msg": "任务已取消",
  "data": ""
}

ℹ️ 说明：当前版本取消接口成功时只返回成功消息，data 为空字符串，不返回任务对象。

典型错误响应

{
  "code": 6007,
  "msg": "无法取消：当前任务不在排队状态。请注意，任务一旦开始处理或完成后将无法撤回",
  "data": null
}

下一步