Skip to main content
POST
モデル名互換のお知らせ:本エンドポイントはエイリアスにも対応しています。veo3.1-fast-extveo3.1-fast と、veo3.1-quality-extveo3.1-quality と、veo3.1-lite-extveo3.1-lite とそれぞれ同等です。いずれも互換的に使用でき、効果は同一です。

認証

string
必須
すべてのAPIエンドポイントでBearer Tokenによる認証が必要ですAPI Keyの取得:API Key管理ページにアクセスしてAPI Keyを取得してください使用時はリクエストヘッダーに追加:

リクエストパラメータ

string
デフォルト:"veo3.1-fast"
必須
動画生成モデル名利用可能なモデル:
  • veo3.1-fast - 高速生成モデル、クイックプレビューと反復処理に適しています(エイリアス veo3.1-fast-ext に対応)
  • veo3.1-quality - 高品質生成モデル、最終制作に適しています(エイリアス veo3.1-quality-ext に対応)
  • veo3.1-lite - 軽量生成モデル、低コストの大量生成に適しています(エイリアス veo3.1-lite-ext に対応)
Example: "veo3.1-fast"
旧バージョンの呼び出しとの互換性のため、エイリアス veo3.1-fast-extveo3.1-fast に対応)、veo3.1-quality-extveo3.1-quality に対応)、veo3.1-lite-extveo3.1-lite に対応)は引き続き正常に使用できます。
boolean
デフォルト:"false"
動画タスクを送信する前にコンテンツモデレーションを実行するかどうかを指定します。
  • trueomni-moderation-latest でプロンプトと入力画像を審査
  • false または省略:審査リクエストを行わず、審査コストや遅延を追加しない(デフォルト)
string
必須
動画生成のテキスト説明
integer
動画の長さ(秒)固定値:8(VEO3 は 8 秒の長さのみサポート)
string
動画のアスペクト比サポートされている形式:
  • 16:9 (横向き)
  • 9:16 (縦向き)
string
動画生成タイプサポートされているタイプ:
  • frame - フレームから動画へ(FLモード)
  • reference - 参照画像から動画へ
未指定の場合、画像数に基づいて自動判定:2枚はフレームから動画、3枚は参照画像から動画注意:veo3.1-quality モデルは reference モードをサポートしていません
veo3.1-lite モデルはこのパラメータをサポートしていません、渡さないでください
array<url>
動画生成に使用する参考画像URLの配列公開アクセス可能な画像URL(http:// または https://)をサポート例:["https://example.com/image.jpg"]制限:
  • 最大3枚
  • フレームから動画モードの場合:1枚目が開始フレーム、2枚目が終了フレーム
  • 最大ファイルサイズ:10MB
  • サポート形式:.jpeg、.jpg、.png、.webp
veo3.1-lite モデルはこのパラメータをサポートしていません、渡さないでください
string
動画解像度サポートされる値:
  • 720p(デフォルト)
  • 1080p
  • 4k
boolean
GIF出力形式を有効にする。デフォルト:false注意:GIFと1080p、4k解像度は同時に使用できません
boolean
デフォルト:"false"
公式チャネルをフォールバックとして使用するかどうか
  • false:使用しない(デフォルト)
  • true:公式チャネルを使用する
veo3.1-lite モデルはこのパラメータをサポートしていません、渡さないでください

レスポンス

integer
レスポンスステータスコード
array
レスポンスデータ配列