gemini-omni-flash-video-edit インターフェース
Gemini Omni Flash
Gemini Omni Flash 動画編集
- Gemini Omni Flash (gemini-omni-flash-video-edit) モデルは動画編集モードに対応し、1本の入力動画とテキストプロンプトをもとに編集後の動画を生成します
- 動画入力:
video_urlsで渡します。動画は1本のみ対応で、入力動画の長さは10秒以内です - 編集指示:
promptで期待する編集効果を記述します(例:光の調整、スタイルの変更など) - ネイティブ音声: モデルが映像に同期した音声を自動生成し、追加パラメータは不要です
- パラメータの制約: 動画編集モードでは
durationとaspect_ratioに対応せず、出力は入力動画に従います - ネガティブ指定:
promptに直接記述します(例:No dialogue)。本モデルは独立したネガティブプロンプト用のパラメータを提供しません - 非同期処理モードです。返却されたタスクIDを使って 照会 してください
- 生成された動画リンクの有効期限は24時間です。お早めに保存してください
POST
gemini-omni-flash-video-edit インターフェース
承認
##すべてのインターフェースはBearer Tokenによる認証が必要です##
API Key の取得:
API Key 管理ページ にアクセスして API Key を取得してください
利用時はリクエストヘッダーに以下を追加します:
Authorization: Bearer YOUR_API_KEYボディ
application/json
モデル名。gemini-omni-flash-video-edit で固定です
利用可能なオプション:
gemini-omni-flash-video-edit 例:
"gemini-omni-flash-video-edit"
動画編集のテキストプロンプト。期待する編集効果を記述します。日本語・英語に対応します
使用のヒント:
- 変更したい要素と保持したい部分を記述します(例:「光をより暖かくし、それ以外はそのまま保つ」)
- ネガティブな要件はプロンプトに直接記述します(例:
No dialogue、文字を出さない)。本モデルは独立したネガティブプロンプト用のパラメータを提供しません
例:
"画面の光をより暖かくし、それ以外はそのまま保つ"
編集対象の動画の配列。1本のみ対応です
入力要件:
- 現在は HTTP/HTTPS 動画 URL のみ対応
- フォーマット:mp4
- 長さ:
10秒以内
Required array length:
1 element例:
["https://example.com/source.mp4"]タスク完了後のHTTPSコールバックアドレス
コールバックのタイミング:
- タスクの完了(completed)、失敗(failed)、キャンセル(cancelled)時にトリガーされます
- 課金確定後に送信されます
セキュリティ制限:
- HTTPSプロトコルのみ対応
- 内部ネットワークIPアドレス(127.0.0.1、10.x.x.x、172.16-31.x.x、192.168.x.x など)へのコールバックは禁止
- URLの長さは
2048文字以内
コールバックの仕組み:
- タイムアウト時間:
10秒 - 失敗後は最大
3回まで再試行します(失敗後それぞれ1秒/2秒/4秒後に再試行します) - コールバックのレスポンスボディの形式はタスク照会インターフェースの返却形式と同一です
- コールバックアドレスが2xxステータスコードを返した場合は成功とみなし、それ以外のステータスコードは再試行をトリガーします
例:
"https://your-domain.com/webhooks/video-task-completed"
レスポンス
動画タスクの作成に成功しました
タスク作成のタイムスタンプ
例:
1757169743
タスクID
例:
"task-unified-1757169743-7cvnl5zw"
実際に使用されたモデル名
例:
"gemini-omni-flash-video-edit"
タスクの具体的な種別
利用可能なオプション:
video.generation.task タスクの進捗率 (0-100)
必須範囲:
0 <= x <= 100例:
0
タスクの状態
利用可能なオプション:
pending, processing, completed, failed 例:
"pending"
動画タスクの詳細情報
タスクの出力タイプ
利用可能なオプション:
text, image, audio, video 例:
"video"
使用量と課金情報