按令牌获取视频任务列表

接口概览

项	值
方法	`GET`
路径	`/v1/video/tasks`
认证	`Authorization: Bearer sk-xxx`（令牌鉴权）
Content-Type	无请求体

按当前令牌拉取属于该令牌名下的视频任务列表（自动排除 Suno 音频任务与 Midjourney 图片任务）。

请求参数

全部通过 URL Query String 传递。

参数	类型	必填	说明	示例
`status`	string	否	任务状态过滤	`SUCCESS`
`start_timestamp`	int	否	提交时间下界（Unix 秒）	`1725120000`
`end_timestamp`	int	否	提交时间上界（Unix 秒）	`1725206400`
`p`	int	否	页码，从 `1` 开始	`2`
`page_size`	int	否	每页条数，默认 `10`，最大 `100`	`50`

关于分页

请求参数：

p：页码，从 1 开始（默认 1）

page_size：每页返回多少条（默认 10，最大 100，超过自动截为 100）

响应字段：

page：当前页码

page_size：每页条数

total：符合过滤条件的总记录数（用于计算总页数）

items：当前页的数据数组

分页计算：

第 1 页（p=1）：返回第 1 ~ page_size 条

第 2 页（p=2）：返回第 page_size + 1 ~ 2 * page_size 条

总页数 = ceil(total / page_size)

示例：

关于时间范围

start_timestamp 与 end_timestamp 都未传时，默认查询服务器本地时区当天 00:00:00 ~ 23:59:59

只传其中一个也可，未传的一侧不做限制

关于 status 可选值

值	说明
`NOT_START`	已占位，尚未提交上游
`SUBMITTED`	已提交上游
`QUEUED`	上游排队中
`IN_PROGRESS`	上游生成中
`SUCCESS`	生成成功
`FAILURE`	失败（含超时终止、余额不足终止）
`UNKNOWN`	未知状态

返回格式

{
  "success": true,
  "message": "",
  "data": {
    "page": 1,
    "page_size": 10,
    "total": 4433,
    "items": [
      {
        "user_id": 1,
        "task_id": "vid_b514b218_81515",
        "submit_time": 1783500697,
        "start_time": 0,
        "finish_time": 1783500732,
        "token_id": 8774,
        "status": "SUCCESS",
        "progress": "100%",
        "fail_reason": "https://moyu.info/v1/videos/vid_b514b218_81515/content",
        "prompt_tokens": 0,
        "completion_tokens": 0
      }
    ]
  }
}

字段说明

字段	类型	说明
`user_id`	int	任务所属用户 ID
`task_id`	string	任务 ID（成功任务为上游返回值，占位失败任务可能为空串）
`submit_time`	int	提交时间（Unix 秒）
`start_time`	int	上游开始时间（Unix 秒，`0` 表示未开始或未上报）
`finish_time`	int	完成时间（Unix 秒，未完成为 `0`）
`token_id`	int	令牌 ID
`status`	string	见上表
`progress`	string	进度百分比，如 `"100%"`、`"30%"`
`fail_reason`	string	失败原因。成功任务里此字段会存视频代理 URL（历史约定，见下文）
`prompt_tokens`	int	输入 tokens
`completion_tokens`	int	输出 tokens

⚠️ fail_reason 字段的双重语义
由于 Task 表历史结构约定，成功任务（status = SUCCESS）的 fail_reason
实际存放的是视频代理 URL（https://<host>/v1/videos/<task_id>/content）。
建议消费方按 status 分支处理：
status = SUCCESS：fail_reason 是视频 URL
status = FAILURE：fail_reason 是失败原因描述
其他状态：fail_reason 通常为空

错误返回

认证失败或参数错误时：

{ "success": false, "message": "无效的令牌" }

常见错误：

HTTP	message	说明
401	无效的令牌	Authorization 头缺失或格式错误

接口概览

请求参数

关于分页

关于时间范围

关于 status 可选值

返回格式

字段说明

错误返回

请求示例

1) curl — 拉取今天全部视频任务（默认）

2) curl — 只看今天成功的任务，分页每页 50 条

3) curl — 指定时间范围（跨天）

4) curl — 翻页

Python（requests）

Node.js（fetch）

Go

按令牌获取视频任务列表

接口概览#

请求参数#

关于分页#

关于时间范围#

关于 status 可选值#

返回格式#

字段说明#

错误返回#

请求示例#

1) curl — 拉取今天全部视频任务（默认）#

2) curl — 只看今天成功的任务，分页每页 50 条#

3) curl — 指定时间范围（跨天）#

4) curl — 翻页#

Python（requests）#

Node.js（fetch）#

Go#

接口概览

请求参数

关于分页

关于时间范围

关于 status 可选值

返回格式

字段说明

错误返回

请求示例

1) curl — 拉取今天全部视频任务（默认）

2) curl — 只看今天成功的任务，分页每页 50 条

3) curl — 指定时间范围（跨天）

4) curl — 翻页

Python（requests）

Node.js（fetch）

Go