获取视频任务状态

GET /v1/videos/{task_id}

说明

OpenAI 兼容的视频任务状态查询接口(Veo 任务用)。

轮询此接口直到 status 变为 completed,建议 10s 间隔。

完成后获取视频的两种路径

  1. 响应里直接返回 url / video_url(逆向上游典型响应) 客户端拿到该 mp4 直链即可直接渲染 / 下载,无需再调 /content 接口。优先级 url > video_url,二者内容一致。

  2. 响应中无 url 字段GET /v1/videos/{task_id}/content 由网关代理拉取 mp4 流(官方 Gemini 渠道走这条路径)。

请求头

名称位置类型必填说明
task_idpathstring视频任务 ID(创建视频接口返回的 id 字段)
Authorizationheaderstring

响应

字段类型必填说明
idstring视频任务 ID(task_xxx 格式)
task_idstring视频任务 ID,与 id 等价(兼容字段)
objectstring对象类型,固定为 video
modelstring使用的模型(veo3 / veo3.1 / veo3.1-pro / veo3.1-components 等)
statusstring任务状态
progressinteger进度百分比(0-100)
created_atinteger创建时间戳(秒)
completed_atinteger完成时间戳(秒),未完成时为 null
secondsstring视频时长(秒,字符串)
sizestring视频分辨率,例如 720x1280
urlstringmp4 直链(逆向上游 status=completed 时返回,可直接渲染下载,跳过 /content)
video_urlstringmp4 直链(与 url 等价,部分上游字段名差异)
promptstring请求时使用的提示词
errorobject失败任务的错误信息