获取视频任务状态
GET /v1/videos/{task_id}
说明
OpenAI 兼容的视频任务状态查询接口(Veo 任务用)。
轮询此接口直到 status 变为 completed,建议 10s 间隔。
完成后获取视频的两种路径
响应里直接返回
url/video_url(逆向上游典型响应) 客户端拿到该 mp4 直链即可直接渲染 / 下载,无需再调/content接口。优先级url>video_url,二者内容一致。响应中无 url 字段 调
GET /v1/videos/{task_id}/content由网关代理拉取 mp4 流(官方 Gemini 渠道走这条路径)。
请求头
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| task_id | path | string | 是 | 视频任务 ID(创建视频接口返回的 id 字段) |
| Authorization | header | string | 否 |
响应
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| id | string | 是 | 视频任务 ID(task_xxx 格式) |
| task_id | string | 否 | 视频任务 ID,与 id 等价(兼容字段) |
| object | string | 是 | 对象类型,固定为 video |
| model | string | 是 | 使用的模型(veo3 / veo3.1 / veo3.1-pro / veo3.1-components 等) |
| status | string | 是 | 任务状态 |
| progress | integer | 是 | 进度百分比(0-100) |
| created_at | integer | 是 | 创建时间戳(秒) |
| completed_at | integer | 否 | 完成时间戳(秒),未完成时为 null |
| seconds | string | 否 | 视频时长(秒,字符串) |
| size | string | 否 | 视频分辨率,例如 720x1280 |
| url | string | 否 | mp4 直链(逆向上游 status=completed 时返回,可直接渲染下载,跳过 /content) |
| video_url | string | 否 | mp4 直链(与 url 等价,部分上游字段名差异) |
| prompt | string | 否 | 请求时使用的提示词 |
| error | object | 否 | 失败任务的错误信息 |