Skip to main content
POST
模型名兼容提示:本接口同时兼容别名 veo3.1-fast-ext(等价于 veo3.1-fast)、veo3.1-quality-ext(等价于 veo3.1-quality)、veo3.1-lite-ext(等价于 veo3.1-lite),别名与主名可互换使用、效果一致。

认证

string
必填
所有接口均需要使用Bearer Token进行认证获取 API Key:访问 API Key 管理页面 获取您的 API Key使用时在请求头中添加:

请求参数

string
默认值:"veo3.1-fast"
必填
视频生成模型名称可用模型:
  • veo3.1-fast - 快速生成模型,适用于快速预览和迭代(兼容别名 veo3.1-fast-ext
  • veo3.1-quality - 高质量生成模型,适用于最终制作(兼容别名 veo3.1-quality-ext
  • veo3.1-lite - 轻量级生成模型,适用于低成本批量生成(兼容别名 veo3.1-lite-ext
Example: "veo3.1-fast"
为兼容旧版调用,别名 veo3.1-fast-ext(对应 veo3.1-fast)、veo3.1-quality-ext(对应 veo3.1-quality)、veo3.1-lite-ext(对应 veo3.1-lite)仍可正常使用。
string
必填
视频生成的文本描述
integer
视频时长(秒)固定值:8(VEO3 仅支持 8 秒时长)
string
视频宽高比支持的格式:
  • 16:9 (横屏)
  • 9:16 (竖屏)
string
视频生成类型支持的类型:
  • frame - 帧转视频(FL模式)
  • reference - 参考图生视频
如果不传此参数,默认根据图片数量自动判断:2张为帧转视频,3张为参考图生视频注意:veo3.1-quality 模型不支持 reference 参考图模式
veo3.1-lite 模型不支持此参数,请勿传入
array<url>
用于图生视频的参考图像 URL 数组支持公网可访问的图片 URL(http:// 或 https://)示例:["https://example.com/image.jpg"]限制:
  • 最多 3 张图片
  • 帧转视频模式:第一张为首帧,第二张为尾帧
  • 最大文件大小:10MB
  • 支持格式:.jpeg、.jpg、.png、.webp
veo3.1-lite 模型不支持此参数,请勿传入
string
视频分辨率支持的值:
  • 720p(默认)
  • 1080p
  • 4k
boolean
启用 GIF 输出格式。默认:false注意:GIF 和 1080p、4k 分辨率不能同时使用
boolean
默认值:"false"
是否使用官方渠道兜底
  • false:不使用(默认)
  • true:使用官方渠道
veo3.1-lite 模型不支持此参数,请勿传入

Response

integer
响应状态码
array
返回数据数组