作者注:2026 年 11 月新模型密集發佈。本文說明怎樣用一個入口換型號、按端點接入,並把每條通道的賬單分開覈算。
11 月剛過去三週,Google 已經連發三款 Gemini 4 型號:11 月 10 日發佈 Carbon,11 月 12 日發佈 Hydrogen,11 月 18 日發佈 Neon。圖像、編碼等方向也陸續有新型號出現在新聞裏。對想試新模型的開發者來說,麻煩不在於寫不出調用代碼,而在於每家各有一套 SDK、一套鑑權和一套計費口徑。本文給出一套更省事的做法:一個入口換型號,賬單按通道分開看。
這不是一份”新模型全家桶”的宣傳清單。新聞裏出現的型號和平臺上已經能調用的型號,本文會分開寫。比如新聞裏的 MAI Image 2.7 目前還沒有進入 API易 的貨架,文中不會把它當作可調用模型。
核心價值:讀完本文,你會知道先去哪裏對型號列表,怎樣決定換哪一個模型 ID,每類模型該走哪個端點,以及如何避免用一家模型的單價去估算整張賬單。下文涉及的型號與價格,均以 API易 apiyi.com 在 2026-11-20 的型號列表和定價接口爲準。

11 月新模型接入核心要點
新模型密集上線時,最容易出錯的環節集中在三處:把新聞型號當成已上架型號,用錯端點,以及用一個單價估算全部成本。下表把這三處和對應做法放在一起。
| 要點 | 說明 | 價值 |
|---|---|---|
| 先對型號列表 | 以平臺總表和定價接口爲準,新聞型號與可調型號分開記 | 避免拿着發佈會上的型號名直接調用,結果報錯 |
| 換型號=換模型 ID+覈對端點 | 同一個 base_url 下改 model 參數,再確認走 chat、messages、responses 還是 gemini |
不必爲每家廠商各寫一套 SDK |
| 賬單按通道分開看 | 每個模型、每個端點單獨記錄輸入、輸出和緩存讀 token | 單價相差數倍的模型不會被平均到一起,成本可追溯 |
| 介紹價有截止日 | 部分新型號有限時介紹價,到期後官方標準價會變化 | 提前預估下個月預算,不被漲價打亂計劃 |
新模型接入重點詳解:新聞型號 ≠ 貨架型號
接入的第一步是查貨架,不是寫代碼。API易 的模型總表地址是 docs.apiyi.com/models.md,本文參考的版本更新於 2026-11-19 10:59(UTC+8)。另有一個機器可讀的定價接口 https://api.apiyi.com/api/pricing,版本標識爲 shell-api-modelmak-v1。兩者更新節奏可能不同步,比如 gemini-4-neon 在這一版總表裏還沒有出現,但定價接口裏已經有完整的價格字段。因此判斷”能不能調”時,建議總表和定價接口兩處都查,任意一處有記錄,再用一次小請求確認。
反過來的情況同樣要留意。MAI Image 2.7 是近期新聞裏的圖像型號,但 API易 當前的總表和定價接口裏只有 MAI-Image-2.6 和 MAI-Image-2.6-Flash,沒有 2.7。也就是說,MAI Image 2.7 暫未上架,我們會盡快上架這個模型,屆時型號與價格以平臺型號列表爲準。另外,Kling、Muse、gemini-4-flash-lite 目前在總表和定價接口裏都查不到,規劃方案時不要把它們算進來。

