视频内容下载（共用）

视频内容下载

拉取已完成视频任务的视频文件本体，返回 H.264 MP4 二进制流。所有视频任务（Grok / Veo / Sora / 即梦等）共用本接口。

Grok Video 6s/10s/12s 系列任务的 completed 响应不携带 url 字段，只能通过本接口拿视频。

接入地址

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

请求

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

Header：Authorization: Bearer 你的令牌

路径参数

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

调用流程

POST /v1/videos 提交任务，拿到 task_id

GET /v1/videos/{task_id} 轮询，等到 status=completed

GET /v1/videos/{task_id}/content 拉视频本体保存到本地

请求示例

成功响应

HTTP 200

响应体：H.264 MP4 二进制流（ftyp isom + isomiso2avc1mp41）

6 秒 720x1280 视频约 8~9 MB

返回示例（二进制头 16 字节）

00000000  00 00 00 20 66 74 79 70 69 73 6f 6d 00 00 02 00  |... ftypisom....|
00000010  69 73 6f 6d 69 73 6f 32 61 76 63 31 6d 70 34 31  |isomiso2avc1mp41|

响应头：

Content-Type: video/mp4
Content-Disposition: attachment; filename="video_<32位hex>.mp4"
Cache-Control: public, no-cache, max-age=86400
Content-Length: <字节数>
x-api-request-id: <心流追踪 ID，报错排查用>

走国内 CDN 加速，Cache-Control: max-age=86400 表示 24 小时内同一 URL 命中 CDN 缓存。

错误码

HTTP	触发场景
401	令牌无效或缺失
404	task_id 不存在 / 任务未完成
410	文件已过期被清理（任务结果一般保留 24 小时以上，超时不保证）
500	服务端错误