任务查询与计费

5. 其他接口

5.1 查询任务状态

GET /open-api/v1/video-process/status/{taskNo}

curl -X GET "https://admin.aimix.pro/open-api/v1/video-process/status/BT20260109001" \
  -H 'X-API-Key: afxp_your_api_key_here'

响应：

{
  "code": 0,
  "msg": "",
  "data": {
    "taskNo": "BT20260109001",
    "taskType": "videoDeduplication",
    "taskName": "批量视频去重任务",
    "status": 3,
    "statusName": "已完成",
    "totalItems": 2,
    "completedItems": 2,
    "failedItems": 0,
    "progressPercent": 100,
    "estimatedDotCount": 100,
    "actualDotCount": 95,
    "submitTime": "2026-04-22T10:00:00",
    "startTime": "2026-04-22T10:00:05",
    "endTime": "2026-04-22T10:05:30",
    "items": [
      {
        "itemIndex": 0,
        "status": 2,
        "statusName": "成功",
        "inputParams": {},
        "outputResult": {
          "videoUrl": "https://cdn.aimix.pro/result/video1_dedup.mp4"
        },
        "actualDotCount": 50,
        "errorMsg": null
      }
    ]
  }
}

5.2 分页查询任务列表

GET /open-api/v1/video-process/list?pageNo=1&pageSize=10&taskType=videoDeduplication&status=3

所有查询参数均为可选。

5.3 查询点数余额

GET /open-api/v1/video-process/balance

响应：

{
  "code": 0,
  "msg": "",
  "data": {
    "balance": 5000
  }
}

5.4 查询点数消耗记录

GET /open-api/v1/video-process/records?pageNo=1&pageSize=10

6. 任务状态说明

状态码	名称	说明
0	待提交	任务已创建，等待提交
1	已入队	任务已进入队列
2	执行中	任务正在处理
3	已完成	任务处理完成
4	失败	任务处理失败
5	已取消	任务已取消
6	拒绝	任务被拒绝

7. 计费说明

提交任务时自动从关联账号扣除预估点数（冻结）
任务完成后按实际处理量结算，多冻结的点数退还
任务失败或取消不扣费

8. 错误码

code	说明
0	成功
401	认证失败，API Key 无效或已禁用
1001001	任务不存在
1001002	应用不存在
500	服务器内部错误

本页目录