|

11 月新模型扎堆怎麼接?一個入口換型號,賬單按通道分開看

11 月新模型扎堆怎麼接?一個入口換型號,賬單按通道分開看

作者注: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 的型號列表和定價接口爲準。

november-new-models-one-endpoint-switch-model-billing-by-channel-zh-hant-image-0


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 目前在總表和定價接口裏都查不到,規劃方案時不要把它們算進來。

november-new-models-one-endpoint-switch-model-billing-by-channel-zh-hant-image-1

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 爲例,最小步驟如下:

  1. 安裝 SDK:pip install openai
  2. 創建客戶端:client = openai.OpenAI(api_key="YOUR_API_KEY", base_url="https://api.apiyi.com/v1")
  3. 發起對話:client.chat.completions.create(model="gemini-4-hydrogen", messages=[{"role": "user", "content": "Hello!"}])
  4. 讀取結果: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 覈對)

november-new-models-one-endpoint-switch-model-billing-by-channel-zh-hant-image-2

📊 數據來源說明:上圖與下表的價格取自 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 月新模型扎堆時,接入的關鍵不是追每一條新聞,而是建立一套固定流程:

  1. 對型號列表:總表和定價接口兩處都查。新聞裏的 MAI Image 2.7 暫未上架,不要寫進上線計劃。
  2. 換模型 ID、覈對端點:一個 base_url 搞定多家模型,按端點對照表選擇 chat、messages、responses 或 gemini。
  3. 按通道看賬單:每個模型、每個端點單獨覈算 token 和費用,同時留意介紹價截止日和長上下文階梯。

流程一旦固定,下次再有新模型發佈,你只需在配置里加一行模型 ID,查一次定價接口,就能完成接入與成本評估。推薦在 API易 apiyi.com 用新用戶免費額度先跑通一條通道,再逐步把 Gemini 4、Claude Fable 5.2、GPT-6.2 Astra 加入對比。


📚 參考資料

  1. Google 官方博客 – Gemini 4 Neon 發佈公告:Gemini 4 系列型號介紹

    • 鏈接: blog.google/innovation-and-ai/models-and-research/gemini-models/introducing-gemini-4-neon
    • 說明:瞭解 Carbon、Hydrogen、Neon 的定位與發佈時間
  2. API易 模型總表與定價接口:型號與價格覈對來源

    • 鏈接:見正文“新聞型號 ≠ 貨架型號”一節
    • 說明:總表與定價接口版本可能不同步,建議兩處對照查看

作者: APIYI 技術團隊
技術交流:歡迎在 API易 網站首頁聯繫我們,更多接入文檔可訪問 docs.apiyi.com 文檔中心

延伸閱讀

Similar Posts