模型名称:veo-3.1
  • 面向品牌感镜头、电影化叙事和高完成度宣传视频
  • 提交成功后返回视频任务 ID
  • default / standard 两个分组均可用,参数完全一致
  • 支持纯文生、full_reference 多参考图和 frame_pair 首尾帧
  • duration 支持 4、6、8 秒
  • aspect_ratio 支持 16:9、9:16
  • resolution 支持 720p、1080p、4k

请求鉴权

所有接口均需要使用 Bearer Token 进行认证。

提交任务接口

请求参数

不支持 video_urls、audio_urls、草稿、任务链和回调字段。

当前分组说明

当前 veo-3.1 同时支持 default / standard,两个分组共用同一套正式公开能力:

响应

提交成功响应示例:
提交失败响应示例:

任务查询接口

查询成功示例:

使用示例

文生视频

说明:
  1. 当前文生视频直接走 default 分组。
  2. 文生时可以不传 images。
  3. 建议显式传 aspect_ratio 与 resolution,避免按默认值执行。

多参考图视频

说明:
  1. full_reference 当前支持 0-3 张参考图。
  2. 单参考图、多参考图都走同一条 default 链路。
  3. 如已有 OpenAI Images 风格调用,可继续传顶层 size,服务端会兼容转成 aspect_ratio。

首尾帧参考视频

注意事项

  1. reference_mode=full_reference 时,images 可不传,也可传 1-3 张参考图。
  2. reference_mode=frame_pair 时,首帧必传,尾帧可选,总数为 1-2 张。
  3. 4k 生成耗时通常会明显高于 720p 与 1080p。
  4. 顶层 size 与 aspect_ratio 兼容,二选一即可。
  5. 提交成功后请使用 GET /v1/videos/{task_id} 继续轮询结果。

异步状态与失败响应

视频任务状态只使用 queued、in_progress、completed、failed。处于 queued 或 in_progress 时继续调用查询接口;只有 completed 状态才读取顶层 result_url。 任务失败时保持视频对象结构,并返回顶层 error 与 fail_reason,不要按图片接口读取 code/data/works: