Skip to main content
veo/veo-3.1-lite-generate-001 的 API 参考文档,由 Comfy Router 从 Veo 提供。

快速开始

你的 Comfy 工作区中创建一个密钥,并将其导出为 COMFY_API_KEY。Python 和 TypeScript 代码片段使用 Comfy SDK(pip install comfy-sdknpm 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
相机运动类型。需要提供图像。可能的值:fixedpan_leftpan_righttilt_uptilt_downtruck_lefttruck_rightpedestal_uppedestal_downpush_inpull_out
object
可选的用于引导视频生成的初始帧图像
string (byte)
Base64 编码的图像数据格式:byte
string
图像的 Cloud Storage URI
string
图像的 MIME 类型(image/jpeg 或 image/png)可能的值:image/jpegimage/png
object
可选的尾帧图像。与 image 配合使用,可在首帧与尾帧之间生成视频。受 Veo 3.0+ 模型支持。
string (byte)
Base64 编码的图像数据格式:byte
string
图像的 Cloud Storage URI
string
图像的 MIME 类型(image/jpeg 或 image/png)可能的值:image/jpegimage/png
object
用于视频编辑的可选遮罩。应用于输入视频。
string (byte)
Base64 编码的遮罩字节格式:byte
string
遮罩文件的 Cloud Storage URI
string
遮罩的应用方式可能的值:insertremoveremove_staticoutpaint
string
遮罩的 MIME 类型(image/png、image/jpeg、image/webp 或视频格式)
string
必填
要生成视频的文本描述
object[]
用于引导视频生成的可选参考图像。最多支持 3 张资产图像或 1 张风格图像。受 Veo 3.1 模型(预览)支持。
object
必填
string (byte)
Base64 编码的图像数据格式:byte
string
图像的 Cloud Storage URI
string
图像的 MIME 类型(image/jpeg 或 image/png)可能的值:image/jpegimage/png
string
参考图像的可选标识符
string
必填
参考图像的类型可能的值:assetstyle
object
用于视频扩展或编辑的可选输入视频。与 image 和 referenceImages 不兼容。
string (byte)
Base64 编码的视频字节格式:byte
string
输入视频的 Cloud Storage URI
string
视频的 MIME 类型可能的值:video/movvideo/mpegvideo/mp4video/mpgvideo/avivideo/wmvvideo/mpegpsvideo/x-flv
object
string
已生成视频的宽高比。默认值:16:9可能的值:16:99:16
string
视频压缩质量。默认值:optimized可能的值:optimizedlossless
number
已生成视频的目标时长(秒)。Veo 2:5-8。Veo 3/3.1:4、6 或 8。默认值:8
boolean
自动优化提示词以获得更高质量。默认为 是。
integer
已生成视频的帧率(帧/秒)
boolean
是否在生成视频的同时生成音频。默认为 是。受 Veo 3.0+ 模型支持。
string
描述已生成视频中应避免出现内容的文本
string
控制已生成视频中的人物。默认值:allow_adult可能的值:dont_allowallow_adultallowAll
string
用于接收进度更新的 Cloud Pub/Sub 主题(projects/{project}/topics/{topic})
string
输入图像的大小调整方式。默认值:pad可能的值:padcrop
string
输出视频分辨率。受 Veo 3.0+ 模型支持。默认值:720p可能的值:720p1080p4k
integer
要生成的视频数量。如果未指定,则生成 1 个视频。范围:14
integer
用于确定性输出的随机种子。如果 sampleCount > 1,则为每个视频使用不同的种子。格式:uint32
string
用于保存已生成视频的 Cloud Storage URI(gs://)
string
视频生成请求的操作类型可能的值:textToVideoimageToVideoreferenceToVideoeditextendupscale
根据 Router 在 GET /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 目前不支持的功能,以及替代方案。