Skip to main content
POST

認証

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

リクエストパラメータ

string
必須
動画生成モデル名利用可能なモデル:
  • veo3.1-fast-official - Veo 3.1 公式高速版
  • veo3.1-quality-official - Veo 3.1 公式高品質版
string
必須
正のテキストプロンプトシーン、アクション、スタイルなどを詳細に記述すると、より良い生成結果が得られます。英語プロンプトの使用を推奨します。例:"a golden retriever running on the beach, sunset, cinematic"
string
不要なコンテンツを除外するためのネガティブプロンプト例:"blurry, low quality, watermark, text"
integer
デフォルト:"8"
動画の長さ(秒)推奨値:4 / 6 / 8デフォルト:8⚠️ 注意: 純粋な数値(例:8)を入力してください。引用符を付けるとエラーが発生します
string
デフォルト:"16:9"
動画のアスペクト比選択可能な値:
  • 16:9 - 横向き
  • 9:16 - 縦向き
デフォルト:16:9
string
デフォルト:"720p"
動画解像度選択可能な値:
  • 720p - 標準解像度
  • 1080p - 高解像度
  • 4K - 超高解像度
デフォルト:720p
string
先頭フレーム画像URL、画像から動画生成に使用
  • 画像URLは公開アクセス可能で、ホットリンク保護がないものが必要です
  • 一時ダウンロードリンクではなく、オブジェクトストレージURLの使用を推奨します
string
末尾フレーム画像URL、画像から動画生成に使用first_frame_image と組み合わせて、先頭・末尾フレームの制御を実現します
integer
生成結果を再現するためのランダムシード値の範囲:0 - 4294967295
integer
デフォルト:"1"
生成サンプル数 1-4、現在は 1 の使用を推奨デフォルト:1
boolean
デフォルト:"false"
音声トラックを生成するかどうか
string
デフォルト:"allow_adult"
人物生成ポリシー選択可能な値:
  • allow_adult - 成人の人物/顔のみ生成を許可
  • disallow - 人物や顔の生成を許可しない
デフォルト:allow_adult
string
デフォルト:"pad"
画像リサイズ戦略(画像から動画生成時に有効)選択可能な値:
  • pad - パディングモード
  • crop - クロップモード
デフォルト:pad
boolean
デフォルト:"true"
上流プロンプト強化を有効にするかどうかデフォルト値:true
  • このパラメータは true のみ設定可能です。false に設定するとリクエストエラーが発生します
  • このパラメータが不要な場合は、送信しないでください

テキストから動画 vs 画像から動画

システムは画像パラメータの有無で自動的にモードを判定します:画像なしはテキストから動画、画像ありは画像から動画。

レスポンス

integer
レスポンスステータスコード、成功時は 200
array
レスポンスデータ配列

使用シナリオ

シナリオ 1:テキストから動画(基本)

シナリオ 2:テキストから動画(全パラメータ)

シナリオ 3:画像から動画(先頭フレーム1枚)

シナリオ 4:画像から動画(先頭フレーム + 末尾フレーム)

シナリオ 5:音声付き動画の生成

タスク結果の照会動画生成は非同期タスクです。送信後に task_id が返されます。タスクステータスの取得 エンドポイントを使用して、生成の進行状況と結果を照会してください。