Gemini 2.5 Proが非推奨に：12月1日の自動振り分けと対策

12月2日にgemini-2.5-proを呼び出しても、エラーにはなりません。返ってくるのは、別のモデルによる回答です。Googleは2026年11月2日、gemini-2.5-proとgemini-2.5-flashを非推奨にしました。さらに2026年12月1日からは、Gemini Developer APIがこれらのIDをgemini-3.8-flashとgemini-3.5-flash-liteへ自動的に振り分け、移行先の料金を適用します。厄介なのは、単なるモデル名の置き換えではなく、階層の変更とパラメーターの破壊的変更を伴うことです。12月まで古い文字列を使い続けるのは、安全な移行策とはいえません。

Googleが12月1日について発表したこと

GoogleはGemini Developer APIでgemini-2.5-proとgemini-2.5-flashを非推奨にしました。両方の識別子はGoogle AI Studioのモデル選択画面から消えており、現在APIを利用できるのは、過去に各モデルを使ったことがある開発者に限られます。2026年12月1日以降もリクエスト自体は成功しますが、実行されるモデルと料金は変わります。

対応関係は、GoogleのGemini APIの非推奨化ページに記載されています。

Googleは、両方の安定版IDについて2026年12月1日を振り分け開始日としています。告知は2026年11月2日の変更履歴に記載されています。Google DeepMindのスタッフであるPatrick LoeberもPSAでこの情報を共有し、高度な統合では移行ガイドに沿った対応が必要になると注意を促しました。

今回の告知が対象とするのは、Gemini Developer APIとAI Studioだけです。Vertex AIではGemini 2.5について別の廃止スケジュールが設定されており、Google Cloudは同じモデル名について2026年10月の日付を案内しています。また、Firebase AI Logicにも独自の対応モデル一覧があります。Vertexを使っている場合は、どこでも12月1日が適用されると考えず、Cloudコンソールで確認してください。

Googleは9月18日時点では2.5を「非推奨ではない」と説明していましたが、11月2日に非推奨化しました。12月1日は確定した日付として扱うべきです。この方針転換については変更履歴を確認してください。

12月と1月、自動振り分け後の料金はいくらになるか

Gemini 2.5 Proのトラフィックは12月に安くなりますが、1月には入力料金が上がります。Gemini 2.5 Flashのテキスト処理は移行後も同じ料金で、音声入力は大幅に安くなります。以下はすべて、GoogleのGemini API料金ページに基づく有料ティアの料金で、100万トークンあたりのリスト価格です。2026年11月3日時点の情報です。モデルごとの背景は、Gemini 3.8 Flashの料金とGemini 3.5 Flash-Liteも参照してください。

Gemini 3.8 Flashはプロンプトの長さに関係なく料金帯が1つなので、200,000トークンを超える長いコンテキストほど値下げ幅が大きくなります。入力300k、出力4kの長文ドキュメント処理では、Gemini 2.5 Proが$2.50/$15.00の場合で約$0.81、12月料金のGemini 3.8 Flashが$0.75/$3.75の場合で約$0.24、1月料金の$1.50/$7.50の場合で約$0.48です。短いプロンプトで入力比率が高いチャットだけは、1月に旧料金に近い水準になります。

Flashの移行はもっと単純です。

コンテキストキャッシュ、バッチ、優先処理も同じ傾向で、テキスト料金は引き継がれ、音声料金は下がります。ただし、予算を組むうえで注意したい点があります。思考トークンは出力として課金されるうえ、移行先モデルは長いタスクで異なる数の思考トークンを出力する可能性があります。そのため、出力トークン数が同じだとは限りません。予測を確定する前に、実際のトラフィックからusage_metadataを比較してください。

同じモデル文字列のままでも動作するコードが壊れる理由

自動振り分けではHTTP 200が維持される一方、内部で動いているモデルは変わります。Gemini 3.xにはGemini 2.5では受け付けられていたリクエストルールがあり、モデル名に触れていないコードでも、12月1日以降にエラーや挙動のずれが発生する可能性があります。

Gemini 3.xではthinking_budgetがthinking_levelに置き換わります。Gemini 3.8 Flashが受け付けるのはlow、medium、highで、minimalは拒否されます。一方、Gemini 3.5 Flash-Liteのデフォルトはminimalです。両方のフィールドを送るとHTTP 400になり、両方の移行先でminimalを共通設定すると、3.8 Flashの処理が壊れます。Googleは、抽出・ルーティング・分類にはminimal、サブエージェント、ツール呼び出し、コード実行、複数ステップの推論にはmediumまたはhighを推奨しています。ツールの実行が途中で終わるのを避けるためです。

Gemini 3移行ガイドによると、サンプリングと履歴の制御も変わります。Gemini 3.xでは現在、temperature、top_p、top_kは無視されており、将来世代ではHTTP 400を返す予定です。candidate_countには対応していません。最後の空でないターンのroleがmodelになっているリクエスト、たとえばTranslation:で終わる従来のプレフィルもHTTP 400になります。Googleは代わりにsystem_instructionと構造化出力を案内しています。

