作者注:Gemini 4 Carbon 的介紹價 11 月 30 日到期。本文幫你在到期前把賬重新算一遍,並把接入層改成「換模型只改 ID 和端點」的結構。
如果你的業務已經接上 Gemini 4 Carbon,接下來這 10 天值得認真對待。Google 開發者頁面寫明,Gemini 4 Carbon 的介紹價持續到 2026-11-30,2026-12-01 起切換爲標準價,輸入和輸出單價都翻倍。今天是 2026-11-20,介紹價還沒有結束,現在動手調整成本模型和接入代碼,時間是夠的。
這不是一篇勸你立刻換模型的文章。換過去不一定更便宜,效果也不一定等價。本文要解決兩件更實際的事:一是到期之後怎麼重新算賬,二是怎麼把調用層改造成能隨時切換的結構,讓下一次價格或上下文窗口變化時,你只需改模型 ID 和端點,不必重寫整個調用。
核心價值:讀完本文,你會拿到明確的到期日、介紹價和標準價兩套數字,以及換到 Hydrogen、Neon、Fable 或 Astra 時各自應該走的端點。

Gemini 4 Carbon 介紹價到期核心要點
先把關鍵事實集中列出。表中數字來自 Google 開發者頁面,以及 API易 在 2026-11-20 覈對的價格信息,單位爲美元每百萬 token。
| 要點 | 說明 | 對你的影響 |
|---|---|---|
| 介紹價截止日 | 到 2026-11-30 爲止 |
11 月賬單按介紹價計算 |
| 介紹價 | 輸入 2、輸出 10、緩存讀 0.10 |
當前成本基線 |
| 標準價(12 月 1 日起) | 輸入 4、輸出 20、緩存讀 0.20 |
同等用量下成本約翻倍 |
| API易 當前貨架 | gemini-4-carbon 輸入 2、緩存讀 0.1、輸出 10 |
與介紹價一致,到期後以平臺型號列表爲準 |
| 可替換型號 | Hydrogen、Neon、Fable、Astra | 端點不同,不能共用一個請求體 |
Gemini 4 Carbon 兩套價格怎麼理解
介紹價和標準價的差別很直接:輸入從 2 漲到 4,輸出從 10 漲到 20,緩存讀從 0.10 漲到 0.20,三項都是兩倍。所以 12 月以後的成本幾乎就是「11 月同等用量乘以 2」。如果你的提示詞裏有大量可複用前綴、緩存命中率高,緩存讀部分的絕對增量會小一些,但比例同樣是翻倍。
需要特別區分的是 API易 apiyi.com 的貨架價。根據 2026-11-20 的核對,平臺上 gemini-4-carbon 標的是輸入 2、緩存讀 0.1、輸出 10,對應的是 Google 介紹價,不是 12 月 1 日之後的標準價。到期以後平臺怎麼調整,應以當時的平臺型號列表爲準,不要把現在看到的貨架價當作 12 月以後的保證。
爲什麼不能綁死一家模型
只接一家模型,風險主要來自三個方向。第一是價格改口,介紹期結束、促銷調整都會直接改變單位成本。第二是模型下線或更名,原來的 ID 突然不可用,調用會大面積報錯。第三是同一模型在不同入口的思考檔位、上下文窗口不一致,你在一個入口調好的參數,到另一個入口可能不生效。
這三類變化都不是你能控制的,但你能控制的是:變化發生時,改動範圍有多大。如果模型 ID、端點類型、價格參數都寫死在業務代碼裏,每次變化都要改代碼、重新測試、重新上線。如果這些都收斂到接入層的配置中,變化就只是改一行配置。

