Gemini Omni 1.2 Flash

2026-11-07 に確認した APIMaster の gemini-omni-1.2-flash ゲートウェイ仕様です。Google Interactions のネイティブ API ではなく、1.1 の Official/Ext 仕様は適用されません。

OpenAPI 3.1 · Gemini Omni 1.2 Flash

エンドポイントと認証

公開ルートはチャネル 335 です。Authorization: Bearer YOUR_API_KEY と Content-Type: application/json を使用します。通常のモデル・グループ権限、残高、ルートの稼働状況が適用されます。追加の顧客許可リストは公開されていません。モデル ID にチャネル番号を追加しないでください。1.2 専用の Ext ルートはありません。モデル一覧への掲載は Google の全機能の公開を意味しません。

• POST https://apimaster.ai/v1/videos
• POST https://apimaster.ai/v1/videos/generations
• GET https://apimaster.ai/v1/videos/{task_id}
• GET https://apimaster.ai/v1/videos/{task_id}/content
• GET https://apimaster.ai/v1/video-submissions/by-key
• GET https://apimaster.ai/api/log/token

パラメーターと制限

フィールド	型	仕様
model	string	正確な公開モデル ID。
prompt	string	全モードで空白以外の指示が必須。編集・継続時も必要です。生成する音声の指示もここに記述します。
duration	integer	既定値 10。通常生成は整数 3–15 秒、始点・終点補間と延長の新しい区間は 3–10 秒。編集では無視します。
seconds	integer / string	duration の互換別名。整数または整数文字列。両方ある場合は duration が優先。
resolution	string	360p、720p（既定）、1080p、4k。大文字小文字を区別せず、2160p は 4k。1080p/4k はアップスケール出力。
aspect_ratio	string	16:9（既定）または 9:16。それ以外の文字列は現在 16:9 に正規化します。
ratio	string	古い縦横比の別名。解像度ではありません。aspect_ratio を推奨。
size	string	縦横比の別名。優先順位は aspect_ratio、ratio、size。
image_urls	string[]	公開 HTTP(S) 画像 URL の配列。通常、1 枚は開始画像、複数枚は参照画像。
first_frame_image	string	開始フレームの公開 URL。
last_frame_image	string	終了フレーム。first_frame_image が必須。出力の縦横比に合わせます。
image_with_roles	object[]	明示的なフレーム指定との併用不可。各要素に url と空でない role。first_frame/last_frame 以外は参照画像。終了には開始が必要。
video_urls	string[]	最大 1 本、15 秒以下の公開入力動画。既定では編集。
omni_reference_task_type	string	auto、edit、extend、reference、text_to_video、image_to_video、reference_to_video。延長には extend の明示が必要。
extend_from_task_id	string	同一アカウント・同一モデルの完了済み公開タスク ID。video_urls と排他。元のチャネルとアカウントが利用可能であること。Google interaction ID ではありません。

画像とフレームは合計 10 枚まで。image_with_roles と明示的なフレームフィールドは排他です。上流の推奨は人物 2 人まで、各人物 3 枚。公開の直接 HTTP(S) URL のみで、Base64、Data URL、multipart は未対応。PNG/JPEG と MP4 を検証済み。長さ検査は MP4/MOV 互換メディアを最大 100 MiB 読みますが、これは上流の保証するアップロード上限ではありません。画像ごとのサイズ上限や全コーデックの仕様は未確定です。

音声参照、audio_urls、Google interaction/conversation 状態、metadata、generation_type、system_prompt、temperature、negative_prompt、seed、fps、n は未対応。否定指示と生成音声の要望は prompt に書きます。完了した公開タスクを連鎖できますが、入力動画は毎回 15 秒以内で、Google ネイティブ会話ではありません。未知の最上位フィールドは拒否します。

実行しない JSON サンプル

以下は実行しない JSON 本文です。example.com とタスク ID を置き換えてください。新しい処理ごとに新しいキーを使い、再試行は同じキー・本文を維持します。次の継続には完了した子タスクの公開 ID を使用します。音声入力の有効な例はありません。

