88API88API
使用指南AI 应用API 文档帮助支持
接口模块使用指南

任务中心模块

功能说明

接口前缀统一为 https://88api.ai

查询当前账户的异步任务(如视频生成任务),可查看任务状态、进度、消耗和结果。

🔐 用户鉴权

获取我的任务

  • 接口名称:获取我的任务
  • HTTP 方法:GET
  • 路径:/api/task/self
  • 鉴权要求:用户
  • 功能简介:分页获取当前用户的任务列表,支持按平台、任务 ID、状态等条件过滤

💡 请求示例:

const response = await fetch('/api/task/self?p=1&page_size=20&task_id=cgt-20261014093000-x7k2m&status=SUCCESS&action=textGenerate&start_timestamp=1640908800&end_timestamp=1640995200', {
  method: 'GET',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer your_user_token',
    'New-Api-User': 'your_user_id'
  }
});
const data = await response.json();

✅ 成功响应示例:

{
  "success": true,
  "message": "",
  "data": {
    "items": [
      {
        "id": 1,
        "created_at": 1640908800,
        "updated_at": 1640909000,
        "task_id": "cgt-20261014093000-x7k2m",
        "platform": "54",
        "user_id": 1,
        "quota": 1000,
        "action": "textGenerate",
        "status": "SUCCESS",
        "fail_reason": "",
        "submit_time": 1640908800,
        "start_time": 1640908900,
        "finish_time": 1640909000,
        "progress": "100%",
        "properties": {},
        "data": {}
      }
    ],
    "total": 25,
    "page": 1,
    "page_size": 20
  }
}

❗ 失败响应示例:

{
  "success": false,
  "message": "获取任务列表失败"
}

🧾 字段说明:

  • p (数字): 页码,默认为 1
  • page_size (数字): 每页数量,默认为 20
  • platform (字符串): 任务平台编号,可选,一般无需填写
  • task_id (字符串): 任务 ID 过滤,可选
  • status (字符串): 任务状态过滤,可选值:"NOT_START"、"SUBMITTED"、"QUEUED"、"IN_PROGRESS"、"FAILURE"、"SUCCESS"、"UNKNOWN"
  • action (字符串): 任务类型过滤,如 "textGenerate"(文生视频)、"generate"(图生视频)等
  • start_timestamp (数字): 开始时间戳,可选
  • end_timestamp (数字): 结束时间戳,可选

🧾 返回字段说明:

  • id (数字): 记录 ID
  • task_id (字符串): 任务 ID
  • platform (字符串): 任务平台的内部编号,可忽略
  • user_id (数字): 用户 ID
  • quota (数字): 消耗的配额
  • action (字符串): 任务类型
  • status (字符串): 任务状态
  • fail_reason (字符串): 失败原因
  • submit_time (数字): 提交时间戳
  • start_time (数字): 开始时间戳
  • finish_time (数字): 完成时间戳
  • progress (字符串): 进度百分比
  • properties (对象): 任务属性
  • data (对象): 任务结果数据
  • total (数字): 符合条件的任务总记录数
  • page (数字): 当前返回的页码
  • page_size (数字): 每页展示的任务记录数