Gemini 4 Carbon 到期後如何重算成本
用你自己的用量套兩套價格
重算其實只需要三個數字:月輸入 token、月輸出 token、月緩存讀 token。把它們分別乘以對應單價再相加,就得到月成本。下面用一個假設的用量做演示:每月輸入 100M token、輸出 20M token,暫不計緩存。這個用量只是示意,請替換成你自己賬單裏的真實值。
| 計費方案 | 輸入單價 | 輸出單價 | 假設用量下的月成本 |
|---|---|---|---|
| Carbon 介紹價(至 11-30) | 2 |
10 |
100×2 + 20×10 = 400 美元 |
| Carbon 標準價(12-01 起) | 4 |
20 |
100×4 + 20×20 = 800 美元 |
gemini-4-hydrogen |
1.5 |
7.5 |
100×1.5 + 20×7.5 = 300 美元 |
gemini-4-neon |
3 |
15 |
100×3 + 20×15 = 600 美元 |
claude-fable-5-2 |
8 |
40 |
100×8 + 20×40 = 1600 美元 |
gpt-6.2-astra(首檔) |
8 |
40 |
100×8 + 20×40 = 1600 美元 |
這張表只算了單價,沒有算效果。Hydrogen 的單價最低,但能不能替代 Carbon,取決於你的任務對推理質量、格式穩定性的要求。Fable 和 Astra 單價更高,適合那些對質量要求高、願意爲效果付費的環節,而不是作爲降本方案。換句話說,重算的目的是讓你看清每條路的成本,而不是默認換過去就更省。
價格數據從哪裏覈對
API易 的價格有兩個來源可以對照。一個是模型總表,2026-11-20 覈對的版本更新於 2026-11-19 10:59(UTC+8)。另一個是定價接口 api.apiyi.com/api/pricing,版本爲 shell-api-modelmak-v1,其中 model_ratio 爲 1 時等於輸入 2 美元每百萬 token,輸出和緩存分別通過 completion_ratio 和 cache_ratio 換算。
以 gemini-4-neon 爲例,該版總表裏沒有這一行,但定價接口裏有:model_ratio 爲 1.5,completion_ratio 爲 5,cache_ratio 爲 0.05。換算下來是輸入 3、輸出 15、緩存讀 0.15,和 Google 的標價一致。建議你在做預算時以定價接口爲準,總表作爲輔助閱讀。
gpt-6.2-astra 有分檔計價,需要兩處都看。總表寫的首檔是輸入 8、緩存讀 0.4、輸出 40,超過 272000 token 時輸入變爲 16;定價接口則顯示超過 272000 token 時輸出按 60、緩存讀按 0.8 計算。如果你的單次請求經常有很長的上下文,這個分檔對成本影響很大,必須單獨估算。
💰 成本覈對建議:到期前後各拉一次 API易 apiyi.com 的定價接口和型號列表,把單價寫進你的路由配置,而不是寫死在代碼註釋裏。這樣每月對賬時,只需對比配置和平臺數據是否一致。
Gemini 4 Carbon 替換型號的端點對照
換模型先對端點,不要假設請求體通用
這是最容易踩坑的一步。很多團隊以爲「都走 OpenAI 兼容接口,換個 model 字段就行」,結果某些模型推薦的端點根本不同,請求體字段也不一樣。下表整理了可替換型號推薦的端點類型,所有調用統一走 https://api.apiyi.com/v1 這個基礎地址。
| 模型 ID | 推薦端點 | 輸入 / 緩存讀 / 輸出單價 | 切換注意 |
|---|---|---|---|
gemini-4-carbon |
chat 或 gemini 原生 | 2 / 0.1 / 10(當前貨架) |
到期後以型號列表爲準 |
gemini-4-hydrogen |
chat 或 gemini 原生 | 1.5 / 0.075 / 7.5 |
與 Carbon 端點一致,改動最小 |
gemini-4-neon |
chat 或 gemini 原生 | 3 / 0.15 / 15 |
價格以定價接口爲準 |
claude-fable-5-2 |
chat 或 messages | 8 / 0.2 / 40 |
原生能力走 messages 更完整 |
claude-fable-5-2-thinking |
chat 或 messages | 8 / 0.2 / 40 |
思考檔是獨立 ID |
gpt-6.2-astra |
推薦 responses | 首檔 8 / 0.4 / 40 |
超過 272000 token 分檔計價 |
另外,gemini-4-argon 在總表裏也有,標價爲輸入 2、緩存讀 0.1、輸出 10,和 Carbon 當前貨架價相同。它的端點信息本文參考資料未覆蓋,如果你考慮它,請先在平臺文檔裏確認推薦端點再接入。
三類端點的差異在哪裏
chat 端點即 OpenAI 兼容的對話補全格式,請求體核心是 model 和 messages 數組,大多數 SDK 默認就是這一類。gemini 原生端點使用 Gemini 自己的請求結構,適合需要原生參數(比如特定的思考配置)的場景。messages 端點是 Claude 原生格式,system 提示詞的放置方式、內容塊結構都與 chat 不同。responses 端點是 OpenAI 較新的接口形態,gpt-6.2-astra 推薦走這裏。
所以一個穩妥的接入層,應該爲每種端點準備一個獨立的適配器,業務代碼只傳入「任務類型 + 內容」,由適配器負責拼裝對應格式。具體的端點路徑和字段,請以 API易 文檔中心的說明爲準。
🎯 技術建議:切換前先用 API易 apiyi.com 的同一個 API Key,分別對候選模型的推薦端點各發幾條真實業務請求,確認返回結構、思考檔行爲和上下文長度都符合預期,再改路由配置。

