Skip to main content
通过 即刻API 统一网关调用 Veo 3 视频生成接口,支持文本生成视频、图生视频(帧转视频或参考图模式),时长4/6/ 8 秒,所有任务均为异步处理。
生成的视频链接有效期为 24 小时,请及时保存。

请求参数

string
default:"veo31-fast-720p"
required
视频生成模型名称。可用模型:
  • veo31-fast-720p — 快速生成模型,720p
  • veo31-fast-1080p — 快速生成模型,1080p
  • veo31-720p — 标准生成模型,720p
  • veo31-1080p — 标准生成模型,1080p
  • veo31-ref-720p — 参考图生视频模型,720p
  • veo31-ref-1080p — 参考图生视频模型,1080p
示例:"veo31-fast-720p"
string
required
视频生成的文本描述。
string
required
视频尺寸,必须传具体分辨率字符串。请注意:
  • size 为必填参数
  • 必须传实际分辨率,不能传 16:99:16720p1080p
  • size 必须和所选 model 对应,否则接口会报错
各模型支持的 size 如下:
  • veo31-720p1280x720720x1280
  • veo31-1080p1920x10801080x1920
  • veo31-ref-720p1280x720720x1280
  • veo31-ref-1080p1920x10801080x1920
  • veo31-fast-720p1280x720720x1280
  • veo31-fast-1080p1920x10801080x1920
你也可以按输出方向理解:
  • 横屏 720p:1280x720
  • 竖屏 720p:720x1280
  • 横屏 1080p:1920x1080
  • 竖屏 1080p:1080x1920
示例:"1280x720"
string
视频时长(秒)。支持:
  • 4
  • 6
  • 8
  • veo31-ref-720p、veo31-ref-1080p 仅支持 8 秒
示例:"4"说明:secondsduration 二选一即可,推荐优先使用 seconds
integer
视频时长(秒)。支持:
  • 4
  • 6
  • 8
  • veo31-ref-720p、veo31-ref-1080p 仅支持 8 秒
示例:4说明:durationseconds 二选一即可。
string
参考图输入。用于参考图生视频。支持两种方式:
  • 传图片 URL(JSON 请求中推荐)
  • 使用同名字段上传图片文件(multipart/form-data 请求中可用)
示例:"https://example.com/reference.jpg"

请求示例

/

返回示例

200

查询任务状态

提交后,使用以下接口轮询任务进度: