Skip to main content
veo/veo-3.0-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.0-generate-001 端点: POST https://api.comfy.org/v2/models/veo/veo-3.0-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
自动优化提示词以获得更高质量。默认为 true。
integer
已生成视频的帧率,单位为每秒帧数
boolean
是否在生成视频的同时生成音频。默认为 true。受 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.0-generate-001/openapi.json 所提供的 schema 生成,这也是 Router 在请求到达提供商之前校验调用时所依据的同一份文档。

输出

boolean
操作是否已完成
object
错误详情,操作失败时存在
integer
gRPC 错误代码
string
报错信息
string
操作资源名称
object
预测响应,done 为是时存在
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 目前不支持的功能,以及替代方案。