视频任务查询（共用）

视频任务查询

所有异步视频任务（Grok / Veo / Sora 等）共用本接口查询进度与结果。Nano Banana 异步生图任务也走本接口（object 字段为 image）。

接入地址

线路	Base URL
国内加速（推荐）	`https://cdn.wusag.com`
海外直连	`https://api.xinliu.one`

请求

方法：GET {Base URL}/v1/videos/{task_id}

Header：Authorization: Bearer 你的令牌

路径参数

字段	类型	必填	说明
`task_id`	string	是	任务 ID，由 `POST /v1/videos` 返回

状态字段

queued 排队中

in_progress 进行中

processing 处理中

completed 已完成

failed 失败

返回字段

字段	说明
`id` / `task_id`	任务 ID
`object`	`video` / `image`
`model`	真实 model 名（`grok-video-6s` / `-10s` / `-12s` 等），与提交响应里的统一别名 `grok-imagine-video` 不同
`status`	见上方枚举
`progress`	0~100
`quality`	当前固定 `standard`
`seconds` / `size`	字符串，跟提交字段对应
`prompt`	提交时的提示词
`created_at` / `completed_at`	时间戳
`url` / `video_url` / `output.url`	视频结果 URL。`grok-video-3` / `grok-video-3-max` 返回 `video_url`；Veo / Sora 返回 `url`（具体见各 model 节点）。`grok-video-6s` / `-10s` / `-12s` 不返回任何 URL 字段，需通过 `/content` 端点拉视频
`error.message`（或 `error_message`）	失败原因

完成态示例（Grok Video 6s/10s/12s 系列）

{
  "id": "task_uh3B5YC4DurIkKMtzq4fkc5hr99Vp9po",
  "size": "1280x720",
  "model": "grok-video-6s",
  "object": "video",
  "prompt": "雪山日出航拍 缓慢推进 电影感",
  "status": "completed",
  "quality": "standard",
  "seconds": "6",
  "progress": 100,
  "created_at": 1778141892,
  "completed_at": 1778141950
}

（注意此返回没有 url 字段，必须走 GET /v1/videos/{task_id}/content 拉视频本体）

完成态示例（Grok Video 3 / Veo 等老系列）

{
  "id": "task_xxx",
  "object": "video",
  "model": "grok-video-3",
  "status": "completed",
  "progress": 100,
  "created_at": 1730000000,
  "completed_at": 1730000060,
  "url": "https://xxx.cos.com/result.mp4"
}

失败态示例

{
  "id": "task_xxx",
  "status": "failed",
  "error": { "message": "具体失败原因", "code": "task_failed" }
}

轮询建议

提交后 5 秒首次查询；后续每 5~10 秒一次

completed 或 failed 时停止

Grok Video 6s/10s/12s 系列约 30~120 秒进入 completed

请求示例

任务级失败 - 内容安全审核拒绝

Google Veo 对每个任务都会做内容审核。提交时 200 拿到 task_id，但审核不通过的任务会进 status: failed，错误体如下：

{
  "id": "task_xxx",
  "status": "failed",
  "status_update_time": 1778211452,
  "error": {
    "message": "提交中含有违反平台政策的内容，请你立即停止或调整你的提交内容"
  }
}

常见触发场景：

涉及暴力 / 色情 / 仇恨 / 未成年人不当内容

真实人物（明星 / 政治人物 / 普通人肖像）的图生视频

政治敏感、特定地区敏感主题

版权 IP 角色（迪士尼 / 漫威 / 卡通 IP 等）

参考图本身被识别为违规（即便 prompt 没问题）

处理方式：调整 prompt 措辞 / 更换参考图 / 避开敏感主题后重新提交。本类失败按任务失败计，不消耗额度。

错误码

401 令牌无效

404 任务不存在或已过期

500 服务端错误