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
- 結果を待つ
- キューに送信して後で収集する
スキーマ
入力
object[]
string
カメラの動きの種類。画像を指定する必要があります。取り得る値:
fixed, pan_left, pan_right, tilt_up, tilt_down, truck_left, truck_right, pedestal_up, pedestal_down, push_in, pull_outobject
ビデオ生成をガイドするためのオプションの先頭フレーム画像
string (byte)
Base64 でエンコードされた画像データ形式:
bytestring
画像の Cloud Storage URI
string
画像の MIME タイプ (image/jpeg または image/png)取り得る値:
image/jpeg, image/pngobject
オプションの末尾フレーム画像。image と併用して、先頭フレームと末尾フレームの間のビデオを生成します。Veo 3.0+ モデルでサポートされています。
string (byte)
Base64 でエンコードされた画像データ形式:
bytestring
画像の Cloud Storage URI
string
画像の MIME タイプ (image/jpeg または image/png)取り得る値:
image/jpeg, image/pngobject
ビデオ編集用のオプションのマスク。入力ビデオに適用されます。
string (byte)
Base64 でエンコードされたマスクのバイトデータ形式:
bytestring
マスクファイルの Cloud Storage URI
string
マスクの適用方法取り得る値:
insert, remove, remove_static, outpaintstring
マスクの MIME タイプ (image/png、image/jpeg、image/webp、またはビデオ形式)
string
必須
生成するビデオのテキスト説明
object[]
ビデオ生成をガイドするためのオプションの参照画像。最大 3 つのアセット画像または 1 つのスタイル画像をサポートします。Veo 3.1 モデル (プレビュー) でサポートされています。
object
必須
string (byte)
Base64 でエンコードされた画像データ形式:
bytestring
画像の Cloud Storage URI
string
画像の MIME タイプ (image/jpeg または image/png)取り得る値:
image/jpeg, image/pngstring
参照画像のオプションの識別子
string
必須
参照画像のタイプ取り得る値:
asset, styleobject
ビデオ拡張または編集用のオプションの入力ビデオ。image および referenceImages とは併用できません。
string (byte)
Base64 でエンコードされたビデオのバイトデータ形式:
bytestring
入力ビデオの Cloud Storage URI
string
ビデオの MIME タイプ取り得る値:
video/mov, video/mpeg, video/mp4, video/mpg, video/avi, video/wmv, video/mpegps, video/x-flvobject
string
生成されるビデオのアスペクト比。デフォルト: 16:9取り得る値:
16:9, 9:16string
ビデオの圧縮品質。デフォルト: optimized取り得る値:
optimized, losslessnumber
生成されるビデオの目標再生時間 (秒)。Veo 2: 5-8。Veo 3/3.1: 4、6、または 8。デフォルト: 8
boolean
より高品質にするためにプロンプトを自動的に改善します。デフォルトは true です。
integer
生成されるビデオのフレームレート (1 秒あたりのフレーム数)
boolean
ビデオとともにオーディオを生成するかどうか。デフォルトは true です。Veo 3.0+ モデルでサポートされています。
string
生成されるビデオで避けるべき内容を記述したテキスト
string
生成されるビデオに登場する人物を制御します。デフォルト: allow_adult取り得る値:
dont_allow, allow_adult, allowAllstring
進捗更新用の Cloud Pub/Sub トピック (projects/{project}/topics/{topic})
string
入力画像のリサイズ方法。デフォルト: pad取り得る値:
pad, cropstring
出力ビデオの解像度。Veo 3.0+ モデルでサポートされています。デフォルト: 720p取り得る値:
720p, 1080p, 4kinteger
生成するビデオの数。指定しない場合は 1 本のビデオが生成されます。範囲:
1 から 4integer
決定論的な出力のためのランダムシード。sampleCount > 1 の場合は、ビデオごとに異なるシードが使用されます。形式:
uint32string
生成されたビデオを保存するための Cloud Storage URI (gs://)
string
ビデオ生成リクエストの操作タイプ指定可能な値:
textToVideo、imageToVideo、referenceToVideo、edit、extend、upscaleGET /v2/models/veo/veo-3.1-lite-generate-001/openapi.json で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する際に使用するドキュメントと同じものです。
出力
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 を生成し、自動リトライで再利用します。手動リトライでは元のキーを再利用してください。Router は最大 10 分間接続を保持できます。
リクエストが失敗すると、Router は理由を示す X-Comfy-Error-Type レスポンスヘッダーを送信します。422 は、プロバイダーを呼び出す前に Router が入力を拒否したことを意味します。生成されたアセットは 結果 URL の有効期限 があるため、早めにダウンロードしてください。
ヘッダー
認証、冪等性、リクエスト ID、エラー分類、リトライ間隔、支出上限。
Router API の利用
モデルの検出、バリデーションエラー、リトライ、課金。
制限事項
Router が現在対応していないことと、代替手段。