Skip to main content
veo/veo-3.1-fast-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.1-fast-generate-001 エンドポイント: POST https://api.comfy.org/v2/models/veo/veo-3.1-fast-generate-001

スキーマ

入力

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
生成されるビデオのフレームレート(1 秒あたりのフレーム数)
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本のビデオが生成されます。範囲: 1 から 4
integer
決定論的な出力のためのランダムシード。sampleCount > 1 の場合は、ビデオごとに異なるシードが使用されます。形式: uint32
string
生成されたビデオを保存するための Cloud Storage URI (gs://)
string
ビデオ生成リクエストの操作タイプ指定可能な値: textToVideoimageToVideoreferenceToVideoeditextendupscale
Router が GET /v2/models/veo/veo-3.1-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 が現在対応していないことと、代替手段。