veo/veo-3.1-lite-generate-001 的 API 参考文档,由 Comfy Router 从 Veo 提供。
快速开始
在你的 Comfy 工作区中创建一个密钥,并将其导出为COMFY_API_KEY。Python 和 TypeScript 代码片段使用 Comfy SDK(pip install comfy-sdk、npm install @comfyorg/sdk);cURL 代码片段是通过原始 HTTP 发起的同一个调用。
模型 ID: veo/veo-3.1-lite-generate-001
端点: POST https://api.comfy.org/v2/models/veo/veo-3.1-lite-generate-001
- 等待结果
- 排队并稍后收集
Schema
输入
object[]
string
相机运动类型。需要提供图像。可能的值:
fixed、pan_left、pan_right、tilt_up、tilt_down、truck_left、truck_right、pedestal_up、pedestal_down、push_in、pull_outobject
可选的用于引导视频生成的初始帧图像
string (byte)
Base64 编码的图像数据格式:
bytestring
图像的 Cloud Storage URI
string
图像的 MIME 类型(image/jpeg 或 image/png)可能的值:
image/jpeg、image/pngobject
可选的尾帧图像。与 image 配合使用,可在首帧与尾帧之间生成视频。受 Veo 3.0+ 模型支持。
string (byte)
Base64 编码的图像数据格式:
bytestring
图像的 Cloud Storage URI
string
图像的 MIME 类型(image/jpeg 或 image/png)可能的值:
image/jpeg、image/pngobject
用于视频编辑的可选遮罩。应用于输入视频。
string (byte)
Base64 编码的遮罩字节格式:
bytestring
遮罩文件的 Cloud Storage URI
string
遮罩的应用方式可能的值:
insert、remove、remove_static、outpaintstring
遮罩的 MIME 类型(image/png、image/jpeg、image/webp 或视频格式)
string
必填
要生成视频的文本描述
object[]
用于引导视频生成的可选参考图像。最多支持 3 张资产图像或 1 张风格图像。受 Veo 3.1 模型(预览)支持。
object
必填
string (byte)
Base64 编码的图像数据格式:
bytestring
图像的 Cloud Storage URI
string
图像的 MIME 类型(image/jpeg 或 image/png)可能的值:
image/jpeg、image/pngstring
参考图像的可选标识符
string
必填
参考图像的类型可能的值:
asset、styleobject
用于视频扩展或编辑的可选输入视频。与 image 和 referenceImages 不兼容。
string (byte)
Base64 编码的视频字节格式:
bytestring
输入视频的 Cloud Storage URI
string
视频的 MIME 类型可能的值:
video/mov、video/mpeg、video/mp4、video/mpg、video/avi、video/wmv、video/mpegps、video/x-flvobject
string
已生成视频的宽高比。默认值:16:9可能的值:
16:9、9:16string
视频压缩质量。默认值:optimized可能的值:
optimized、losslessnumber
已生成视频的目标时长(秒)。Veo 2:5-8。Veo 3/3.1:4、6 或 8。默认值:8
boolean
自动优化提示词以获得更高质量。默认为 是。
integer
已生成视频的帧率(帧/秒)
boolean
是否在生成视频的同时生成音频。默认为 是。受 Veo 3.0+ 模型支持。
string
描述已生成视频中应避免出现内容的文本
string
控制已生成视频中的人物。默认值:allow_adult可能的值:
dont_allow、allow_adult、allowAllstring
用于接收进度更新的 Cloud Pub/Sub 主题(projects/{project}/topics/{topic})
string
输入图像的大小调整方式。默认值:pad可能的值:
pad、cropstring
输出视频分辨率。受 Veo 3.0+ 模型支持。默认值:720p可能的值:
720p、1080p、4kinteger
要生成的视频数量。如果未指定,则生成 1 个视频。范围:
1 到 4integer
用于确定性输出的随机种子。如果 sampleCount > 1,则为每个视频使用不同的种子。格式:
uint32string
用于保存已生成视频的 Cloud Storage URI(gs://)
string
视频生成请求的操作类型可能的值:
textToVideo、imageToVideo、referenceToVideo、edit、extend、upscaleGET /v2/models/veo/veo-3.1-lite-generate-001/openapi.json 提供的 schema 生成,该文档与请求到达提供商之前用于校验调用的文档相同。
输出
boolean
操作是否已完成
object
错误详情,仅在操作失败时存在
integer
gRPC 错误代码
string
报错信息
string
操作资源名称
object
预测响应,当 done 为 true 时存在
string
integer
被责任 AI 政策过滤掉的视频数量
string[]
视频被责任 AI 政策过滤的原因
object[]
string
Base64 编码的视频内容
string
已生成视频的 Cloud Storage URI
string
视频 MIME 类型(video/mp4)
示例
输入
输出
发布前须知
SDK 会生成Idempotency-Key 并在自动重试中复用它。手动重试时,请复用原始 key。Router 最长可保持连接 10 分钟。
请求失败时,Router 会发送 X-Comfy-Error-Type 响应头说明原因。422 表示 Router 在调用提供商之前就拒绝了输入。生成的资源请及时下载,因为结果链接会过期。
请求头
身份验证、幂等性、请求 ID、错误分类、重试节奏、消费限额。
使用 Router API
模型发现、校验错误、重试与计费。
限制
Router 目前不支持的功能,以及替代方案。