先に結論|12 月 1 日に振り分けられ、課金も替わります

Google は公式の変更履歴の 2026 年 11 月 2 日付の項目で、Gemini API の gemini-2.5-pro と gemini-2.5-flash の非推奨を告知しました。2 つのモデルは、すでに AI Studio では選べません。

2026 年 12 月 1 日からは、API リクエストが別のモデルに自動で振り分けられます。課金も振替先の料金です。

  • gemini-2.5-pro は gemini-3.8-flash へ
  • gemini-2.5-flash は gemini-3.5-flash-lite へ

振り分けられるからといって、何もしなくてよいわけではありません。移行には破壊的変更が含まれます。公式の変更履歴は、function calling と thought_signature の検証、thinking_budget から thinking_level への置き換え、サンプリングパラメータの削除、prefill (あらかじめ埋めておくモデルの発話) の廃止を挙げています。

Gemini 2.5 Pro・Flash の廃止に備え、日付・振替先・直す項目・料金を整理します。日付は公式ページの表記に従い、切替時刻やタイムゾーンは明記されていません。

何が変わるか

次の表は、Google の変更履歴と非推奨ページの内容です。確認日は 2026 年 11 月 14 日です。

旧モデル振替先12 月 1 日以降の課金現在の状況
gemini-2.5-progemini-3.8-flashgemini-3.8-flash の料金AI Studio では選べない
gemini-2.5-flashgemini-3.5-flash-litegemini-3.5-flash-lite の料金AI Studio では選べない
gemini-2.5-flash-liteなし対象外追って通知があるまで API で利用できる

非推奨ページには、2.5 の 2 つのモデルへのアクセスが「過去に使ったことのあるユーザー」に限られるという記載もあります。

12 月 1 日は、非推奨ページが書く「最も早い停止日」でもあります。この日に呼び出しが止まるとは書かれていません。書かれているのは、リクエストが別のモデルに振り替わり、その料金が請求されることです。

FIXITFIXIT

振り替わるなら、コードは触らなくていいの?

DodaiDodai

いいえ。まず壊れ方から考えます。振替先は別世代のモデルで、リクエストの書き方の前提が変わっています。

直す項目

移行の手順は、振替先ごとの移行ガイドにあります。Gemini 3.8 Flash への移行ガイドと、Gemini 3.5 Flash-Lite への移行ガイドです。3.5 Flash-Lite のガイドは、サンプリングパラメータと function calling について、3.6 Flash と同じ規則を適用するよう書いています。

モデル名

呼び出し側の model 文字列を、振替先のモデル名に替えます。変更履歴は、12 月 1 日より前に model 文字列を更新するよう求めています。コード・設定ファイル・環境変数・社内ツールの設定を検索し、旧モデル名が残っている箇所を洗い出します。

rg -n "gemini-2\.5-(pro|flash)" .

gemini-2.5-flash-lite も同じ文字列に引っかかります。結果を目で見て、対象の 2 つのモデルだけを置き換えます。

思考の設定

thinking_budget は、文字列の列挙型の thinking_level に置き換えます。振替先ごとに、使える値と勧められる値が違います。

振替先移行ガイドの記載
gemini-3.8-flashminimal は使えない。low・medium (デフォルト)・high から選ぶ
gemini-3.5-flash-liteデフォルトは minimal。大量の抽出・振り分け・分類は minimal のまま。ツール呼び出しや多段の推論をするエージェントは medium か high にして、ツール実行の途中終了を防ぐ

thinking_budget で 0 を指定して思考を切っていたコードは、3.8 Flash では minimal が使えない点に注意が必要です。置き換え先は、振替先のモデルごとに決め直します。

サンプリングパラメータとターンの組み立て

3.8 Flash の移行ガイドは、次の変更を求めています。

  • temperature・top_p・top_k を削除する
  • candidate_count を削除する (Gemini 3 以降では未対応)
  • 複数ターンの会話は、サーバー側の previous_interaction_id に統一し、prefill したモデルのターンを削除する

出力の長さや形式を、サンプリングの設定で調整していた場合は、プロンプトの指示や構造化出力で表現できるかを検討します。

function calling

3.8 Flash の移行ガイドが、function calling について挙げる確認項目は次のとおりです。

  • マルチモーダルのデータは、レスポンスのペイロードの中に置く
  • インラインの指示は、二重の改行 (\n\n) で整える
  • ツール呼び出しの前にテキストがあると起きる Malformed_Function_Call のエラーは、ガイドの回避策の節に従う
  • generateContent API を使う場合、すべての FunctionResponse に call_id と name を含める

