Veo 生视频参数
Veo 3.1 走统一生视频契约：POST /video/generations + GET /video/tasks/{taskId}。本页说明现网三码差异与可复制示例。
通用字段表见 视频生成 · 高级参数。端点说明见 创建视频生成任务。模型列表见 获取模型（modality=video）或 模型广场。
模型 ID
model | 典型能力 | 分辨率 | 时长（秒） |
|---|---|---|---|
veo-3.1 | 文生；首帧 / 首尾帧；参考图生视频 | 720p / 1080p / 4k | 仅 4 / 6 / 8 |
veo-3.1-fast | 同上（加速档） | 建议 720p / 1080p | 仅 4 / 6 / 8 |
veo-3.1-lite | 文生；可选首帧 / 首尾帧 | 720p / 1080p（无 4k） | 仅 4 / 6 / 8 |
公共约束
| 项 | 说明 |
|---|---|
duration_sec | 必须为 4、6 或 8（默认按 8 理解；勿传 5 等其它整数） |
aspect_ratio | 仅 16:9 或 9:16 |
generate_audio | 可选；显式传 true / false |
frame_images | 支持 first_frame；last_frame 须同时有首帧 |
input_references | veo-3.1 / veo-3.1-fast 可用于参考图；veo-3.1-lite 不支持 |
| 参考图模式 | 时长通常固定为 8 秒；参考图与 frame_images 勿混用 |
| 首帧图 | 公网 HTTPS；单张体积上限约 20MB |
文生视频
json
{
"model": "veo-3.1",
"prompt": "A red bicycle rolling through a rainy neon street at night, cinematic",
"duration_sec": 8,
"resolution": "720p",
"aspect_ratio": "16:9",
"generate_audio": true
}首帧 / 首尾帧
json
{
"model": "veo-3.1",
"prompt": "Camera slowly pushes in toward the subject",
"duration_sec": 6,
"resolution": "1080p",
"aspect_ratio": "16:9",
"frame_images": [
{
"type": "image_url",
"frame_type": "first_frame",
"image_url": { "url": "https://example.com/first.png" }
},
{
"type": "image_url",
"frame_type": "last_frame",
"image_url": { "url": "https://example.com/last.png" }
}
]
}仅首帧时只传 first_frame 一项即可。
参考图生视频（非 Lite）
json
{
"model": "veo-3.1",
"prompt": "Keep the product appearance; soft studio orbit shot",
"duration_sec": 8,
"resolution": "720p",
"aspect_ratio": "16:9",
"input_references": [
{
"type": "image_url",
"image_url": { "url": "https://example.com/product.png" },
"reference_type": "asset"
}
]
}veo-3.1-lite 请使用文生或首尾帧，不要传 input_references。