GEMINI LABEN
ROBOTICS — 8月31日に停止した ER 1.6 preview には後継があります。Gemini Robotics ER 2 が公開プレビュー中で、通常版とストリーミング版の2種類が提供されていますVIDEO — ER 2 の成功・失敗判定は静止画ではなく生の映像フィード上で動きます。こぼれ・滑り・位置ずれのような、実行の途中で起きる失敗を捉えられる設計ですDEADLINE — 次の期限は9月30日、gemini-omni-flash-preview の廃止です。移行先は8月27日に GA になった gemini-omni-1.1-flash で、残り4週間を切りましたAPIKEY — 残りの標準 API キーは、制限付きのものも含めて9月中に全面停止します。移行先は Google Cloud サービスアカウントに紐付く auth キー形式ですPRICE — Gemini 3.7 Flash の導入価格 $0.75/$3.75 per 1M は12月31日までです。2027年1月1日から $1.50/$7.50 になるため、年を跨ぐ見積もりは2本立てが要りますAUDIO — Gemini 3.5 Transcribe は85言語以上の言語検出、話者ダイアライゼーション、単語単位タイムスタンプ、最大1,000語のカスタム語彙バイアスに対応していますROBOTICS — 8月31日に停止した ER 1.6 preview には後継があります。Gemini Robotics ER 2 が公開プレビュー中で、通常版とストリーミング版の2種類が提供されていますVIDEO — ER 2 の成功・失敗判定は静止画ではなく生の映像フィード上で動きます。こぼれ・滑り・位置ずれのような、実行の途中で起きる失敗を捉えられる設計ですDEADLINE — 次の期限は9月30日、gemini-omni-flash-preview の廃止です。移行先は8月27日に GA になった gemini-omni-1.1-flash で、残り4週間を切りましたAPIKEY — 残りの標準 API キーは、制限付きのものも含めて9月中に全面停止します。移行先は Google Cloud サービスアカウントに紐付く auth キー形式ですPRICE — Gemini 3.7 Flash の導入価格 $0.75/$3.75 per 1M は12月31日までです。2027年1月1日から $1.50/$7.50 になるため、年を跨ぐ見積もりは2本立てが要りますAUDIO — Gemini 3.5 Transcribe は85言語以上の言語検出、話者ダイアライゼーション、単語単位タイムスタンプ、最大1,000語のカスタム語彙バイアスに対応しています
記事一覧/API / SDK
API / SDK/2026-06-21上級

Gemini API モデル非推奨・移行エラーの対処法

Gemini API のモデルが非推奨(deprecated)になったときの移行手順をまとめました。モデルのライフサイクルと非推奨通知の確認方法、実際の移行手順、移行時に出やすいエラーへの対処、フォールバック実装による安全な移行戦略まで解説します。

Gemini API228モデル移行12非推奨2トラブルシューティング31

プレミアム記事

取り組みの背景

Gemini API を使ってアプリケーションやサービスを開発していると、利用しているモデルが「非推奨(deprecated)」として通知されることがあります。Google が新しいモデルをリリースし、古いモデルのサポート期限が近づく際に発生する現象です。

この通知を受け取った時、多くの開発者は以下のような不安を感じます。

  • どのモデルに移行すればいいのか
  • 移行時に既存のコードはどう変わるのか
  • 互換性が失われるのではないか
  • 移行中にエラーが発生したらどうするか

このガイドでは、Gemini API のモデルライフサイクルを理解した上で、安全かつ効率的に新しいモデルへ移行するための実践的な方法を解説します。


Gemini API モデルのライフサイクル

モデルの3つの段階

Gemini API のモデルは、以下の3つの段階を経ます。

1. 標準サポート段階(General Availability)

新しいモデルがリリースされ、本番環境での利用が推奨される状態です。この段階では、Google が定期的に更新や改善を提供します。

2. 非推奨予告段階(Deprecated)

