> ## Documentation Index > Fetch the complete documentation index at: https://docs.comfy.org/llms.txt > Use this file to discover all available pages before exploring further. # 搭配 Comfy Router 使用 Veo 3.0 Generate 001 > 通过 Comfy Router 调用 veo/veo-3.0-generate-001：端点、请求结构以及 Router 返回的响应。 `veo/veo-3.0-generate-001` 的 API 参考，由 Comfy Router 提供，来源为 Veo。 ## 快速开始在[你的 Comfy 工作区](https://platform.comfy.org/profile/api-keys)中创建密钥，并将其导出为 `COMFY_API_KEY`。Python 和 TypeScript 代码片段使用 Comfy SDK（`pip install comfy-sdk`、`npm 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` ```python Python theme={null} from comfy_sdk import Comfy # Reads COMFY_API_KEY from the environment. # The SDK automatically creates an idempotency key and reuses it for automatic retries. with Comfy() as client: result = client.models.run( "veo/veo-3.0-generate-001", { "instances": [ { "prompt": "a single red maple leaf falling onto still water, slow motion", }, ], "parameters": { "durationSeconds": 4, "generateAudio": False, "sampleCount": 1, }, }, ) print(result) ``` ```typescript TypeScript theme={null} import { comfy } from "@comfyorg/sdk"; // Reads COMFY_API_KEY from the environment. // The SDK automatically creates an idempotency key and reuses it for automatic retries. const { data } = await comfy.models.run("veo/veo-3.0-generate-001", { instances: [ { prompt: "a single red maple leaf falling onto still water, slow motion", }, ], parameters: { durationSeconds: 4, generateAudio: false, sampleCount: 1, }, }); console.log(data); ``` ```bash cURL theme={null} curl https://api.comfy.org/v2/models/veo/veo-3.0-generate-001 \ -H "X-API-Key: $COMFY_API_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d "{\"instances\": [{\"prompt\":\"a single red maple leaf falling onto still water, slow motion\"}], \"parameters\": {\"durationSeconds\":4,\"generateAudio\":false,\"sampleCount\":1}}" ``` 相同的请求体，发送至 `POST https://api.comfy.org/v2/models/veo/veo-3.0-generate-001/requests`。只要运行被接纳，Router 就会立即返回 `201` 和 `request_id`，结果准备就绪后即可收集，可以在本进程中收集，也可以在另一个进程中收集。[队列投递](/zh/development/comfy-router/queue) 会详细说明状态、取消和收集的流程。 ```python Python theme={null} from comfy_sdk import Comfy # Reads COMFY_API_KEY from the environment. # Each submit() call mints its own Idempotency-Key and reuses it for automatic retries. with Comfy() as client: handle = client.models.submit( "veo/veo-3.0-generate-001", { "instances": [ { "prompt": "a single red maple leaf falling onto still water, slow motion", }, ], "parameters": { "durationSeconds": 4, "generateAudio": False, "sampleCount": 1, }, }, ) print("request_id:", handle.request_id) # with the model ID, all another process needs # Poll until the request completes, waiting the Retry-After the server names. for update in handle.iter_events(): print(update.status, update.queue_position) # The provider's own payload, the same value models.run() returns. # A request that failed or was cancelled raises the typed Router error here. result = handle.get() print(result) ``` ```typescript TypeScript theme={null} import { comfy } from "@comfyorg/sdk"; // Reads COMFY_API_KEY from the environment. // Each submit() call mints its own Idempotency-Key and reuses it for automatic retries. const handle = await comfy.models.submit("veo/veo-3.0-generate-001", { instances: [ { prompt: "a single red maple leaf falling onto still water, slow motion", }, ], parameters: { durationSeconds: 4, generateAudio: false, sampleCount: 1, }, }); console.log("requestId:", handle.requestId); // with the model ID, all another process needs // Poll until the request completes, waiting the Retry-After the server names. for await (const update of handle.events()) { console.log(update.status, update.queuePosition); } // The same result models.run() returns. A request that failed or was cancelled rejects here. const result = await handle.get(); console.log(result.data); ``` ```bash cURL theme={null} # 1. Submit. Router answers 201 with request_id, status_url, response_url and cancel_url. curl https://api.comfy.org/v2/models/veo/veo-3.0-generate-001/requests \ -H "X-API-Key: $COMFY_API_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d "{\"instances\": [{\"prompt\":\"a single red maple leaf falling onto still water, slow motion\"}], \"parameters\": {\"durationSeconds\":4,\"generateAudio\":false,\"sampleCount\":1}}" # 2. Poll until status is COMPLETED, waiting the Retry-After seconds each response names. REQUEST_ID="" curl -i https://api.comfy.org/v2/models/veo/veo-3.0-generate-001/requests/$REQUEST_ID/status \ -H "X-API-Key: $COMFY_API_KEY" # 3. Collect. 200 with the model's native output, 202 with the status body while it is still running. curl https://api.comfy.org/v2/models/veo/veo-3.0-generate-001/requests/$REQUEST_ID \ -H "X-API-Key: $COMFY_API_KEY" ``` ## Schema ### 输入相机运动类型。需要提供图像。可选值：`fixed`、`pan_left`、`pan_right`、`tilt_up`、`tilt_down`、`truck_left`、`truck_right`、`pedestal_up`、`pedestal_down`、`push_in`、`pull_out` 可选的用于引导视频生成的首帧图像 Base64 编码的图像数据格式：`byte` 图像的 Cloud Storage URI 图像的 MIME 类型（image/jpeg 或 image/png）可选值：`image/jpeg`、`image/png` 可选的尾帧图像。与 image 配合使用，可在首帧与尾帧之间生成视频。受 Veo 3.0+ 模型支持。 Base64 编码的图像数据格式：`byte` 图像的 Cloud Storage URI 图像的 MIME 类型（image/jpeg 或 image/png）可选值：`image/jpeg`、`image/png` 用于视频编辑的可选遮罩。作用于输入视频。 Base64 编码的遮罩字节格式：`byte` 遮罩文件的 Cloud Storage URI 遮罩的应用方式可选值：`insert`、`remove`、`remove_static`、`outpaint` 遮罩的 MIME 类型（image/png、image/jpeg、image/webp 或视频格式）要生成的视频的文本描述用于引导视频生成的可选参考图像。最多支持 3 张素材图像或 1 张风格图像。受 Veo 3.1 模型（预览）支持。 Base64 编码的图像数据格式：`byte` 图像的 Cloud Storage URI 图像的 MIME 类型（image/jpeg 或 image/png）可选值：`image/jpeg`、`image/png` 参考图像的可选标识符参考图像的类型可选值：`asset`、`style` 用于视频扩展或编辑的可选输入视频。与 image 和 referenceImages 不兼容。 Base64 编码的视频字节格式：`byte` 输入视频的 Cloud Storage URI 视频的 MIME 类型可选值：`video/mov`、`video/mpeg`、`video/mp4`、`video/mpg`、`video/avi`、`video/wmv`、`video/mpegps`、`video/x-flv` 已生成视频的宽高比。默认：16:9 可选值：`16:9`、`9:16` 视频压缩质量。默认：optimized 可选值：`optimized`、`lossless` 已生成视频的目标时长（秒）。Veo 2：5-8。Veo 3/3.1：4、6 或 8。默认：8 自动优化提示词以获得更高质量。默认为 true。已生成视频的帧率，单位为每秒帧数是否在生成视频的同时生成音频。默认为 true。受 Veo 3.0+ 模型支持。描述已生成视频中需要避免的内容的文本控制已生成视频中的人物。默认：allow\_adult 可选值：`dont_allow`、`allow_adult`、`allowAll` 用于进度更新的 Cloud Pub/Sub 主题（projects/\{project}/topics/\{topic}）输入图像的调整大小方式。默认：pad 可选值：`pad`、`crop` 输出视频分辨率。受 Veo 3.0+ 模型支持。默认：720p 可选值：`720p`、`1080p`、`4k` 要生成的视频数量。如果未指定，则生成 1 个视频。范围：`1` 到 `4` 用于确定性输出的随机种子。如果 sampleCount > 1，则每个视频使用不同的种子。格式：`uint32` 用于保存已生成视频的 Cloud Storage URI（gs\://）视频生成请求的操作类型可能的值：`textToVideo`、`imageToVideo`、`referenceToVideo`、`edit`、`extend`、`upscale` 根据 Router 在 `GET /v2/models/veo/veo-3.0-generate-001/openapi.json` 所提供的 schema 生成，这也是 Router 在请求到达提供商之前校验调用时所依据的同一份文档。 ### 输出操作是否已完成错误详情，操作失败时存在 gRPC 错误代码报错信息操作资源名称预测响应，done 为是时存在被负责任 AI 策略过滤的视频数量视频被负责任 AI 策略过滤的原因 Base64 编码的视频内容已生成视频的 Cloud Storage URI 视频 MIME 类型（video/mp4） ## 示例 ### 输入 ```json theme={null} { "instances": [ { "prompt": "a single red maple leaf falling onto still water, slow motion" } ], "parameters": { "durationSeconds": 4, "generateAudio": false, "sampleCount": 1 } } ``` ### 输出 ```json theme={null} { "done": true, "name": "projects/example-project/locations/us-central1/publishers/google/models/veo-3.1-fast-generate-001/operations/1a2b3c4d", "response": { "@type": "type.googleapis.com/cloud.ai.large_models.vision.GenerateVideoResponse", "raiMediaFilteredCount": 0, "videos": [ { "gcsUri": "https://storage.googleapis.com/EXAMPLE_BUCKET/veo/USER_ID/REQUEST_ID/sample_0.mp4", "mimeType": "video/mp4" } ] } } ``` ## 发布前须知 SDK 会生成 `Idempotency-Key` 并在自动重试中复用它。手动重试时，请复用原始 key。Router 最长可保持连接 10 分钟。请求失败时，Router 会发送 `X-Comfy-Error-Type` 响应头说明原因。`422` 表示 Router 在调用提供商之前就拒绝了输入。生成的资源请及时下载，因为[结果链接会过期](/zh/development/comfy-router/reference#结果资产)。身份验证、幂等性、请求 ID、错误分类、重试节奏、消费限额。模型发现、校验错误、重试与计费。 Router 目前不支持的功能，以及替代方案。