接口模块使用指南
任务中心模块
功能说明
接口前缀统一为 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(数字): 页码,默认为 1page_size(数字): 每页数量,默认为 20platform(字符串): 任务平台编号,可选,一般无需填写task_id(字符串): 任务 ID 过滤,可选status(字符串): 任务状态过滤,可选值:"NOT_START"、"SUBMITTED"、"QUEUED"、"IN_PROGRESS"、"FAILURE"、"SUCCESS"、"UNKNOWN"action(字符串): 任务类型过滤,如 "textGenerate"(文生视频)、"generate"(图生视频)等start_timestamp(数字): 开始时间戳,可选end_timestamp(数字): 结束时间戳,可选
🧾 返回字段说明:
id(数字): 记录 IDtask_id(字符串): 任务 IDplatform(字符串): 任务平台的内部编号,可忽略user_id(数字): 用户 IDquota(数字): 消耗的配额action(字符串): 任务类型status(字符串): 任务状态fail_reason(字符串): 失败原因submit_time(数字): 提交时间戳start_time(数字): 开始时间戳finish_time(数字): 完成时间戳progress(字符串): 进度百分比properties(对象): 任务属性data(对象): 任务结果数据total(数字): 符合条件的任务总记录数page(数字): 当前返回的页码page_size(数字): 每页展示的任务记录数