veo/veo-3.1-lite-generate-001 の API リファレンス。
入力: テキスト, 画像, ビデオ · 出力: ビデオ + オーディオ
クイックスタート
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 を返し、結果は準備ができ次第、このプロセスからでも別のプロセスからでも収集できます。キュー配信では、ステータス、キャンセル、収集について順を追って説明します。スキーマ
入力
カメラの動きの種類。画像を指定する必要があります。取り得る値:
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 リクエストでは、Comfy が所有するバケットを指す
gs:// URI(またはその https://storage.googleapis.com 形式)は 400 で拒否されます。ただし、そのオブジェクトが自分の POST /customers/storage プレフィックス配下にある場合、または以前の Veo 生成が自分のために書き込んだビデオである場合を除きます。画像の Cloud Storage URI。非 BYOK リクエストでは、Comfy が所有するバケットを指す
gs:// URI(またはその https://storage.googleapis.com 形式)は 400 で拒否されます。ただし、そのオブジェクトが自分の POST /customers/storage プレフィックス配下にある場合、または以前の Veo 生成が自分のために書き込んだビデオである場合を除きます。マスクファイルの Cloud Storage URI。非 BYOK リクエストでは、Comfy が所有するバケットを指す
gs:// URI(またはその https://storage.googleapis.com 形式)は 400 で拒否されます。ただし、そのオブジェクトが自分の POST /customers/storage プレフィックス配下にある場合、または以前の Veo 生成が自分のために書き込んだビデオである場合を除きます。ビデオ生成をガイドするためのオプションの参照画像。最大 3 つのアセット画像または 1 つのスタイル画像をサポートします。Veo 3.1 モデル (プレビュー) でサポートされています。
画像の Cloud Storage URI。非 BYOK リクエストでは、Comfy が所有するバケットを指す
gs:// URI(またはその https://storage.googleapis.com 形式)は 400 で拒否されます。ただし、そのオブジェクトが自分の POST /customers/storage プレフィックス配下にある場合、または以前の Veo 生成が自分のために書き込んだビデオである場合を除きます。入力ビデオの Cloud Storage URI。非 BYOK リクエストでは、Comfy が所有するバケットを指す
gs:// URI(またはその https://storage.googleapis.com 形式)は 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 enum がこれらを保持しているのと同じ互換性の理由によるものです(そのコンポーネントの注記を参照)。ComfyUI の Veo 3 パートナーノード(comfy_api_nodes/nodes_veo2.py)は、veo-3.1-generate-001、veo-3.1-fast-generate-001、veo-3.1-lite-generate-001 に対して /proxy/veo/{model}/generate へ、常にこの 2 つの綴りのいずれかを送信し、Vertex 自身の綴りを送ることはありません。これら 3 つの ID が、このコンポーネントが Router 入力スキーマとなる対象です。これらの 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/* にリクエストバリデーターをインストールしないため、この enum はそこではもともと強制されないドキュメントであり、Router 専用のマッピングもその呼び出しでは実行されません。取り得る値: dont_allow, allow_adult, allowAll, ALLOW, BLOCK進捗更新のための Cloud Pub/Sub トピック(projects/{project}/topics/{topic})。Comfy の認証情報を使う(non-BYOK)リクエストでは受け付けられません。指定されている場合、generate ルートは 400 を返します。これは、操作が Comfy のプロジェクトで実行され、Vertex が Comfy のサービスエージェントとして公開することになるためです。受け付けられるのは bring-your-own-key リクエストのみで、その場合 Vertex はあなた自身のプロジェクトでトピックの許可を評価します。
生成されたビデオの保存先となる省略可能な Cloud Storage の場所(
gs:// URI)。
自分自身のバケットを指定する必要があります。bring-your-own-key 以外では、このルートは自分のものではなく Comfy 自身の Google Cloud 認証情報で実行されるため、Comfy が所有するバケット内の保存先は、Comfy のサービスアカウントが共有レイアウトに対して実行し、Comfy のプロジェクトに課金される書き込みになります。そのような値を指定したリクエストは 400 で拒否され、何も生成されません。例外は 1 つだけで、プラットフォームストレージが有効な同期 Comfy Router 呼び出し(POST /v2/models/{provider}/{model})です。この場合、Router 自身の Veo または Gemini アセットバケットを指す値は、その呼び出しのために Router が自分のプラットフォームプレフィックス配下で発行する保存先に置き換えられ、その Router が発行した正確な保存先だけが通されます。キュー中の Router 送信(POST /v2/models/{provider}/{model}/requests)ではそのような置き換えは行われないため、他の Comfy 所有バケットと同様にその値を 400 で拒否します。それ以外の保存先は変更されずに Vertex へ転送され、アクセス権の付与は自分の責任です。bring-your-own-key の呼び出しは自分のプロジェクトで実行され、送信されたまま転送されます。GET /v2/models/veo/veo-3.1-lite-generate-001/openapi.json で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する際に使用するドキュメントと同じものです。
出力
例
入力
出力
出荷前の確認
SDK はIdempotency-Key を生成し、自動リトライで再利用します。手動リトライでは元のキーを再利用してください。Router は最大 10 分間接続を保持できます。
リクエストが失敗すると、Router は理由を説明する X-Comfy-Error-Type レスポンスヘッダーを送信します。422 は、プロバイダーを呼び出す前に Router が入力を拒否したことを意味し、413 はリクエスト本文が Router の受け入れ可能なサイズを超えていたことを意味します。生成されたアセットは 結果 URL の有効期限 があるため、早めにダウンロードしてください。
上記のフィールド説明に記載されているサイズ制限は、プロバイダーの仕様から引用した、そのフィールドに対するプロバイダー自身の上限です。Router はリクエスト本文全体に対して別の上限を適用し、base64 エンコードされたメディアもこれにカウントされます。リクエスト本文のサイズ を参照してください。
このページは、Comfy Router 経由で呼び出す 1 つのパートナーモデルについて説明しています。同じ comfy-sdk / @comfyorg/sdk パッケージには、Comfy Cloud 上で ComfyUI のワークフローグラフ全体を実行するための 2 つ目のクライアントも含まれています: Comfy(api_key=...) / new Comfy({ apiKey })、および client.workflows、client.assets、client.jobs。Comfy SDKs を参照してください。
ヘッダー
認証、冪等性、リクエスト ID、エラー分類、リトライ間隔、支出上限。
Router API の利用
モデルの検出、バリデーションエラー、リトライ、課金。
制限事項
Router が現在対応していないことと、代替手段。