Google がモデルの終了予定日を発表した段階です。「このモデルは2025年6月30日に非推奨になります」という通知が届きます。重要な点は、この段階でもモデルは完全に動作します。移行を急ぐ必要はありませんが、計画的に新しいモデルへの移行準備を始めるべきタイミングです。

3. 廃止段階(Sunset / End of Life)

指定された日付に達すると、モデルは API を通じて利用不可能になります。この日付以降、そのモデルを指定した API 呼び出しはエラーで返されます。

非推奨通知を受け取ったら何をするか

Google からメールで非推奨通知を受け取った場合、やるべきことは3つです。

  1. 通知内容を確認する:どのモデルが非推奨になるのか、いつまで利用できるのかを確認します
  2. 互換性を調査する:新しいモデルの仕様を確認し、既存コードとの互換性を確認します
  3. 移行計画を立てる:廃止日までに段階的に移行するタイムラインを決めます

ここまでお読みいただきありがとうございます。

この記事の続きを読む

この先には、実装コードやベンチマーク結果など、実務でお役に立てる内容をご用意しています。このサイトは広告を掲載しておらず、サーバーや開発にかかる費用はメンバーの皆様のご支援で成り立っています。もしお役に立てていましたら、ご支援いただけますと大変ありがたいです。

この記事で得られること
シャットダウン日が決まった期限つき非推奨を、CI で機械的に検知する依存棚卸しスクリプト
モデル名を設定モジュールへ集約し、移行のたびの修正を1ファイルに収める設計
通知頼み・手動棚卸し・CI 自動化の3パターンを停止リスクで比較した運用判断軸
Stripe による安全な決済 · いつでもキャンセル可能

この記事を購入する

この先の内容をすべてお読みいただけます。一度のご購入で、いつでも何度でもアクセスできます。このサイトは広告を掲載しておらず、皆さまのご支援がサーバー費用などの運営を支えています。

または
メンバーシップなら全記事が読み放題 →
シェア

お読みいただきありがとうございます

Gemini Lab は広告なしで運営しており、サーバー費用などの運営コストはメンバーシップのご支援で賄っています。実装コード・ベンチマーク・本番設計パターンなど、実務でお役立ていただける記事を毎日更新しています。もし読んでよかったと感じていただけましたら、ぜひご覧ください。

  • コピー&ペーストで使える実装コード付き
  • 毎日新しい上級ガイドを追加
  • ¥580/月 または ¥2,480 の永久アクセス
メンバーシップを見る →

関連記事

API / SDK2026-08-27
temperature が効いているかを測るより渡した値を記録する方が先です
非推奨になったサンプリングパラメータは 200 が返るまま無視されます。grep と AST が取りこぼした箇所を実行時に拾い、設定の組み立て元まで記録して CI の合否に変えるまでを、実際に動かした結果とともにまとめます。
API / SDK2026-08-17
generated_images が消えたあとの受け取り方 — 戻り値から画像ファイルになるまでの3つの分岐
generate_content へ書き換えたあと、保存の行で落ちるのは戻り値の形が変わっているからです。画像 part が0件のとき・枚数が揺れるとき・拡張子を決めるときの3分岐と、そのまま使える受け取り関数をまとめます。
API / SDK2026-08-15
generate_images は2027年まで残ります。それでも8月17日に画像生成は止まります
google-genai 2.18.1 には generate_images がまだ残っており、SDK の非推奨メッセージが指す期限は2027年です。一方で imagen-4.0 系のモデルは8月17日に止まります。2つの期限の違いと、手元で確認できること・できないことを実測で整理しました。
📚RECOMMENDED BOOKS
大規模言語モデル入門
山田育矢
LLM開発
生成AIプロンプトエンジニアリング入門
我妻幸長
プロンプト
Claude CodeによるAI駆動開発入門
平川知秀
AI駆動開発
※ アフィリエイトリンクを含みます
もっと見る →