Function callingもより厳格になります。Gemini 3.xはthought_signatureを検証し、各FunctionResponseに対応するcall IDとnameを持たせる必要があります。署名を削除したり、署名なしでモデルターンを再構築したりすると、正常なエラーではなく、空のSTOP応答やMISSING_THOUGHT_SIGNATUREの終了になります。回帰テストでは、例外が発生しないことだけでなく、応答テキストも検証してください。

告知から数時間以内に、実際のユーザーがまさにこの問題を報告しています。

GoogleがGemini 2.5の終了日を決めた。重要なのは非推奨化そのものではなく、自動振り分けだ。……つまりコードが404を返すわけではない。別のモデルが静かに回答し始める。— @VarunChopr17597

エージェントがまだgemini-2.5-flashを呼び出しているなら、12月1日からはGemini 3.5 Flash-Liteで動き始める。デフォルトの思考レベルはminimalだ。— @MarMarLabs

11月中に移行するための7ステップ

最も安全なのは、11月中にモデルIDを明示的に変更し、パラメーターも見直したうえで、12月の移行先と並べて評価する方法です。ルーターに任せることを移行戦略にしてはいけません。

1. 各参照箇所とプレビュー用エイリアスを見つける。影響を受ける2つのIDを、対象外のLiteモデルを除外しながらコード、設定、評価ハーネス、ドキュメントから検索します。

grep -rnE 'gemini-2\.5-(pro|flash)([^-]|$)' .

1. IDを明示的に置き換える。ブランチ上で、gemini-2.5-proをgemini-3.8-flashに、gemini-2.5-flashをgemini-3.5-flash-liteに変更します。12月1日の朝に対応するのは避けてください。
2. 思考設定を修正する。thinking_budgetをthinking_levelに置き換え、モデルごとに設定します。3.8 Flashのエージェントではmediumまたはhigh、Flash-Liteでは処理内容に応じてminimal、medium、highを明示し、3.8 Flashにminimalを共有しないようにします。
3. 古いパラメーターを削除する。テスト前にtemperature、top_p、top_k、candidate_count、末尾にモデルのターンを事前入力する設定を取り除きます。
4. SDKとツール連携を更新する。現行のSDKへアップグレードし、thoughtSignatureを含むモデルターン全体を保持します。call IDとnameの両方を持つFunctionResponseを構築し、複数ターンのツール呼び出しをエンドツーエンドで再テストします。
5. 移行先でベースラインを再実行する。本番プロンプトを使い、品質、レイテンシー、出力長、usage_metadataのトークン数を比較します。各タスクでFlashモデルがProモデルと同じスタイルになるわけではありません。
6. コストを2回計算する。Proルートは12月を$0.75/$3.75、1月以降を$1.50/$7.50として予算化し、Flashルートでは音声とキャッシュの料金項目も再確認します。

すでにGemini 3.x、またはgemini-2.5-flash-liteを使っているチームは、この移行をスキップできます。それ以外のチームは11月30日までにステップ6を終えてください。12月1日にテストスイートがグリーンでも、それはルーターが応答しているだけで、挙動が維持されたことを意味しない可能性があります。

エージェントを構築している場合は、ツールを多用する処理の思考レベルを設定する前に、Gemini 3.8 Flashのエージェントタスク料金の内訳も確認してください。

FAQ

Gemini 2.5 Proは2026年12月1日に終了しますか？

いいえ。GoogleがGemini Developer APIについて示している12月1日は、自動振り分けの日付です。gemini-2.5-proへのリクエストはエラーになるのではなく、gemini-3.8-flashへ振り分けられます。

自動振り分けされたリクエストには旧料金と新料金のどちらが適用されますか？

新料金です。12月1日以降にgemini-2.5-proとして送ったリクエストにはGemini 3.8 Flashの料金が、gemini-2.5-flashとして送ったリクエストにはGemini 3.5 Flash-Liteの料金が適用されます。

自動振り分けされるなら、コードを変更する必要はありますか？

あります。Gemini 3.xでは、思考設定、サンプリングパラメーター、事前入力したターン、Function callの連携方法が異なります。コードを変更しないままだと、無視されるパラメーター、HTTP 400、あるいは推論挙動の静かな変化が発生する可能性があります。

12月1日はVertex AIにも適用されますか？

いいえ。12月1日はGemini Developer APIの日付です。Google Cloudは、Vertex AIとEnterprise Agent PlatformにおけるGemini 2.5について、2026年10月の別の廃止日を案内しています。

Gemini 2.5 Flash-Liteも影響を受けますか？

いいえ。Googleはgemini-2.5-flash-liteを非推奨化せず、追って通知があるまで利用できると説明しています。

各ワークロードでは、どの移行先を選ぶべきですか？

タスクの性質を見て選び、評価で確認してください。Flashモデルが旧Proモデルと同等だと決めつけてはいけません。

11月30日までにやること

今週中に2つのモデル文字列を変更し、思考設定とツール連携を修正してください。そしてGemini 2.5がまだ応答するうちに、移行先モデルで新しいベースラインを取っておきましょう。12月の自動振り分けによってサービスは動き続けますが、挙動と料金を自分で管理するには、11月中の移行が必要です。