1. text_to_video

{"model":"gemini-omni-1.2-flash","prompt":"A blue glass sphere rolls slowly across a plain gray table.","duration":3,"resolution":"360p","aspect_ratio":"16:9"}

2. reference_to_video

{"model":"gemini-omni-1.2-flash","prompt":"Animate these geometric references while preserving their shapes and colors.","image_urls":["https://example.com/reference-a.png","https://example.com/reference-b.png"],"omni_reference_task_type":"reference","duration":6,"resolution":"720p","aspect_ratio":"16:9"}

3. first_frame_image / last_frame_image

{"model":"gemini-omni-1.2-flash","prompt":"Make a smooth transition from the first view to the last view.","first_frame_image":"https://example.com/first.png","last_frame_image":"https://example.com/last.png","duration":6,"resolution":"720p","aspect_ratio":"16:9"}

4. image_with_roles

{"model":"gemini-omni-1.2-flash","prompt":"Make a smooth transition between these views.","image_with_roles":[{"url":"https://example.com/first.png","role":"first_frame"},{"url":"https://example.com/last.png","role":"last_frame"}],"duration":6,"resolution":"720p"}

5. edit / video_urls

{"model":"gemini-omni-1.2-flash","prompt":"Change the lighting to sunset while preserving the scene.","video_urls":["https://example.com/input.mp4"],"omni_reference_task_type":"edit","resolution":"720p"}

6. extend / video_urls

{"model":"gemini-omni-1.2-flash","prompt":"Continue the camera movement for three more seconds.","video_urls":["https://example.com/input.mp4"],"omni_reference_task_type":"extend","duration":3,"resolution":"720p"}

7. extend / extend_from_task_id

{"model":"gemini-omni-1.2-flash","prompt":"Continue the previous scene with a gentle camera pan.","extend_from_task_id":"task_YOUR_COMPLETED_TASK","omni_reference_task_type":"extend","duration":3,"resolution":"720p"}

8. edit / extend_from_task_id

{"model":"gemini-omni-1.2-flash","prompt":"Keep the scene but turn the blue sphere yellow.","extend_from_task_id":"task_YOUR_COMPLETED_TASK","omni_reference_task_type":"edit","resolution":"720p"}

タスクの照会とダウンロード

最初の受付 POST は HTTP 200、queued を返します。5–10 秒間隔で照会し、queued → in_progress → completed/failed、および一時的な unknown を扱います。url と metadata.url は認証付きプロキシで、ダウンロードにも Bearer が必要です。生成失敗は通常 HTTP 200 と error.code=generation_failed、機密情報を除いたメッセージ。送信エラーは 4xx/5xx。タイムアウトや 5xx は未受付の証明になりません。以下の応答は ID と日時を置換しています。

{"id":"task_REDACTED_EXAMPLE","task_id":"task_REDACTED_EXAMPLE","object":"video","model":"gemini-omni-1.2-flash","status":"queued"}

{"id":"task_REDACTED_COMPLETED_EXAMPLE","task_id":"task_REDACTED_COMPLETED_EXAMPLE","object":"video","model":"gemini-omni-1.2-flash","status":"completed","progress":100,"created_at":1793966808,"url":"https://apimaster.ai/v1/videos/task_REDACTED_COMPLETED_EXAMPLE/content","metadata":{"url":"https://apimaster.ai/v1/videos/task_REDACTED_COMPLETED_EXAMPLE/content"}}

{"id":"task_REDACTED_FAILED_EXAMPLE","task_id":"task_REDACTED_FAILED_EXAMPLE","object":"video","model":"gemini-omni-1.2-flash","status":"failed","progress":100,"created_at":1793966808,"error":{"code":"generation_failed","message":"The generation request failed."}}

使用量・最終料金・返金

