Gemini APIのgemini-2.5-proとflash、12月1日に後継へ自動振り替え - 課金も後継の単価に、移行には破壊的変更
GoogleはGemini APIのchangelogの11月2日付の項で、gemini-2.5-proとgemini-2.5-flashを非推奨にした。12月1日からの要求はgemini-3.8-flashとgemini-3.5-flash-liteへ自動で振り替わり、後継の単価で課金される。thinking_budgetの置き換えなど破壊的変更がある。
Googleは Gemini API の changelog の2026年11月2日付の項で、gemini-2.5-pro と gemini-2.5-flash を非推奨にした1。12月1日からは、この2つのモデル名への要求がすべて別のモデルへ自動で送られ、送り先の単価で課金される。
| 今のモデル名 | 12月1日からの振り替え先 |
|---|---|
gemini-2.5-pro | gemini-3.8-flash |
gemini-2.5-flash | gemini-3.5-flash-lite |
コードのモデル名を変えなくても要求は振り替え先に届くが、Googleはこの移行に破壊的な変更が含まれると明記し、12月1日より前にモデル名を更新して移行ガイドを確認するよう案内している1。どちらのモデルも Google AI Studio ではすでに選べない。gemini-2.5-flash-lite は非推奨の対象外で、停止日も発表されていない2。
9月の時点では「非推奨ではない」としていた
非推奨一覧によると、2つのモデルの公開日は2025年6月17日である2。2.5 Pro の一般提供は当時の記事で扱った。2026年9月18日の changelog でGoogleは、2.5系へのアクセスを過去に使っていた利用者に絞ったうえで、これらは非推奨ではなく当面は API で提供を続けると書き、新規のプロジェクトには 3.5 Flash-Lite か 3.8 Flash を使うよう勧めていた1。今回の告知はその約6週間後になる。
10月に扱った gemini-3.7-flash と gemini-3.5-flash の非推奨も呼び出しを後継へ振り替える形だったが、当時の非推奨一覧では停止日が未発表だった。今回は12月1日という日付が一覧に入っている2。
単価の変わり方はモデルで違う
有料枠の Standard の単価(100万トークンあたり)を料金ページから並べると次のようになる3。
| モデル | 入力 | 出力(thinking を含む) |
|---|---|---|
gemini-2.5-pro(プロンプト20万トークン以下) | $1.25 | $10.00 |
gemini-2.5-pro(同20万トークン超) | $2.50 | $15.00 |
gemini-3.8-flash(2026年12月31日まで) | $0.75 | $3.75 |
gemini-3.8-flash(2027年1月1日から) | $1.50 | $7.50 |
gemini-2.5-flash | $0.30(音声は $1.00) | $2.50 |
gemini-3.5-flash-lite | $0.30(音声も同じ) | $2.50 |
Pro から 3.8 Flash へ移る組は、プロンプトが20万トークン以下なら、12月の1か月だけ入出力とも単価が下がる。3.8 Flash の導入価格が年末で終わるため、2027年1月からはこの区分で入力が $1.25 から $1.50 に上がり、出力は $10.00 から $7.50 に下がる。20万トークン超の区分は、1月以降も入出力とも 2.5 Pro の単価を下回る。単価だけで総額は決まらない。Googleは 3.8 Flash が長く複雑なタスクでは設計上トークンを多く使う場合があると説明し、日常的なタスクには reasoning の水準を下げることを勧めている4。
2.5 Flash から 3.5 Flash-Lite へ移る組は単価が同じで、音声入力だけが下がる。
Google 検索によるグラウンディングも数え方が変わる3。2.5 Pro と 2.5 Flash の有料枠は1日1,500件まで無料で、超えると1,000件あたり $35 である。振り替え先の2モデルでは、Gemini 3 以降のモデルで共有する月5,000件が無料で、超えると1,000件あたり $14 になり、1日1,500件の上限がある。無料枠にも違いがある。2.5 Flash の無料枠には1日500件までのグラウンディングがあるが、振り替え先の 3.5 Flash-Lite の無料枠では API の提供対象外となっている(AI Studio では試せる)。
コード側で確認する箇所
changelog が破壊的な変更として挙げるのは、関数呼び出しと thought_signature の検証、thinking_budget から thinking_level への置き換え、サンプリングのパラメータと model ターンのプリフィルの廃止である1。移行ガイドから、手を入れることになる主な箇所を拾う。
- thinking の指定:
thinking_budgetをthinking_levelに置き換える。3.8 Flash の既定はmediumで、minimalを指定するとエラーになる4。3.5 Flash-Lite の既定はminimalで、ツール呼び出しやコード実行を伴うサブエージェントにはmediumかhighを勧めている5 - プリフィル: 最後のターンが内容のある model ターンの要求は HTTP 400 になる。前置きを抑えたり JSON を強制したりする目的なら、システム指示か構造化出力に移す5
- サンプリング:
temperature、top_p、top_kは非推奨で無視される。今後の世代のモデルではエラーになるとされている5 - 関数呼び出し: generateContent API を使う場合、
FunctionResponseにcall_idとnameを含める4
thinking_budget を残したまま振り替えられた要求がどう扱われるかまでは、確認した資料には書かれていない。振り替えの当日に確かめるより、それまでにモデル名を変えて試験しておくほうが確実だと考えられる。
振り替え先と別のモデルを選ぶなら
振り替え先は Google が決めたものなので、用途に合うとは限らない。2.5 Flash の振り替え先は低遅延・低コストを重視した Flash-Lite の系統で、Google自身は HLE で18.0%対11.0%、CharXIV で74.5%対63.7%と 2.5 Flash を上回る値を示して移行先に挙げている5。ただしこれは Google が示した値で、手元のプロンプトでの結果を保証するものではない。3.8 Flash のガイドは、そこまでの検証が要らない処理には reasoning の水準を下げるか、引き続き提供される 3.6 Flash を使う選択肢を挙げている4。
いずれにしても、自動の振り替えに任せたままでは使うモデルを自分で選んだことにならない。コードと設定ファイルからこの2つのモデル名を探し、処理ごとに移行先を決めておくと、12月1日の切り替えと1月1日の単価変更の両方を見積もりに入れられる。
Sources
- Release notes - Google AI for Developers(2026年11月2日と9月18日の項)
- Gemini deprecations - Google AI for Developers(2026年11月4日確認)
- Gemini Developer API pricing - Google AI for Developers(2026年11月4日確認)
- What’s new in Gemini 3.8 Flash - Google AI for Developers(移行ガイド)
- What’s new in Gemini 3.6 Flash and 3.5 Flash-Lite - Google AI for Developers(移行ガイド)
この記事は役に立ちましたか?
ありがとうございます!
受け取りました。ありがとうございます!