Skip to main content
POST

認証

string
必須
すべてのリクエストで Bearer Token 認証が必要です。API Key の取得:API Key 管理ページ にアクセスして API Key を取得してください。リクエスト時に次のヘッダーを追加します:

リクエストパラメータ

string
必須
動画生成モデル名。固定値は gemini-omni-flash-preview です。
string
必須
テキスト指示。テキストから動画の場合はシーンの説明、画像 / 動画から動画の場合は動作 / スタイル / 編集の指示です。
prompt と参照素材(image_urls / video_urls)は 少なくともいずれか一方 を指定してください。
array<string>
参照画像。最大 16 枚。各項目は http(s):// URL です。JPEG / PNG に対応しています。複数の被写体(例:「猫 + 毛糸玉」)の場合は複数枚を指定し、それらがどのように相互作用するかを prompt で記述できます。
array<string>
参照 / 編集対象の動画。最大 1 本(複数動画の参照には非対応)。http(s):// の直リンク、または data:video/...を指定できます。
  • 参照動画は 1 ~ 24 秒。公式では 3 秒以下 を推奨しています。
  • video_urlsextend_from_task_id相互排他 です。いずれか一方のみを指定でき、同時に指定することはできません。
string
デフォルト:"16:9"
動画のアスペクト比。出力画面の向きを実際に制御します。
video_urls を指定すると、aspect_ratio パラメータは無効になります。
対応値:
  • 16:9 - 横向き(デフォルト)
  • 9:16 - 縦向き
その他の値は 16:9 として扱われます。
string
デフォルト:"720p"
動画解像度。現在は 720p のみ対応しています。
string
直前のタスク ID:前回の生成タスクの ** task_id** を指定します。
extend_from_task_idvideo_urls相互排他 です。いずれか一方のみを指定でき、同時に指定することはできません。

レスポンス

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

タスク結果の照会

動画生成は非同期タスクです。送信後に task_id が返されます。タスクステータス取得 API を使用して生成の進捗と結果を照会します。

成功結果の例

ユースケース

シナリオ 1:テキストから動画

シナリオ 2:画像から動画

シナリオ 3:動画から動画