目次
Googleは2026年11月2日、Gemini の安定版モデルgemini-2.5-proとgemini-2.5-flashを非推奨にしました。両モデルは12月1日以降、同じモデルIDへリクエストしても、それぞれgemini-3.8-flashとgemini-3.5-flash-liteへ自動的にルーティングされ、移行先の料金が適用されます。対象者が今すべきことは、モデル名を置き換えるだけではありません。、思考設定、会話履歴、出力品質、費用を移行先ごとに検証し、12月1日より前に明示的に切り替えることです。
この記事は最新ニュースと移行実務の解説です。Googleのリリースノート、非推奨モデル一覧、移行ガイドを2026年11月3日に確認し、Webアプリやバッチ処理で2.5系を利用している開発者向けに、影響と作業順を整理します。
スポンサーリンク
12月1日に変わること
| 現在のモデルID | 12月1日以降のルーティング先 | 先に確かめる項目 |
|---|---|---|
gemini-2.5-pro | gemini-3.8-flash | 複雑な推論、長文生成、ツール連鎖、思考設定 |
gemini-2.5-flash | gemini-3.5-flash-lite | 品質、レイテンシー、大量処理、メディア解析 |
gemini-2.5-flash-lite | 変更なし | 今回の非推奨対象ではない |
Google AI Studioでは2.5 Proと2.5 Flashを新たに選択できず、APIアクセスも過去に実際に利用したユーザーへ限定されています。12月1日は単にモデルが停止してエラーになる日ではなく、旧モデルIDが別モデルへ自動転送される日です。そのため、監視がステータスだけなら変更を見逃す可能性があります。リクエスト自体は成功しても、回答傾向、ツール呼び出しの形式、処理時間、請求単価が変わり得ます。
自動ルーティングは移行猶予ではなく、互換性を保証する仕組みでもありません。Googleは両方の移行先について破壊的変更の確認を求めています。アプリ側でモデルIDを明示的に更新すれば、変更日とリリースを管理でき、ログにも実際の選択を残せます。暗黙の切り替えに任せるより、段階的なトラフィック移行と判断が容易です。
同じ代替先にまとめない理由
2.5 Proの移行先は3.8 Flashです。Googleは3.8 Flashを長時間のソフトウェア開発、エージェント、複雑な企業ワークフロー向けと説明しています。入力コンテキストは100万トークン、最大出力は64Kトークンで、思考レベルはlow、medium、highを選べます。従来Proを難しいコードレビュー、複数資料の統合、長いツール連鎖に使っていた場合はこちらが検証の起点です。
一方、2.5 Flashは3.5 Flash-Liteへ移ります。3.5 Flash-Liteは高スループット、低コスト、低レイテンシーの処理を想定し、文書抽出やサブエージェント向けとされています。入力はテキスト、画像、動画、音声、PDFに対応し、100万トークン級の入力と65Kトークン級の出力を扱えます。ただし、旧Flashで品質寄りの処理をしていたからといって、Flash-Liteで同じ精度になるとは限りません。分類、抽出、要約、の回答生成を同じ評価セットで別々に比較する必要があります。
判断基準はモデル名の序列ではなく、処理の失敗コストです。誤りを人が確認できる大量抽出ではFlash-Liteが候補になります。誤ったツール選択が後続処理を変えるエージェント、長い設計判断、複数制約を持つコード生成では3.8 Flashを先に評価します。ひとつのを全機能で共有している場合、この機会に用途別のモデル設定へ分けると移行後の調整がしやすくなります。
スポンサーリンク
リポジトリと実行環境から旧IDを洗い出す
最初の作業はコード検索だけでは不十分です。モデルIDはソースコード、環境変数、コンテナの、変数、管理画面、ジョブ定義、評価スクリプト、キーに分散します。まず次のように文字列を検索し、見つかった場所を「本番呼び出し」「評価」「テスト」「文書」に分類します。
rg -n --hidden \
'gemini-2\.5-(pro|flash)([^-]|$)' \
--glob '!node_modules/**' \
--glob '!.git/**' .検索式ではgemini-2.5-flash-liteを誤って対象に含めないよう注意します。次に、実行時ログへ保存されたモデルID、APIレスポンスの利用量、ジョブ別の呼び出し件数を確認します。モデル名をエイリアスや独自名で包んでいる場合は、設定の解決後に実際のIDを出力する診断を追加します。APIゲートウェイやルーターを使う構成では、ルーティング規則と先も対象です。
棚卸し結果には、機能名、旧モデル、代替候補、API方式、ツール利用、メディア入力、ピーク時の呼び出し量、品質評価の所有者を記録します。これにより「どこを直すか」だけでなく「何を合格とするか」が決まります。関連して、継続評価の基本はAIの改善を勘で判断しないための評価データと回帰テストでも整理しています。
破壊的変更を先に直す
Gemini 3系ではthinking_budgetから文字列のthinking_levelへ切り替わります。3.8 Flashではminimalを使えないため、low、medium、highから選びます。移行直後は既定のmediumを基準にし、難しい評価項目だけhighと比較すると、品質と費用の差を把握しやすくなります。予算値をそのまま新しい設定へ変換できると考えず、タスク単位で再評価します。
temperature、top_p、top_kなどのサンプリング指定は削除し、まず既定値で評価します。candidate_countはGemini 3系でサポートされません。モデルの途中出力を会話履歴へ差し込むprefilled model turnも移行対象です。設定値がの型で弾かれなくても、無視や検証エラーが起きないか統合テストで確認します。
ツール呼び出しでは、FunctionResponseのcall_idとnameを直前の呼び出しに一致させます。Gemini 3系は関数呼び出しに付くthought_signatureの扱いも厳格です。公式Google Gen AI SDKでモデル応答全体を履歴へ追加する構成なら自動処理されます。RESTで履歴を手作業で組み立てる場合や、応答パーツを独自形式へ変換する場合は、署名を受け取った位置のまま次のターンへ返します。並列呼び出しや複数段のツール連鎖を必ずテストしてください。
マルチモーダルな関数応答は画像や音声をFunctionResponseの中へ入れます。関数結果に追加指示を含める場合は、応答テキスト内で二つの改行を挟みます。PDFや動画を使う処理は、モデル変更によるトークン量と解析精度の両方を確認します。2.5で利用していた画像セグメンテーションはGemini 3系で未対応とされているため、その用途は別モデルや処理方式の検討が必要です。
スポンサーリンク
段階移行の手順
- 評価データを固定する：正常例だけでなく、長い入力、空の項目、ツール失敗、並列呼び出し、PDFや画像を含む境界例を用意します。
- 移行先を明示する：Pro系処理は3.8 Flash、Flash系処理は3.5 Flash-Liteを初期候補にし、設定を用途別に分けます。
- SDKとリクエストを更新する：思考設定、非対応パラメータ、関数応答、thought signature、会話履歴を修正します。
- 影のリクエストで比較する：利用規約とデータ処理条件を確認したうえで、同じ入力を新モデルへ送り、回答は本番へ返さず評価します。
- 少量の本番トラフィックを切り替える：機能単位で比率を上げ、品質、エラー率、p95レイテンシー、入力・出力トークン、ツール回数を比較します。
- 旧IDを停止する：12月1日より前に明示的な新IDへ統一し、旧IDがログへ現れたら検知するアラートを設定します。
評価では完全一致率だけを使わず、用途に合う指標を選びます。抽出なら必須フィールドの欠落率と型エラー、分類ならクラス別の再現率、生成なら人手評価と禁止事項、エージェントならツール選択の正しさ、完了率、不要な呼び出し数を測ります。構造化出力とツール呼び出しの責務分担はAIをWeb機能へ組み込む設計も参考になります。
切り替えフラグはモデルIDと一緒に管理し、即時に旧設定へ戻せる期間を設けます。ただし12月1日以降は旧IDへ戻しても旧モデルが使われるわけではありません。ロールバック先は検証済みの別モデルまたは旧アプリ版とし、モデルの自動転送を復旧策に数えないでください。評価結果と承認者、切り替え日時を変更記録へ残すと、品質低下や費用変化が起きたときに判断を再現できます。
自動ルーティング後も監視する
12月1日を越えたら、旧モデルIDへの呼び出し件数をゼロにできたか確認します。成功率だけでなく、移行前後の費用、トークン量、待ち時間、ツールの再試行数を同じダッシュボードで比較します。キャッシュキーへモデルIDを含めていない構成では、旧モデルの結果が新モデルの評価へ混ざらないよう世代を分けます。や評価データの版も一緒に保存し、モデル変更とプロンプト変更を同時に行わないことが原因切り分けの基本です。
今回の期限は2026年12月1日です。実務上の完了条件は、文字列の置換ではなく、旧IDの利用がゼロになり、新モデルで主要な回帰テストが通り、料金とレイテンシーの許容範囲を確認できた状態です。自動ルーティングが始まってから問題を探すのではなく、11月中に機能ごとの移行判断を終えるのが安全です。
