查询 Veo 视频
GET
/v1/videos/{task_id}使用创建接口返回的公开任务 ID 轮询 Veo 或 Gemini Omni 视频任务。任务完成后，响应中会包含可直接访问的签名视频地址。
轮询与状态说明
必须使用创建接口返回的公开任务 ID。建议每 5～10 秒查询一次；响应中暂时没有 url 只代表任务尚未完成。
| 状态 | 含义 | 下一步 |
|---|---|---|
| queued | 任务已接收，正在等待生成资源 | 继续轮询 |
| in_progress | 上游正在生成视频 | 继续轮询 |
| completed | 生成成功，progress 为 100 | 使用 url 获取 MP4 |
| failed | 生成失败，error 通常包含原因 | 修正请求后创建新任务 |
响应字段
| 字段 | 出现时机 | 说明 |
|---|---|---|
| id | 始终返回 | 后续轮询使用的公开任务 ID |
| status | 始终返回 | queued、in_progress、completed 或 failed |
| progress | 始终返回 | 0～100 的生成进度 |
| url | 仅 completed | 生成视频的签名反代地址 |
| error | 通常仅 failed | 上游或参数校验失败原因 |
| model / size / seconds | 有值时 | 实际使用的输出配置 |
| created_at / completed_at | 有值时 | 秒级 Unix 时间戳 |
路径参数
task_id:必填stringPOST /v1/videos 响应 id 中的公开任务 ID。请原样保留 task_ 前缀，不要使用或暴露上游内部任务 ID。
示例
task_FIeVpQgoAo5Dm4bx50ZjOxxjGhZYZjT8Header 参数
Authorization:必填string使用 Bearer 方案携带 API Key 的认证请求头。
示例
Bearer <YOUR_API_KEY>响应
200成功时返回 JSON 响应。完整示例显示在右侧代码面板中。