mingyan
VEO - 创建任务
使用 VEO 模型创建视频生成任务，支持参考图片和首尾帧引导
VEO 创建视频任务
使用 VEO 的先进 AI 模型创建高质量视频生成任务，支持两种图片引导模式。
认证
获取 Key所有请求都需要在请求头中包含 Bearer token：
cURL
Authorization: Bearer {{key}}
基础 URL
https://zcbservice.aizfw.cn/kyyReactApiServerbaseUrl 为所有对外 API 的公共前缀。当前页面 frontmatter 中的 api 字段展示的是完整请求地址，请在接入时以这里的 baseUrl 为统一前缀理解和拼接接口路径。请求参数
modelstring必填模型名称
可选值：
veo_3_1_fast_stable- 720p/1080p，仅支持首尾帧veo_3_1_pro_stable- 720p/1080pveo_3_1_fast- 快速版，支持720p/1080p/4Kveo_3_1_pro- 高质量版，支持720p/1080p/4K
promptstring必填视频生成提示词，描述所需的视频内容
示例：
"A cat dancing in the rain, cinematic style"resolutionstring输出分辨率
支持的值：
720p- 默认，所有 Veo 模型1080p- 支持 veo_3_1_fast_stable、veo_3_1_pro_stable、veo_3_1_fast、veo_3_1_pro4K- 支持 veo_3_1_fast、veo_3_1_pro
大小写兼容：支持 720p/720P/4K/4k 等任意格式
veo_3_1_fast_stable / veo_3_1_pro_stable 不支持 4K
aspect_ratiostring输出视频比例（纯宽高比），默认为
16:9支持的值：
16:9- 横屏9:16- 竖屏
分辨率通过 resolution 字段单独指定，aspect_ratio 不支持 -1080p/-4K 后缀
参考图片模式
input_referencearray参考图片URL
不可搭配首尾帧使用。
支持模型：
veo_3_1_pro_stable（最多3张）veo_3_1_fast（最多3张）veo_3_1_pro
veo_3_1_fast_stable 仅支持首尾帧模式，不支持参考图模式
与
image_urls 二选一image_urlsarray参考图片URL
不可搭配首尾帧使用。
支持模型：
veo_3_1_pro_stable（最多3张）veo_3_1_fast（最多3张）veo_3_1_pro
veo_3_1_fast_stable 仅支持首尾帧模式，不支持参考图模式
与
input_reference 二选一首尾帧模式
first_imagestring首帧图片URL
支持模型：
veo_3_1_fast_stableveo_3_1_pro_stableveo_3_1_fastveo_3_1_pro
使用方式：
- 单独使用：图生视频模式
- 搭配
last_image使用：首尾帧模式
与参考图片模式互斥
last_imagestring尾帧图片URL，需搭配
first_image 使用支持模型：
veo_3_1_fast_stableveo_3_1_pro_stableveo_3_1_fastveo_3_1_pro
必须与
first_image 一起使用，与参考图片模式互斥响应参数
idstring视频生成任务的唯一标识符，用于后续查询任务状态
objectstring对象类型，固定为
video.generationcreatedinteger任务创建时间戳
modelstring使用的模型名称
statusstring任务状态：
queued- 排队中processing- 处理中
errorstring错误信息，当 status 为
failed 时返回图片引导模式
VEO 支持两种互斥的图片引导模式：
参考图片模式
使用
input_reference 或 image_urls 提供最多 3 张参考图片，指导整体风格和内容首尾帧模式
使用
first_image 和可选的 last_image 指定视频的精确开始和结束帧重要： 两种模式不能同时使用，只能选择其中一种
参数选择规则
参数互斥规则：
- 参考图片：
input_reference和image_urls二选一 - 引导模式：参考图片模式 OR 首尾帧模式，不能同时使用
- 模型限制：veo_3_1_fast_stable 仅支持首尾帧模式，veo_3_1_fast_stable / veo_3_1_pro_stable 不支持 4K
VEO 特性
多分辨率支持
支持 720p、1080p、4K 多种分辨率输出
双引导模式
支持参考图片和首尾帧两种引导方式
多模型选择
提供 fast_stable、pro_stable、fast、pro 四种模型
灵活控制
首尾帧模式提供精确的开始和结束控制
最佳实践：
- 视频生成为异步处理，需要通过返回的
id查询任务状态和结果 - 在提示词中明确描述所需的视觉效果和风格
- 选择合适的模型：
- veo_3_1_fast_stable：720p/1080p，仅支持首尾帧
- veo_3_1_pro_stable：720p/1080p
- veo_3_1_fast：快速版，支持720p/1080p/4K
- veo_3_1_pro：高质量版，支持720p/1080p/4K
- 选择合适的引导模式：
- 参考图片模式：适合风格引导（veo_3_1_pro_stable、veo_3_1_fast、veo_3_1_pro）
- 首尾帧模式：适合精确控制开始和结束（所有模型）
- 根据模型选择合适的分辨率
引导模式选择建议：
- 参考图片模式：当你想要整体风格一致但允许创意变化时使用（veo_3_1_pro_stable、veo_3_1_fast、veo_3_1_pro 支持）
- 首尾帧模式：当你需要精确控制视频的开始和结束画面时使用（所有模型支持）
- 分辨率选择：根据模型能力和需求选择，veo_3_1_fast_stable / veo_3_1_pro_stable 不支持 4K