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
- 等待结果
- 排队并稍后收集
同一请求体,发送到
POST https://api.comfy.org/v2/models/veo/veo-3.1-lite-generate-001/requests。运行一经接纳,Router 就会返回 201 以及一个 request_id,结果准备就绪后即可收集,可以由当前进程收集,也可以由另一个进程收集。队列投递介绍了状态查询、取消和收集的完整流程。Schema
输入
相机运动类型。需要提供图像。可能的值:
fixed、pan_left、pan_right、tilt_up、tilt_down、truck_left、truck_right、pedestal_up、pedestal_down、push_in、pull_out图像的 Cloud Storage URI。在非 BYOK 请求中,若
gs:// URI(或其 https://storage.googleapis.com 形式)指向 Comfy 拥有的存储桶,则会以 400 拒绝;除非该对象位于你自己的 POST /customers/storage 前缀之下,或者它是一段上一个 Veo 生成为你写入的视频。图像的 Cloud Storage URI。在非 BYOK 请求中,若
gs:// URI(或其 https://storage.googleapis.com 形式)指向 Comfy 拥有的存储桶,则会以 400 拒绝;除非该对象位于你自己的 POST /customers/storage 前缀之下,或者它是一段上一个 Veo 生成为你写入的视频。遮罩文件的 Cloud Storage URI。在非 BYOK 请求中,若
gs:// URI(或其 https://storage.googleapis.com 形式)指向 Comfy 拥有的存储桶,则会以 400 拒绝;除非该对象位于你自己的 POST /customers/storage 前缀之下,或者它是一段上一个 Veo 生成为你写入的视频。图像的 Cloud Storage URI。在非 BYOK 请求中,若
gs:// URI(或其 https://storage.googleapis.com 形式)指向 Comfy 拥有的存储桶,则会以 400 拒绝;除非该对象位于你自己的 POST /customers/storage 前缀之下,或者它是一段上一个 Veo 生成为你写入的视频。输入视频的 Cloud Storage URI。在非 BYOK 请求中,若
gs:// URI(或其 https://storage.googleapis.com 形式)指向 Comfy 拥有的存储桶,则会以 400 拒绝;除非该对象位于你自己的 POST /customers/storage 前缀之下,或者它是一段上一个 Veo 生成为你写入的视频。视频的 MIME 类型可能的值:
video/mov、video/mpeg、video/mp4、video/mpg、video/avi、video/wmv、video/mpegps、video/x-flv控制已生成视频中的人物。默认值:allow_adult。
ALLOW 和 BLOCK 也受支持,出于与 Veo2GenVidRequest 的 personGeneration 枚举包含它们相同的兼容性原因(参见该组件处的说明):ComfyUI 的 Veo 3 合作伙伴节点(comfy_api_nodes/nodes_veo2.py)始终将其中的一种拼写(绝不使用 Vertex 自己的拼写)发送到 /proxy/veo/{model}/generate,用于 veo-3.1-generate-001、veo-3.1-fast-generate-001 和 veo-3.1-lite-generate-001,也就是此组件作为 Router 输入 schema 所对应的三个 ID。在针对其中某个 ID 的 Router 调度(model_provider=veo)中,无论是同步还是排队(/v2/models/veo/{model}/requests),在请求到达 Vertex 之前,ALLOW 会映射为 allow_adult,BLOCK 会映射为 dont_allow(routerVeoMapPersonGeneration,server/middleware/router_veo_person_generation.go),因为 Vertex 本身不接受这两种拼写。直接调用 v1 /proxy/veo/:modelId/generate 的调用方无论如何都不受影响:comfy-api 没有在 /proxy/* 上安装请求校验器,因此此枚举在那里本来就已经是不具强制力的说明性文档,而仅限 Router 的映射不会对它运行。可能的值:dont_allow、allow_adult、allowAll、ALLOW、BLOCK用于进度更新的 Cloud Pub/Sub 主题(projects/{project}/topics/{topic})。使用 Comfy 凭据(非 BYOK)的请求不接受此项:如果存在该项,生成路由会返回 400,因为该操作在 Comfy 的项目中运行,Vertex 会以 Comfy 的服务代理身份发布。仅在自带密钥请求中接受,此时 Vertex 会在你自己的项目中评估主题授权。
可选的 Cloud Storage 目标位置,用于存放已生成的视频,格式为
gs:// URI。
它必须指向你自己的存储桶。在非自带密钥(bring-your-own-key)的情况下,此路由使用 Comfy 自己的 Google Cloud 凭据而不是你的凭据运行,因此指向 Comfy 拥有存储桶的目标位置会变成由 Comfy 服务账号执行的写入,落到共享布局中,并计入 Comfy 的项目费用。指定此类目标位置的请求会以 400 被拒绝,且不会生成任何内容;唯一例外是启用了平台存储的同步 Comfy Router 调用(POST /v2/models/{provider}/{model}):若值指向 Router 自己的 Veo 或 Gemini 资产存储桶,则会替换为 Router 为该次调用在你自己的平台前缀下生成的目标位置(参见 Router Veo 路由),并且只有这个由 Router 生成的确切目标位置会被放行。排队的 Router 提交(POST /v2/models/{provider}/{model}/requests)不会做这种替换,因此会像对待任何其他 Comfy 拥有的存储桶一样,以 400 拒绝该值。任何其他目标位置都会原样转发给 Vertex,访问权限由你自行授予。自带密钥的调用在你自己的项目中运行,并按发送内容原样转发。GET /v2/models/veo/veo-3.1-lite-generate-001/openapi.json 提供的 schema 生成,该文档与请求到达提供商之前用于校验调用的文档相同。
输出
示例
输入
输出
发布前须知
SDK 会生成Idempotency-Key 并在自动重试中复用它。手动重试时,请复用原始 key。Router 最长可保持连接 10 分钟。
请求失败时,Router 会发送 X-Comfy-Error-Type 响应头说明原因。422 表示 Router 在调用提供商之前就拒绝了输入,413 表示请求体超出了 Router 可接受的大小。已生成的资源请及时下载,因为结果 URL 会过期。
上文任何字段描述中提到的尺寸限制,都是提供商对该字段自身的限定,引自提供商的规范。Router 会对整个请求体另行设置上限,base64 编码的媒体内容也计入其中:参见请求体大小。
本页记录的是通过 Comfy Router 调用的某一个合作伙伴模型。同一个 comfy-sdk / @comfyorg/sdk 包还提供第二个客户端,用于在 Comfy Cloud 上运行完整的 ComfyUI 工作流图:Comfy(api_key=...) / new Comfy({ apiKey }),并带有 client.workflows、client.assets 和 client.jobs。请参阅 Comfy SDKs。
请求头
身份验证、幂等性、请求 ID、错误分类、重试节奏、消费限额。
使用 Router API
模型发现、验证错误、重试与计费。
限制
Router 目前不支持的功能,以及替代方案。