はじめに
video_url、変更点を絞った編集指示、出力解像度を送信します。長さやアスペクト比を設定せずに、既存の映像を変更できます。
| 項目 | 値 |
|---|---|
| 入力 | 動画 |
| 出力 | 動画 |
| 提供元 | |
| Gemini API の提供状況 | Google の発表では 2026 年 11 月 5 日から一般提供 |
| モデルコード | gemini-omni-1.2-flash |
| 生成する長さ | 3–15 秒を整数で指定。既定は 8 秒 |
| 終了フレーム指定時の長さ | 終了画像を渡す場合は 3–10 秒 |
| 編集時の長さ | 元動画の長さに従い、10 秒を超える部分はカット |
| 出力解像度 | Google の案内では 360p と 720p がネイティブ出力。1080p と 4K は Google によるアップスケール |
| 生成時のアスペクト比 | 16:9 または 9:16。既定は 16:9 |
| 映像と音声の形式 | AAC 音声トラックを含む 24 fps の MP4 |
| 参照素材 | 画像は最大 6 枚。動画は各 3 秒以内で最大 3 本 |
| 長い動画を生成する場合の参照 | Google は 11–15 秒の生成時に参照動画 1 本と案内 |
| 透かし | Google が不可視の SynthID 透かしを付与 |
| 生成動画の保存期間 | 14 日後に削除 |
主な機能とハイライト
音まで描く市場のひとこま
当社のテストでは、6 秒・720p の市場シーンで、料理人が炎の上の中華鍋で麺をあおり、指定したセリフを話しました。油のはぜる音、雨音、市場のざわめきも動きに重なりました。
船が桟橋を離れる瞬間を動かす
5 秒の桟橋の作例は、夜の静止画 1 枚から始まります。当社のテストでは、乗客が見送りに応える中、木製のスピードボートがホテルをゆっくり離れました。エンジン音と水音に、遠くのバンド演奏も加わりました。
動きの終着点を決める
開始時のスタジオ画像と終了時のポーズで、5 秒のアニメーションを導きます。当社のテストでは、カメラを固定したまま、ダンサーが穏やかなピアノに合わせて二つのポーズの間を動きました。
2 人を列車のシーンに登場させる
当社のテストでは、2 枚の人物写真から 6 秒の食堂車のシーンができました。旅行者の一人が折りたたんだメモをテーブル越しに渡し、もう一人が読んでほほえみました。列車の走行音と食器の音も流れました。
演技の舞台を湖畔へ移す
当社のテストでは、灰色のスタジオが、霧のかかる水辺の月明かりに照らされた舞台へ変わりました。ダンサーと動きは残り、背景が置き換わりました。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | はい | 映像の変更を説明する短い指示が必須です。Google は単純な文章にし、最後に「Keep everything else the same.」を加えることを推奨しています。 1 文字以上 · 20000 文字以内 |
video_url | はい | 元クリップの URL は必須です。出力は元動画の長さに従い、10 秒を超える場合は 10 秒でカットされます。 1 文字以上 |
resolution | いいえ | 360p、720p（既定）、1080p、4K を使えます。Google の案内では 360p/720p がネイティブ出力で、1080p と 4K は Google によるアップスケールのため単価が高くなります。 |
料金
編集は元動画の秒数の端数を切り上げ、最低 3 秒、最大 10 秒として課金します。単価は解像度で決まり、生成の単価より高くなります。10 秒を超える元動画は 10 秒でカットされます。失敗または拒否された編集には料金がかかりません。
| 仕様 | 料金 |
|---|---|
| $0.0576 / 秒 |
| $0.1248 / 秒 |
| $0.1752 / 秒 |
| $0.3264 / 秒 |
ユースケース
セリフのある市場の短いシーン
料理人、一つの動作、引用符で囲んだ短いセリフを書き、油のはぜる音や雨の市場の環境音も指定してください。
ホテルへの到着や出発
開始フレームに桟橋の画像を使って船の出発を描き、最後の構図が決まっている場合は終了画像も追加してください。
同じキャラクターの新たな場面
人物写真を参照し、設定済みの 2 人を夕暮れの食堂車などの新しい場所に登場させてください。
演技に別の舞台を用意
動画編集で、撮影済みの動きを残しながら、スタジオを湖畔の風景に変えるよう指示してください。
プロンプトガイドと実践のヒント
手元の素材に合うエンドポイントを選ぶ
新しいシーンなら文章、静止画を動かすなら開始フレーム、見た目を指定するなら参照素材、部分的な変更なら元動画から始めてください。
シーンの構成をはっきり伝える
Google によると、指定がなければ複数のショットが作られることがあります。ワンテイクにしたい場合は「no scene cuts」を加え、話してほしいセリフは引用符で囲んでください。
参照素材ごとの役割を指定する
「Image 2 の場所を使う」「Video 1 のように動く」と書き、アップロードした各素材の用途をプロンプトで伝えてください。
解像度を上げる前に小さい下書きを確認する
提供中で最も低い単価の 360p でアイデアを試してください。1080p と 4K は Google がアップスケールするため、料金が高くなります。
編集指示は変更点を絞る
Google は、単純な変更指示の後に「Keep everything else the same.」を加えることを推奨しています。編集では 10 秒でカットされるため、送信前に元動画の長さを確認してください。
概要
Gemini Omni 1.2 Flash の動画編集は、手元にある映像から始まります。video_url、必須の prompt、出力解像度を渡してください。当社のテストでは、灰色のスタジオを月明かりの湖畔の舞台に変更すると、ダンサーと動きが保たれたまま背景が置き換わりました。
編集後の長さは元動画に従い、10 秒を超える映像はカットされます。当社のテストでは、12 秒の元動画から 10.03 秒の結果が生成されました。編集には長さやアスペクト比の項目がありません。課金は元動画の秒数の端数を切り上げ、最低 3 秒、最大 10 秒とします。単価は選んだ解像度で決まり、生成より高い編集用の単価が適用されます。
主な機能と特徴
- 既存の動画に対し、文章で指定した映像の変更を適用できます。
- 元動画の長さに従い、長い映像は 10 秒でカットします。
- ネイティブ出力の 360p または 720p と、より高い単価で Google がアップスケールする 1080p/4K を選べます。
- AAC 音声トラック付きの 24 fps の MP4 が返ります。
- 変更箇所以外を維持するという Google の推奨に従い、指示の範囲を絞れます。
活用例
- 灰色のリハーサルスタジオを、月明かりに照らされた湖畔の舞台へ置き換えられます。
- 撮影済みのダンスの動きを残すよう求めながら、霧のある背景を試せます。
- 既存の短い演技映像で異なる背景を試し、使うバージョンを選べます。
プロンプトの書き方とコツ
- 単純な編集指示についての Google の案内に従い、「スタジオを湖畔の舞台に変える」など、一つの変更から始めてください。
- 新しい背景の方向性が伝わるように、「水面に薄い霧」など具体的な見た目を説明してください。
- 変更範囲を絞るため、Google が勧める「Keep everything else the same.」で指示を締めくくってください。
- 演技が引き継がれているかを確認する際は、「元の動きを維持する」など、残す要素を指定してください。
- 「このシーンを月明かりに変える」と指示しても、先頭の 10 秒より後はカットされます。アップロード前に使いたい区間を用意してください。
API クイックスタート
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "google/gemini-omni-1.2-flash/video-edit",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p",
"video_url": "https://example.com/reference.mp4"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
認証、完全なスキーマ、ポーリング、エラー処理は API リファレンスを参照してください。
