Gemini 2.5 API 12/1 自動改路由：模型、參數與計費怎麼查

先找出程式實際使用的 model ID#

依 Gemini deprecations，目前規則如下，查核日期為 2026-11-05：

2.5 Pro 與 Flash 已無法在 AI Studio 選取，API 存取限過去積極使用過的既有使用者。這份規則談的是 Gemini API；App 訂閱或其他平台代理的模型供應，需各自核對。

在專案根目錄可以先做文字盤點：

1
rg -n 'gemini-2\.5-(pro|flash)|thinking_budget|thinkingBudget|candidate_count|candidateCount|top_p|topP|top_k|topK|temperature' . --glob '!node_modules/**' --glob '!dist/**' --glob '!pnpm-lock.yaml'

這是搜尋範例，未對讀者專案執行；設定可能藏在環境變數、資料庫或 gateway，還要查實際部署來源。先記「哪個工作流、model 從哪裡讀、使用哪套 SDK／API、是否呼叫工具」，再改對應設定。

thinking 需要重新選級別#

3.8 Flash 遷移指南要求把 thinking_budget 改為 thinking_level。3.8 Flash 接受 low、medium、high，預設為 medium，不支援 minimal。

3.5 Flash-Lite 遷移指南則將 minimal 列為預設，供大量擷取、分類或路由使用；有多步推理與工具呼叫的子代理，文件建議評估 medium 或 high。兩個模型要分別設定；原本 token budget 的數值沒有可直接照抄的級別換算。

文件採用的蛇形命名與 SDK 或 REST 的實際序列化名稱可能不同。修改時應依使用中的 SDK 型別與 API 文件組 payload，並檢查送出的 request；只改設定檔內一個字串容易漏掉 wrapper 的預設值。

清掉舊參數，再測完整工具往返#

官方遷移文件列出應移除的 temperature、top_p、top_k、candidate_count 與 prefilled model turns。API 變更說明進一步區分：取樣參數目前被忽略，未來世代傳入會報錯；以非空 model turn 結尾的預填內容會觸發 400。需要固定輸出格式時，改用 system instruction 或結構化輸出。

工具工作流還要保留 thought_signature 等必要回傳資料，依官方指南驗收 function calling。3.8 指南對 GenerateContent 的 FunctionResponse 另列出 call_id 與 name 要求。直接傳回工具結果文字、或自行丟掉模型回傳的其他欄位，應列為重點檢查路徑。

實際驗收可固定一小組已去識別化的輸入，保留預期 JSON schema、必要欄位與工具行為：

1. 先明確改成目的 model ID，測一筆單輪文字與一筆結構化輸出。
2. 加入一筆完整的「模型要求工具 → 工具結果 → 模型最終回答」。
3. 檢查空結果、工具失敗與多輪續接，確認應用程式能正確處理。
4. 比對正確率、延遲、token 與工具用量，記錄可接受門檻後再擴大流量。

這是尚未執行的遷移驗收設計，本文未呼叫 Gemini API。HTTP 成功只通過傳輸層；若 JSON 或業務欄位解析失敗，可以接著用 fetch JSON 分層排錯方法區分原因。

費用要按新模型與實際用量重算#

官方 pricing的 Standard 付費費率，以每百萬 tokens、美金計：3.8 Flash 至 2026-12-31 的輸入／輸出為 $0.75／$3.75，2027-01-01 起為 $1.50／$7.50；3.5 Flash-Lite 為 $0.30／$2.50。輸出價格包含 thinking tokens，快取、Batch 與工具另有規則。

因此應以遷移樣本的實際 tokens 與工具使用量估算，並把 3.8 的年底導入價與隔年價格分開記。原本要評估新模型導入資格的讀者，可參考 Gemini 4 Argon API 入口指南；本篇處理的是既有 2.5 呼叫即將改路由的相容性工作。

參考資料：

Gemini API release notes：2026-11-02

Gemini deprecations

Gemini 3.8 Flash 遷移指南

Gemini 3.6 Flash 與 3.5 Flash-Lite 遷移指南

Gemini API pricing