Skip to main content
POST

認証

string
必須
すべての API で Bearer Token による認証が必要です。API キーの取得:API キー管理ページにアクセスして API キーを取得します。使用時はリクエストヘッダーに追加します:

リクエストパラメータ

string
必須
動画生成モデル名。gemini-omni-1.1-flash 固定です。
string
テキスト指示。テキストから動画ではシーンを、画像から動画、動画編集、延長では動き、スタイル、編集内容を記述します。
prompt または素材(image_urls、開始・終了フレーム画像、video_urls)のいずれかを少なくとも 1 つ指定してください。
string
デフォルト:"720p"
出力動画の解像度。大文字と小文字は区別されません。選択可能な値:
  • 360p
  • 720p(デフォルト)
  • 1080p
  • 4k
2160p4k として扱われます。解像度によってタスクのデポジット区分と主な動画出力コストが決まります。
未対応の解像度を指定すると invalid_resolution エラーが返されます。
string
デフォルト:"16:9"
動画のアスペクト比。横向きまたは縦向きの出力を指定します。対応値:
  • 16:9 - 横向き(デフォルト)
  • 9:16 - 縦向き
その他の値は 16:9 として扱われます。
video_urls を指定した場合、出力は通常入力動画のアスペクト比に従うため、aspect_ratio が反映されないことがあります。
array<string>
参照画像の配列。公開アクセス可能な HTTP/HTTPS URL のみ対応します。
  • 画像を 1 枚指定:デフォルトで動画の開始フレームとして使用
  • 複数画像を指定:複数被写体またはスタイルの参照として使用。各画像の用途と関係を prompt に記述してください
image_urls と開始・終了フレーム画像は合計 10 枚までです。
string
開始フレーム画像。公開アクセス可能な HTTP/HTTPS URL のみ対応します。
  • 単独で指定:動画の開始フレームとして使用
  • last_frame_image と同時に指定:開始フレームから終了フレームへ滑らかに遷移する動画を生成
string
終了フレーム画像。公開アクセス可能な HTTP/HTTPS URL のみ対応し、first_frame_image と同時に指定する必要があります。
last_frame_image のみを指定すると invalid_frame_images エラーが返されます。開始・終了フレーム画像は同じ比率にし、aspect_ratio と一致させることを推奨します。
開始フレームまたは開始・終了フレーム生成では、次の 2 つの指定方法は同じ効果です。いずれか一方を選び、同時に指定しないでください
  • first_frame_image / last_frame_image を使用
  • image_with_roles を使用し、rolefirst_frame / last_frame に設定
array<object>
ロール付き画像の配列。first_frame_image / last_frame_image と同等の指定方法として使用でき、参照画像の宣言にも使用できます。例:
image_urls も指定した場合、参照画像は image_urls が優先され、image_with_roles の参照画像とは結合されません。実際に使用されるすべての画像は、開始・終了フレームを含め合計 10 枚までです。
array<string>
編集または延長する動画の配列。現在は最大 1 本で、長さは 10 秒以下である必要があります。公開アクセス可能な HTTP/HTTPS 動画の直接 URL のみ対応します。YouTube リンクは対応していません。
video_urlsextend_from_task_id は相互排他です。いずれか一方のみ指定してください。
object
生成目的を明示するための追加パラメータオブジェクトです。
開始・終了フレーム補間では、モデルがタスクタイプを自動推論し、プラットフォームは metadata.task を渡しません。
string
前回の生成タスクのローカル task_id。会話形式の編集や追加延長に使用し、前回の動画を再アップロードする必要はありません。参照するタスクは現在のユーザーに属し、成功済みの Gemini Omni モデルタスクである必要があります。
extend_from_task_idvideo_urls は相互排他です。いずれか一方のみ指定してください。
このモデルには duration パラメータがありません。1 回の出力時間は内容に応じてモデルが自動決定し、通常は 3~10 秒です。テンポを制御するには、prompt に自然言語または時間範囲で記述してください。

レスポンス

integer
レスポンスステータスコード。成功時は 200 です。
array
タスクの配列を返します。

タスク結果の照会

動画生成は非同期タスクです。送信後に返される task_id を使い、タスク状態の取得 API で進捗と結果を照会します。
cURL
5~10 秒ごとにポーリングし、状態が completed または failed になったら停止してください。クライアント全体のタイムアウトは 10 分を推奨します。

成功結果の例

使用例

使用例 1:テキストから動画(4K)

使用例 2:開始・終了フレーム補間

使用例 3:複数被写体の参照

使用例 4:画像ロールで開始・終了フレームを指定

使用例 5:動画編集

動画編集には短く明確なプロンプトを推奨します。一部分だけを変更する場合は、他の部分の一貫性を保つため Keep everything else the same を追加してください。

使用例 6:会話形式の延長