Veo-3.1 Fast 视频生成

面向快速出样、首尾帧驱动和高效率短视频生成
提交成功后返回视频任务 ID
当前按 default / standard 两个分组区分公开能力
两个分组都必须带参考图，不作为纯文生入口
default 组支持 1-2 张图，固定 5 秒，当前公开规格为 720p
standard 组按 frame_pair 维护，支持 4、6、8 秒和 720p / 1080p / 4k

请求鉴权

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

Authorization: Bearer YOUR_API_KEY

提交任务接口

POST /v1/videos

请求参数

字段	类型	必填	默认值	说明
`model`	`string`	是	-	固定传 `veo-3.1-fast`
`prompt`	`string`	是	-	视频生成提示词
`n`	`number`	否	`1`	当前仅支持传 `1`
`images`	`string[]`	是	-	参考图地址数组，支持 `1-2` 张
`duration`	`number`	否	`按分组能力处理`	`default` 固定 `5`；`standard` 支持 `4/6/8`
`aspect_ratio`	`string`	否	`按分组能力处理`	`default` 当前公开支持 `16:9 / 9:16`；`standard` 支持 `16:9 / 9:16`
`resolution`	`string`	否	`按分组能力处理`	`default` 当前固定公开为 `720p`；`standard` 支持 `720p / 1080p / 4k`
`reference_mode`	`string`	否	`按分组能力处理`	`default` 可不传，按图片数量自动解释；`standard` 当前固定按 `frame_pair` 维护

分组参数说明

以下只列不同分组之间存在差异的字段：

差异项	`standard` 组	`default` 组
生成形态	当前固定按 `frame_pair` 能力维护，必须带参考图	只支持参考图视频，不支持纯文生
`images`	支持 `1-2` 张参考图	支持 `1-2` 张参考图
`reference_mode`	当前只正式开放 `frame_pair`	默认按图片数量自动判定；第 `2` 张图为可选尾帧
`duration`	支持 `4 / 6 / 8`	固定 `5`
`aspect_ratio`	支持 `16:9 / 9:16`	支持 `16:9 / 9:16`
`resolution`	支持 `720p / 1080p / 4k`	当前固定公开为 `720p`

响应

提交成功响应示例：

{
  "id": "video_task_01KQEXAMPLE_VEO31_FAST",
  "object": "video",
  "model": "veo-3.1-fast",
  "status": "queued",
  "progress": 0,
  "created_at": 1711111111
}

提交失败响应示例：

{
  "error": {
    "code": 400,
    "type": "invalid_request_error",
    "message": "参数错误，请检查 prompt、images、duration、aspect_ratio、resolution 或 reference_mode 是否符合当前模型要求"
  }
}

任务查询接口

GET /v1/videos/{task_id}

查询成功示例：

{
  "id": "video_task_01KQEXAMPLE_VEO31_FAST",
  "object": "video",
  "model": "veo-3.1-fast",
  "status": "completed",
  "progress": 100,
  "metadata": {
    "duration": 6,
    "width": 1920,
    "height": 1080
  },
  "url": "https://example.com/result/veo31-fast-video.mp4"
}

使用示例

`default` 分组：单参考图快速出样

curl --request POST \
  --url https://your-domain/v1/videos \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "veo-3.1-fast",
    "prompt": "让参考图中的产品快速推进到镜头中央，保持高光质感和背景节奏",
    "n": 1,
    "images": [
      "https://example.com/first-frame.jpg"
    ],
    "duration": 5,
    "aspect_ratio": "16:9",
    "resolution": "720p"
  }'

说明：

default 组当前固定 5 秒。
传 1 张图时，平台按单图参考语义处理。
default 组当前不建议显式切换 reference_mode。

`standard` 分组：首尾帧高规格生成

curl --request POST \
  --url https://your-domain/v1/videos \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "veo-3.1-fast",
    "prompt": "让首帧中的产品沿着镜头轨迹快速推进，尾帧落在更明亮的舞台环境中",
    "n": 1,
    "images": [
      "https://example.com/first-frame.jpg",
      "https://example.com/last-frame.jpg"
    ],
    "duration": 6,
    "aspect_ratio": "9:16",
    "resolution": "1080p",
    "reference_mode": "frame_pair"
  }'

说明：

standard 组当前正式开放 4 / 6 / 8 秒。
standard 组建议显式传 aspect_ratio 与 resolution。
standard 组当前对外按 frame_pair 协议维护，至少要传首帧图。

注意事项

veo-3.1-fast 两个分组都不作为纯文生入口，必须提供至少 1 张参考图。
第 2 张参考图为可选尾帧，不传时平台只按首帧约束镜头延展。
default 组当前固定 5s + 720p；如需要更高规格，请使用 standard 组。
standard 组当前只正式开放 reference_mode=frame_pair。
顶层 size 与 aspect_ratio 兼容，二选一即可。
提交成功后请使用 GET /v1/videos/{task_id} 继续轮询结果。

开始使用

文本系列

图像系列

视频系列

音频系列

Veo-3.1 Fast

Veo-3.1 Fast 视频生成

请求鉴权

提交任务接口

请求参数

分组参数说明

响应

任务查询接口

使用示例

`default` 分组：单参考图快速出样

`standard` 分组：首尾帧高规格生成

注意事项

​Veo-3.1 Fast 视频生成

​请求鉴权

​提交任务接口

​请求参数

​分组参数说明

​响应

​任务查询接口

​使用示例

​default 分组：单参考图快速出样

​standard 分组：首尾帧高规格生成

​注意事项

Veo-3.1 Fast 视频生成

请求鉴权

提交任务接口

请求参数

分组参数说明

响应

任务查询接口

使用示例

`default` 分组：单参考图快速出样

`standard` 分组：首尾帧高规格生成

注意事项