veo/veo-3.0-fast-generate-001 の API リファレンス。Veo から Comfy Router 経由で提供されます。
クイックスタート
Comfy ワークスペースでキーを作成し、COMFY_API_KEY としてエクスポートします。Python と TypeScript のスニペットは Comfy SDK(pip install comfy-sdk、npm install @comfyorg/sdk)を使用しています。cURL のスニペットは、生の HTTP で同じ呼び出しを行うものです。
モデル ID: veo/veo-3.0-fast-generate-001
エンドポイント: POST https://api.comfy.org/v2/models/veo/veo-3.0-fast-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.0-fast-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 が現在対応していないことと、代替手段。