Skip to main content
veo/veo-3.1-generate-001 の API リファレンス。Veo から Comfy Router によって提供されます。

クイックスタート

Comfy ワークスペースでキーを作成し、COMFY_API_KEY としてエクスポートします。Python と TypeScript のスニペットは Comfy SDK(pip install comfy-sdknpm install @comfyorg/sdk)を使用しています。cURL スニペットは同じ呼び出しを生の HTTP で行うものです。 モデル ID: veo/veo-3.1-generate-001 エンドポイント: POST https://api.comfy.org/v2/models/veo/veo-3.1-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
ビデオ生成リクエストの操作タイプ指定可能な値: textToVideo, imageToVideo, referenceToVideo, edit, extend, upscale
Router が GET /v2/models/veo/veo-3.1-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 が現在対応していないことと、代替手段。