11 月新型號與貨架狀態對照
下表把 11 月新聞中提到的型號和 2026-11-20 的貨架狀態逐一對應。表中只寫資料中能覈實的信息,沒有核實到的不做推測。
| 型號 | 新聞信息 | API易 貨架狀態(2026-11-20) | 模型 ID |
|---|---|---|---|
| Gemini 4 Carbon | 2026-11-10 發佈,面向長程難任務 | 總表與定價接口可查 | gemini-4-carbon |
| Gemini 4 Hydrogen | 2026-11-12 發佈,速度快的日常檔 | 總表與定價接口可查 | gemini-4-hydrogen |
| Gemini 4 Neon | 2026-11-18 發佈,能力居中 | 定價接口已有,本版總表未列出 | gemini-4-neon |
| Gemini 4 Argon | — | 總表可查 | gemini-4-argon |
| MAI Image 2.7 | 新聞中的圖像型號 | 暫未上架,會盡快上架 | 以平臺列表爲準 |
| MAI Image 2.6 / 2.6 Flash | — | 可查,按次計費 | MAI-Image-2.6 / MAI-Image-2.6-Flash |
Gemini 4 三檔的定位可以簡單理解爲:Carbon 偏重長鏈路、難度高的任務,Hydrogen 追求速度、適合高頻日常調用,Neon 介於兩者之間。選型時先按任務難度挑檔位,再看價格,這樣比直接挑最便宜的更穩。
11 月新模型快速上手:一個入口換型號
極簡示例:改兩個參數就能換型號
API易 提供 OpenAI 兼容接口,接入新模型時,大部分改動只有兩處:base_url 和 model。以 OpenAI 官方 Python SDK 爲例,最小步驟如下:
- 安裝 SDK:
pip install openai - 創建客戶端:
client = openai.OpenAI(api_key="YOUR_API_KEY", base_url="https://api.apiyi.com/v1") - 發起對話:
client.chat.completions.create(model="gemini-4-hydrogen", messages=[{"role": "user", "content": "Hello!"}]) - 讀取結果:
response.choices[0].message.content
想從 Hydrogen 換到 Carbon,只需把 model="gemini-4-hydrogen" 改成 model="gemini-4-carbon",客戶端、鑑權和消息結構都不用動。這就是”一個入口換型號”的含義:換模型通常是換模型 ID 並覈對端點,不需要每家各寫一套 SDK。
查看完整接入思路(含端點切換與通道記賬)
完整項目裏,建議把”模型 ID → 端點”的映射放進配置,而不是散落在代碼裏:
1. 定義配置項 `MODEL_ROUTES`,每條記錄包含 `model`、`endpoint`、`price_key` 三個字段,例如 `gemini-4-neon` 對應 `chat`,`claude-fable-5-2` 對應 `messages`,`gpt-6.2-astra` 對應 `responses`。
2. 封裝 `call_model(model, prompt)` 函數:按 `endpoint` 分別調用 `client.chat.completions.create`、`client.responses.create`,或用 Anthropic SDK 以 Messages 格式請求(base_url 同上)。
3. 每次請求返回後,從響應的 `usage` 字段讀取輸入、輸出、緩存 token,按 `model+endpoint` 作爲通道鍵寫入本地賬本。
4. 每天定時請求一次定價接口,按 `model_ratio`、`completion_ratio`、`cache_ratio` 換算單價,再乘以賬本中的 token 數,得到每條通道的預估費用。
5. 調用失敗時記錄 `model` 與錯誤信息。如果提示模型不存在,先回頭覈對型號列表,不要盲目重試。
這樣新模型上架後,只需在 `MODEL_ROUTES` 里加一行配置,業務代碼不用改。
🚀 快速開始建議:先在 API易 apiyi.com 註冊並領取新用戶免費測試額度,用 Hydrogen 這類日常檔跑通鏈路,再換 Neon、Carbon 對比效果。整個過程只需要一個 API Key。
新模型端點對照:別把所有型號都塞進 chat
“一個入口”不等於”一個端點”。已能調用的文本型號,各自支持的端點不同,換型號時這一步必須覈對:
| 模型系列 | 模型 ID 示例 | 可用端點 | 說明 |
|---|---|---|---|
| Gemini 4 系列 | gemini-4-carbon / gemini-4-neon / gemini-4-hydrogen |
chat 或 gemini | chat 即 OpenAI 兼容的 /v1/chat/completions;gemini 爲 Gemini 原生格式,具體路徑以平臺文檔爲準 |
| Claude Fable 5.2 | claude-fable-5-2 / claude-fable-5-2-thinking |
chat 或 messages | messages 爲 Anthropic 風格的 /v1/messages |
| GPT-6.2 Astra | gpt-6.2-astra |
推薦 responses | 推薦走 /v1/responses |
| MAI Image 2.6 | MAI-Image-2.6 / MAI-Image-2.6-Flash |
圖像生成 | 按次計費,調用方式以平臺文檔爲準 |
實際使用中,如果團隊已有大量基於 chat 格式的代碼,Gemini 和 Claude 可以先沿用 chat 端點,遷移成本最低。需要用到廠商原生能力時,再切換到 gemini 或 messages 端點。GPT-6.2 Astra 則建議直接按 responses 端點接入,不要因爲習慣而硬套 chat。
11 月新模型賬單:按通道分開看
先學會讀定價接口
API易 的定價接口用倍率表示價格,換算規則如下:
- 輸入單價 =
model_ratio × 2(單位:美元/百萬 token,model_ratio爲 1 時等於$2 / 1M) - 輸出單價 = 輸入單價 ×
completion_ratio - 緩存讀單價 = 輸入單價 ×
cache_ratio
以 gemini-4-neon 爲例,定價接口給出 model_ratio 1.5、completion_ratio 5、cache_ratio 0.05,換算後輸入爲 $3 / 1M,輸出爲 $15 / 1M,緩存讀爲 $0.15 / 1M,與 Google 的標價一致。掌握這個換算方法後,新模型一上架,你就能自己從 https://api.apiyi.com/api/pricing 算出單價,不必等文章更新。
各通道價格對照(2026-11-20 覈對)