thought signature

変更履歴は thought_signature の検証を、破壊的変更の 1 つに挙げています。ただし 2 つの移行ガイドは、検証の規則を詳しく書いておらず、thought signatures の専用ページを参照するよう案内しています。

関数呼び出しを含む会話の履歴を、自前で組み立て直している実装は、特に確認が必要です。具体的な規則は、公式の thought signatures のページで確認してください。

共通の API 変更には、temperature・top_p・top_k は非推奨で無視され、将来のモデル世代では指定すると HTTP 400 になると書かれています。また、空でない model ロールのターンで終わるリクエストは、HTTP 400 になります。prefill で出力形式を制御していた場合は、システム指示や構造化出力へ置き換えてください。

料金

変更履歴は、振り分けられたリクエストが振替先の料金で課金されると書いています。移行ガイドと公式料金表に載っている単価は、次のとおりです。100 万トークンあたりの標準料金です。

モデル入力出力備考
gemini-3.8-flash0.75 ドル3.75 ドル2026 年 12 月 31 日までの導入価格
gemini-3.8-flash1.50 ドル7.50 ドル2027 年 1 月 1 日から適用される標準価格
gemini-3.5-flash-lite0.30 ドル2.50 ドル標準料金

旧モデルとの単価の差は、ここでは書きません。確認した公式ページに、旧モデルの単価との比較が載っていなかったためです。

gemini-3.8-flash は、12 月までは導入価格で、2027 年 1 月 1 日から単価が 2 倍になります。予算は標準価格で見積もり、年明けの単価上昇に備えてください。

12 月 1 日までの進め方

次の順で進めます。

  1. 旧モデル名を、コード・設定・環境変数・外部委託先のコードから洗い出す
  2. 呼び出しごとに、gemini-2.5-pro と gemini-2.5-flash のどちらを使っているかを分け、振替先を決める。振替先のままでよいかも、このとき判断する
  3. model 文字列を替え、thinking_budget を thinking_level に置き換える
  4. temperature・top_p・top_k・candidate_count と、prefill を削除する
  5. function calling を使う処理は、FunctionResponse の call_id と name、thought signature の扱いを確認する
  6. 移行先で実際にリクエストを送り、エラーの有無、出力の品質、トークンの使用量を、旧モデルの基準値と比べる
  7. 予算を、gemini-3.8-flash の標準価格で見直す

Vertex AI でモデルを呼んでいる場合は、日程が別かもしれません。今回確認したのは Gemini API と AI Studio のページだけで、Vertex AI の廃止日はそこから確認できませんでした。

FIXIT の運用|モデル廃止への備え方

AI 駆動開発のクリエイティブスタジオとして AI 機能のプロダクト開発に関わるときは、LLM のモデル名をコードの複数箇所に直接記述せず、設定の 1 か所にまとめることを勧めています。廃止の告知が出たとき、モデル名の変更箇所をまとめられるためです。

あわせて、モデルを替えたときに出力の品質を比べるための評価用の入力を、プロジェクトごとに用意することも勧めています。今回のように、振替先が別世代のモデルになる場合は、評価用の入力があるかどうかが、移行の手間を左右します。

Gemini 4 系への移行も検討する場合は、Gemini 4 Hydrogen の料金と移行項目と、Gemini 4 Carbon の料金と提供条件を参照してください。本記事は、2.5 系の自動振り分けに伴う既存コードの修正に焦点を当てています。

まとめ

12 月 1 日から、gemini-2.5-pro は gemini-3.8-flash に、gemini-2.5-flash は gemini-3.5-flash-lite に自動で振り分けられ、課金も振替先の料金になります。gemini-2.5-flash-lite は対象外です。

振り分けに任せず、期限の前に、model 文字列・thinking_level・サンプリングパラメータ・prefill・function calling を直してください。gemini-3.8-flash は 2027 年 1 月 1 日に標準価格へ上がる点も、予算に入れておく必要があります。

次の一歩は、リポジトリで旧モデル名を検索し、呼び出しの一覧を作ることです。Gemini を組み込んだ AI 機能の移行や、開発ツールの運用の見直しは、AI 開発ツール定着支援で扱っています。お困りの方は、お問い合わせからご相談ください。

出典は次のとおりです。