Gemini 4 Carbon 可切換接入層快速上手
極簡示例:統一客戶端
本節不貼大段代碼,只給出關鍵配置。OpenAI 兼容 SDK 初始化客戶端時,只需要兩個參數:client = OpenAI(api_key="YOUR_API_KEY", base_url="https://api.apiyi.com/v1")。之後調用 chat 端點時寫 client.chat.completions.create(model="gemini-4-carbon", messages=msgs),想切到 Hydrogen,只需把 model 改成 gemini-4-hydrogen,因爲兩者共用 chat 端點,請求體不用動。
切到 gpt-6.2-astra 時情況就不同了。推薦寫法是 client.responses.create(model="gpt-6.2-astra", input=msgs),參數名從 messages 變成了 input,返回結構也不同。這正是爲什麼接入層必須按端點拆分適配器,而不是隻換模型名。
完整改造步驟
把單模型調用改造成可切換結構,可以按下面的順序做:
- 抽出路由配置:建一個配置表,每一行包含任務名、模型 ID、端點類型、輸入單價、輸出單價、緩存讀單價。業務代碼只認任務名。
- 按端點寫適配器:分別實現 chat、gemini 原生、messages、responses 四個適配器,每個適配器負責把統一輸入轉成對應請求體,並把返回值轉成統一結構。
- 統一基礎地址和密鑰:所有適配器共享同一個
base_url和 API Key,切換模型時不用新增密鑰管理。 - 加回退鏈:爲關鍵任務配置主模型和備用模型,比如主用
gemini-4-carbon、備用gemini-4-hydrogen,主模型報錯或下線時自動走備用。 - 成本埋點:每次調用記錄模型 ID 和 token 用量,用配置表裏的單價實時估算成本,月底和賬單對照。
查看路由配置表示例字段
一條典型的路由配置可以包含這些字段:`task: “summary”`、`model: “gemini-4-carbon”`、`endpoint: “chat”`、`price_in: 2`、`price_out: 10`、`price_cache: 0.1`、`fallback: “gemini-4-hydrogen”`。12 月 1 日之後,你只需要根據平臺型號列表更新 `price_in` 和 `price_out`,或者把 `model` 和 `endpoint` 換掉,業務代碼完全不用改。
對於 `gpt-6.2-astra` 這種分檔計價的模型,建議額外加 `tier_threshold: 272000` 和對應的高檔單價字段,由成本埋點模塊根據單次請求的 token 數判斷落在哪一檔。
🚀 快速開始:如果你還沒有統一入口,可以先在 API易 apiyi.com 註冊獲取 API Key 和免費測試額度,用一個 Key 把 Carbon、Hydrogen、Neon、Fable、Astra 都跑通一遍,再決定路由怎麼配。
到期前的檢查清單
| 檢查項 | 截止建議 | 說明 |
|---|---|---|
| 導出 11 月用量 | 11-25 前 | 拿到輸入、輸出、緩存讀三項真實 token 數 |
| 套算兩套價格 | 11-26 前 | 用介紹價和標準價分別算出月成本 |
| 候選模型試跑 | 11-28 前 | 按推薦端點各跑一批真實請求 |
| 路由配置上線 | 11-30 前 | 主備模型和單價都進配置 |
| 複覈平臺價格 | 12-01 後 | 以平臺型號列表爲準更新單價 |
常見問題 FAQ
Q1:Gemini 4 Carbon 的介紹價具體到哪一天?
根據 Google 開發者頁面,介紹價持續到 2026-11-30,期間輸入 `2`、輸出 `10`、緩存讀 `0.10` 美元每百萬 token。2026-12-01 起改爲標準價:輸入 `4`、輸出 `20`、緩存讀 `0.20`。
Q2:API易 上的 Carbon 價格 12 月以後會變成多少?
目前 API易 貨架上 `gemini-4-carbon` 是輸入 `2`、緩存讀 `0.1`、輸出 `10`,對應的是介紹價。12 月 1 日之後的價格請以平臺型號列表爲準,本文不對之後的貨架價做任何保證,建議到期後直接在 API易 apiyi.com 覈對。
Q3:從 Carbon 換到 Hydrogen 需要改多少代碼?
改動最小。兩者推薦端點相同,都是 chat 或 gemini 原生,如果你已經走 chat 端點,只需把 `model` 字段從 `gemini-4-carbon` 改成 `gemini-4-hydrogen`。但仍建議先用真實請求驗證效果,單價更低不代表任務質量等價。
Q4:換到 Claude Fable 或 GPT Astra 爲什麼不能直接改模型名?
因爲推薦端點不同。`claude-fable-5-2` 可走 chat 或 messages,原生能力走 messages 更完整;`gpt-6.2-astra` 推薦走 responses,請求參數和返回結構都和 chat 不同。直接改模型名,往往會遇到字段不識別或解析失敗。
Q5:Gemini 4 Neon 的價格以哪裏爲準?
2026-11-19 版的模型總表裏沒有 Neon 這一行,但定價接口裏有,換算爲輸入 `3`、輸出 `15`、緩存讀 `0.15`,與 Google 標價一致。做預算時以定價接口爲準即可,端點同樣是 chat 或 gemini 原生。
Q6:怎麼用一個 Key 快速對比幾個候選模型?
推薦用 API 聚合平臺統一測試:
1. 在 API易 apiyi.com 註冊,獲取 API Key 和免費測試額度
2. 把客戶端的 `base_url` 設爲統一地址,按各模型推薦端點分別調用
3. 記錄每個模型的 token 用量和輸出質量,再套入本文的重算表
Q7:這套可切換接入層有哪些侷限?
接入層只能降低切換成本,不能消除效果差異。不同模型對同一提示詞的理解、格式遵循和思考檔行爲都可能不同,切換後仍需迴歸測試。另外分檔計價模型(如 Astra 超過 `272000` token)需要單獨估算,統一的成本公式會低估長上下文請求。
Gemini 4 Carbon 介紹價到期 Key Takeaways
- 到期日明確:介紹價到 2026-11-30,12 月 1 日起轉標準價
- 成本約翻倍:輸入、輸出、緩存讀三項標準價都是介紹價的兩倍
- 貨架價不等於承諾:API易 當前 Carbon 價對應介紹價,到期後以型號列表爲準
- 端點各不相同:Hydrogen、Neon 走 chat 或 gemini,Fable 走 chat 或 messages,Astra 推薦 responses
- 換了不一定更省:Hydrogen 單價低,Fable 和 Astra 單價高,需結合效果判斷
- 配置化是關鍵:模型 ID、端點、單價都進路由配置,業務代碼只認任務名
- 統一入口便於驗證:用 API易 一個 Key 跑通多個候選模型再決定路由
總結
Gemini 4 Carbon 介紹價到期這件事,核心要點有三個:
- 先算賬:用真實用量分別套介紹價和標準價,12 月以後同等用量的成本約爲原來的兩倍。
- 再對端點:替換型號的推薦端點並不相同,換模型前先確認 chat、gemini、messages、responses 各自的請求格式。
- 最後配置化:把模型 ID、端點類型和單價收斂進路由配置,下次價格或窗口再變,只改配置不改代碼。
距離 11 月 30 日還有 10 天,足夠你完成用量導出、兩套價格重算和候選模型試跑。別把業務綁死在一個模型的一個價格上,接入層留好能換的口,纔是對下一次變化最穩妥的準備。
推薦通過 API易 apiyi.com 統一接入,用一個 Key 在多個模型和端點之間驗證效果、對比成本。
📚 參考資料
-
Google 開發者頁面 – Gemini 定價說明:Gemini 4 Carbon 介紹價與標準價
- 鏈接:
ai.google.dev - 說明:介紹價截止日期及 12 月 1 日起的標準價
- 鏈接:
-
API易 模型總表:各模型輸入、輸出、緩存讀單價
- 鏈接:
docs.apiyi.com/models.md - 說明:2026-11-20 覈對版本更新於 2026-11-19 10:59(UTC+8)
- 鏈接:
-
API易 定價接口:按倍率換算的實時價格
- 鏈接:
api.apiyi.com/api/pricing - 說明:版本
shell-api-modelmak-v1,適合程序化讀取單價
- 鏈接:
作者:APIYI 技術團隊
技術交流:歡迎在 API易 網站首頁聯繫我們,各模型端點與參數說明可在文檔中心查閱