📊 數據來源說明:上圖與下表的價格取自 API易 apiyi.com 模型總表和定價接口,覈對日期爲 2026-11-20,後續調整以平臺實時列表爲準。
| 通道(模型 ID) | 輸入 | 緩存讀 | 輸出 | 備註 |
|---|---|---|---|---|
gemini-4-hydrogen |
$1.5 / 1M |
$0.075 / 1M |
$7.5 / 1M |
日常快檔 |
gemini-4-carbon |
$2 / 1M |
$0.1 / 1M |
$10 / 1M |
對應 Google 截至 2026-11-30 的介紹價 |
gemini-4-argon |
$2 / 1M |
$0.1 / 1M |
$10 / 1M |
取自總表 |
gemini-4-neon |
$3 / 1M |
$0.15 / 1M |
$15 / 1M |
取自定價接口 |
claude-fable-5-2 / -thinking |
$8 / 1M |
$0.2 / 1M |
$40 / 1M |
兩個 ID 價格相同 |
gpt-6.2-astra(首檔) |
$8 / 1M |
$0.4 / 1M |
$40 / 1M |
超過 272000 token 見下文 |
MAI-Image-2.6 |
按次 $0.12 |
— | — | 圖像 |
MAI-Image-2.6-Flash |
按次 $0.06 |
— | — | 圖像 |
表裏有兩處需要單獨說明。
第一處是 GPT-6.2 Astra 的長上下文階梯。總表寫的是超過 272000 token 時輸入變爲 $16 / 1M;定價接口則進一步給出,超過 272000 token 時輸出按 $60 / 1M、緩存讀按 $0.8 / 1M 計算。如果你的業務會塞入超長上下文,務必按階梯分開估算,不要用首檔價格套全部請求。
第二處是 Gemini 4 Carbon 的介紹價。目前的價格對應 Google 截至 2026-11-30 的介紹價,Google 從 12 月 1 日起的標準價爲輸入 $4 / 1M、輸出 $20 / 1M。平臺後續價格以 API易 型號列表爲準,做 12 月預算時建議預留這部分差額。
爲什麼不能用一家單價概括全部
從上表可以看出,同樣是百萬 token 輸出,Hydrogen 是 $7.5,Claude Fable 5.2 和 GPT-6.2 Astra 首檔是 $40,相差五倍多。如果團隊同時跑三四個模型,只看一個”平均單價”或某一家的單價,很容易嚴重低估或高估成本。更穩妥的做法是以”模型 ID+端點”作爲通道鍵,每條通道單獨記錄輸入、輸出、緩存讀 token,分別乘以各自單價,最後再彙總。
還要注意,統一入口解決的是接入成本,不等於每個模型都一定更便宜。上表中多個 Gemini 4 型號的價格與 Google 標價一致。是否划算,應當按通道逐一和你的實際用量對比,而不是一概而論。
💰 成本建議:做選型對比時,可以在 API易 apiyi.com 用同一批測試樣本分別調用 Hydrogen、Neon 和 Carbon,再按通道記下 token 消耗,算出每條通道的真實單次成本,然後決定主力模型。
常見問題 FAQ
Q1:什麼叫“一個入口換型號”?
就是所有模型共用同一個 base_url 和同一個 API Key。切換模型時改 `model` 參數中的模型 ID,並覈對該模型支持的端點即可,不需要爲每家廠商單獨註冊、單獨接 SDK。
Q2:新聞裏剛發佈的模型,能直接調用嗎?
不一定。發佈不等於上架。以 2026-11-20 爲例,MAI Image 2.7 只出現在新聞裏,API易 貨架上只有 `MAI-Image-2.6` 和 `MAI-Image-2.6-Flash`,2.7 暫未上架,會盡快上架。調用前先查總表和定價接口,確認模型 ID 存在再接入。
Q3:Gemini 4 的 Carbon、Hydrogen、Neon 該怎麼選?
按任務難度選檔位:長鏈路、高難度任務用 Carbon;高頻、追求速度的日常調用用 Hydrogen;介於兩者之間的用 Neon。三款分別於 11 月 10 日、12 日、18 日發佈,價格也各不相同,建議用同一批樣本對比後再定主力。
Q4:總表裏查不到 gemini-4-neon,是不是還不能用?
不能只看總表。2026-11-19 的總表版本里沒有 `gemini-4-neon`,但定價接口已經給出了完整倍率,換算後爲輸入 `$3 / 1M`、輸出 `$15 / 1M`、緩存讀 `$0.15 / 1M`。兩處信息存在時間差,以定價接口和實際小額測試結果爲準。
Q5:如何通過 API 快速調用這些 11 月新模型?
建議按以下步驟操作:
1. 在 API易 apiyi.com 註冊賬號,獲取 API Key 和新用戶免費測試額度
2. 查模型總表與定價接口,確認目標模型 ID
3. 把 base_url 設爲平臺的 OpenAI 兼容地址,按上文端點對照表選擇 chat、messages、responses 或 gemini
4. 先發一次短請求,確認可用後再接入業務
Q6:同一個 Claude Fable 5.2,走 chat 和走 messages 價格不一樣嗎?
參考資料裏 `claude-fable-5-2` 與 `claude-fable-5-2-thinking` 的價格相同,均爲輸入 `$8 / 1M`、緩存讀 `$0.2 / 1M`、輸出 `$40 / 1M`,資料中沒有按端點區分價格。不過記賬時仍建議把端點作爲通道鍵的一部分,便於排查問題和後續覈對。
Q7:統一入口一定比直連官方便宜嗎?
不能這麼下結論。統一入口的主要價值是少接幾套接口、統一鑑權和計費入口。價格要按通道逐一看,比如 `gemini-4-neon` 的價格與 Google 標價一致。是否更省,取決於你使用的模型組合和用量,需要自己按通道覈算。
Q8:有哪些已知的限制需要提前規劃?
主要有三點。第一,部分新型號尚未上架,例如 MAI Image 2.7、Kling、Muse、`gemini-4-flash-lite` 目前都查不到。第二,介紹價有截止日,Gemini 4 Carbon 對應的 Google 介紹價截至 11 月 30 日。第三,GPT-6.2 Astra 超過 272000 token 後按階梯計價。遇到這些情況,先按平臺列表調整方案,再回頭改代碼。
11 月新模型接入核心要點 Key Takeaways
- 先查貨架再寫代碼:以模型總表和定價接口爲準,新聞型號與可調型號分開記錄
- 換型號只改兩處:同一 base_url 下修改模型 ID,再覈對端點類型
- 端點要對號入座:Gemini 走 chat 或 gemini,Claude 走 chat 或 messages,GPT-6.2 Astra 推薦 responses
- 會讀倍率就會算價:
model_ratio × 2即輸入單價,再乘以輸出、緩存倍率 - 賬單按通道拆開:以“模型 ID+端點”爲鍵單獨記賬,不用一家單價套全部
- 留意截止日與階梯:Carbon 介紹價、Astra 的 272000 token 階梯都會影響預算
- 上手路徑:在 API易 用一個 Key 領取免費額度,先跑日常檔,再橫向對比
總結:11 月新模型扎堆,一個入口換型號,賬單按通道分開看
11 月新模型扎堆時,接入的關鍵不是追每一條新聞,而是建立一套固定流程:
- 對型號列表:總表和定價接口兩處都查。新聞裏的 MAI Image 2.7 暫未上架,不要寫進上線計劃。
- 換模型 ID、覈對端點:一個 base_url 搞定多家模型,按端點對照表選擇 chat、messages、responses 或 gemini。
- 按通道看賬單:每個模型、每個端點單獨覈算 token 和費用,同時留意介紹價截止日和長上下文階梯。
流程一旦固定,下次再有新模型發佈,你只需在配置里加一行模型 ID,查一次定價接口,就能完成接入與成本評估。推薦在 API易 apiyi.com 用新用戶免費額度先跑通一條通道,再逐步把 Gemini 4、Claude Fable 5.2、GPT-6.2 Astra 加入對比。
📚 參考資料
-
Google 官方博客 – Gemini 4 Neon 發佈公告:Gemini 4 系列型號介紹
- 鏈接:
blog.google/innovation-and-ai/models-and-research/gemini-models/introducing-gemini-4-neon - 說明:瞭解 Carbon、Hydrogen、Neon 的定位與發佈時間
- 鏈接:
-
API易 模型總表與定價接口:型號與價格覈對來源
- 鏈接:見正文“新聞型號 ≠ 貨架型號”一節
- 說明:總表與定價接口版本可能不同步,建議兩處對照查看
作者: APIYI 技術團隊
技術交流:歡迎在 API易 網站首頁聯繫我們,更多接入文檔可訪問 docs.apiyi.com 文檔中心
