Skip to main content
veo/veo-3.0-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.0-generate-001 エンドポイント: POST https://api.comfy.org/v2/models/veo/veo-3.0-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
生成されるビデオのフレームレート (フレーム/秒)
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.0-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 が現在対応していないことと、代替手段。