タスク応答には usage、モダリティ内訳、USD の保証はありません。照合後の最終顧客請求額は消費ログの other.final_amount_usd。GET /api/log/token は同じ API キーの直近の限定件数で、請求書の完全な履歴ではありません。GET /api/log/self はアカウント認証が必要です。other を JSON として解析し other.task_id を照合します。実使用時は prompt_tokens、completion_tokens、other.input_tokens、text_output_tokens、video_output_tokens、token_usage_source、retail_token_prices、group_ratio が得られる場合があります。入力は合計で、テキスト・画像・動画別の内訳は保証しません。

2026-11-07 のチャネル 335 基本販売単価は 100 万トークン当たり入力 $1.32、テキスト出力 $7.92、動画出力 $10.56。アカウント倍率適用前です。最新カードを確認してください。概算を予約し、固定した単価と実使用量で追加請求または返金します。確定した生成失敗は予約を返金しますが、受付不明では即時返金を保証しません。500,000 quota = USD 1。予約は最終請求額ではなく、最終額と調整額を重複加算しないでください。過去の検証例は入力 39、テキスト 0、動画 5793、$0.064286。固定見積もりではありません。

USD = (input_tokens × input_rate
     + text_output_tokens × text_output_rate
     + video_output_tokens × video_output_rate) / 1,000,000

延長では新しい区間の動画出力と参照動画の入力を課金します。結合ファイル全体を新規出力として課金しません。検証例は 3 秒に 3 秒延長、約 6 秒のファイルで新規出力は約 3 秒。生成音声は動画出力に含みます。テキスト内訳がない場合、現在のパーサーは報告された出力を動画扱いします。有効なトークン統計がなく確実な上流コスト領収があれば token_usage_source=provider_cost_receipt で精算し、架空のトークン数を作りません。両方なければ照合を継続します。全内訳や固定精算時間は保証しません。

ゲートウェイの冪等性と復旧

Idempotency-Key は空白なしの可視 ASCII 8–128 文字で、本文フィールドはありません。アカウント単位です。同じキー・要求の再送は HTTP 202 と Idempotency-Replayed:true を返し、二重生成・二重予約しません。本文、グループ、明示ルートの変更は 409 idempotency_conflict。JSON キー順は無視しますが、配列順や省略と明示的既定値の差は重要です。切断後もゲートウェイは時間制限内で元の送信と保存の完了を試みます。

{"code":200,"data":{"submission_id":"REDACTED_SUBMISSION_ID","task_id":"task_REDACTED_EXAMPLE","model":"gemini-omni-1.2-flash","status":"accepted","task_ready":true,"same_key_replay_safe":true,"new_submission_safe":false,"next_action":"query_task"}}

GET /v1/video-submissions/by-key に元のキーと Bearer を付けると領収状態だけを読みます。生成、上流検索、資金変更はしません。pending/submitting は照会を継続。accepted で task_ready=true なら task_id を照会し、未準備なら照合かサポートを待ちます。acceptance_unknown は自動再送せずキーと参照を保存。not_accepted は確定エラーを修正し、領収状態と資金状態が許す場合のみ新キーで送信。旧キーは元の結果を再生します。404 と retry_safe=false は未受付の証明ではありません。最低 30 日保持し、キーを自動再利用しません。キーなし POST の再送は新操作です。Google/APIMart ネイティブではなくゲートウェイの冪等性で、不明な元要求を再送しません。受付・資金確定済み記録は再生成・再請求なしで復旧できます。

未対応の機能と見積もり

POST /v1/videos/quote はこのモデルに未対応で、現在は Seedance 専用検証です。Omni 向けの無料・タスクなし・上流呼び出しなしの見積もり契約はなく、専用 invoice や /v1/videos/{task_id}/billing の最終請求契約もありません。上流の審査・地域制限が適用され、EEA・スイス・英国にはアップロード動画の編集・延長制限があります。以下のスキーマはゲートウェイ仕様で、上流ネイティブ例は APIMaster の ID・応答・ログを代替しません。

APIMart · Gemini Omni 1.2 Flash