Gemini 4 Carbon 正式開放 API：調用入口、模型 ID 與首發價格窗口一覽（5 步接入）

作者注：本文梳理 Gemini 4 Carbon 的官方 API 入口、模型標識、調用方式和首發價格時間窗口，幫助開發者在 11 月 30 日優惠截止前完成接入評估。

接入前需要知道的 7 個術語

Google 於 2026 年 11 月 10 日發佈《Gemini 4 Carbon is now available》，宣佈 Gemini 4 Carbon 正式向 Gemini API 付費開發者開放。在此之前，這款模型自 10 月 28 日首次公佈後，只面向經過篩選的部分網絡安全防禦者開放。

這不是又一篇模型發佈新聞的複述。本文只聚焦開發者真正關心的四件事：Gemini 4 Carbon 的調用入口在哪裏、模型 ID 怎麼填、代碼怎麼寫，以及首發價格窗口什麼時候結束。

核心價值：讀完本文，你可以在 5 個步驟內完成 Gemini 4 Carbon 的 API 接入，並清楚區分 API 付費權限、消費者訂閱權限和真實任務成本這三件事。

Gemini 4 Carbon 正式開放：開發者現在可以直接調用

Gemini 4 Carbon 由 Google DeepMind 開發，基於 Gemini 4 Argon 構建，定位是面向高難度推理、複雜軟件工程、長週期 Agent 工作流、科學研究和網絡安全防禦的旗艦推理模型。它的特點是能夠消耗更多思考 Token，對複雜任務進行假設探索、規劃、執行、驗證和修復。

11 月 10 日的正式開放覆蓋了多條渠道。開發者可以通過 Gemini API 付費層、Google AI Studio 和 Android Studio 使用；企業可以通過 Gemini for business 獲得權限；消費者需要 Google AI Ultra 訂閱，才能在 Gemini App、Google Antigravity 和 Google Search AI Mode 中使用。對普通開發者來說，最重要的變化是：只要開通付費 API，就可以直接調用 Carbon。

Gemini 4 Carbon 接入核心要點

Gemini 4 Carbon 與 Argon 的分工

需要注意，Carbon 並不是用來全面替代 Argon 的。Google 明確表示，Gemini 4 Argon 仍然是大多數軟件工程和知識工作任務的理想選擇；Carbon 更適合需要更深入推理、更長時間執行和更復雜驗證的任務。

因此在接入規劃上，比較合理的做法是把 Carbon 放在架構設計、複雜代碼審計、跨子系統根因排查等“難任務”上，而常規代碼生成和批量處理繼續交給更快、更輕量的模型。這也是 Google 在 Antigravity 的 /swarm 多 Agent 預覽功能中推薦的分工方式。

Gemini 4 Carbon API 調用入口在哪裏

Gemini 4 Carbon 的官方接入路徑集中在 Google AI Studio。整個流程可以拆成 5 步，每一步都對應一個明確的頁面或配置項：

1. 進入 Google AI Studio：使用 Google 賬號登錄 AI Studio。
2. 創建 API Key：打開 API Keys 頁面，新建一個用於 Carbon 調用的 Key。
3. 開通付費層級：設置 Google Cloud Billing，配置支付方式。Carbon 沒有免費 API 層，這一步不能跳過。
4. 選擇 Gemini 4 Carbon：在 Playground 中直接選擇 gemini-4-carbon 試用，或在 SDK 中填寫該模型 ID。
5. 開始調用：使用 Python SDK、JavaScript SDK 或 REST API 發起請求。

Gemini 4 Carbon 的 API 權限與訂閱權限

很多開發者在 Hacker News 和 Reddit 上的討論，都把“能不能在 Gemini App 裏用 Carbon”和“能不能通過 API 調用 Carbon”混在一起。實際上這是兩條完全獨立的路徑，下表把各渠道的條件拆開說明。

一句話總結：開發者調用 Carbon 不需要購買 Ultra，消費者在 App 裏用 Carbon 才需要 Ultra。另外，Google AI 訂閱附帶的 Google Cloud Developer Credits（例如 AI Pro 每月 $10）屬於 Cloud 開發者計劃權益，不能等同於 Carbon 專屬的免費 Token 額度，具體抵扣資格要按服務、地區和賬戶條件確認。

如何通過 API 調用 Gemini 4 Carbon：快速上手

官方推薦：Interactions API 極簡示例（Python）

Google 當前推薦新項目優先使用 Interactions API，它可以統一處理模型調用、工具編排、多輪交互和 Agent 工作流，傳統的 GenerateContent API 仍然受支持。下面是依據官方 Interactions 示例整理排版後的 Python 代碼，原始補充資料中的版本被粘貼成了一行，無法直接執行。

from google import genai

client = genai.Client()
interaction = client.interactions.create(
    model="gemini-4-carbon",
    input="Write a Three.js script that renders a 3D scene."
)
print(interaction.output_text)

運行前先執行 pip install google-genai，並把 AI Studio 中創建的 Key 設置爲環境變量 GEMINI_API_KEY，genai.Client() 會自動讀取。需要說明的是，本示例僅修復了排版，我們沒有對這次模型調用做實際運行驗證，請以官方文檔的最新寫法爲準。

REST API 調用示例

如果你的項目不方便引入 SDK，可以直接請求官方 REST 端點 https://generativelanguage.googleapis.com/v1beta/interactions,通過 x-goog-api-key 請求頭傳入 API Key:

curl "https://generativelanguage.googleapis.com/v1beta/interactions" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H "Content-Type: application/json" \
  -X POST \
  -d '{
    "model": "gemini-4-carbon",
    "input": "Hello"
  }'

JavaScript 項目使用 @google/genai 包，調用方法同樣是 client.interactions.create()，模型 ID 和輸入字段的含義與 Python 一致。

設置 Gemini 4 Carbon 的思考檔位 thinking_level

Carbon 提供 thinking_level 參數，可選值爲 low、medium、high，公開模型 gemini-4-carbon 默認是 MEDIUM。參數在請求體中的具體字段位置，請以官方 “What’s new in Gemini 4 Carbon” 文檔爲準。三個檔位的典型用途如下：

• low：分類、摘要、元數據提取等輕量任務；
• medium：常規代碼、工具調用、文檔問答、視頻理解；
• high：多文件軟件工程、架構設計、形式化證明、漏洞發現。

遷移舊代碼時要特別注意：thinking_budget 在 Carbon 上不受支持，傳入會返回 HTTP 400；MINIMAL 推理檔位同樣不可用。

通過 OpenAI 兼容接口調用（以平臺上線情況爲準）

如果你的項目已經基於 OpenAI SDK 搭建，並且希望用一個 Key 同時管理多家模型，也可以使用 OpenAI 兼容的聚合接口。下面的示例僅展示寫法，gemini-4-carbon 是否可用、實際模型名稱是什麼，請以平臺模型列表爲準：

import openai

client = openai.OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.apiyi.com/v1"  # API易 OpenAI 兼容接口
)

response = client.chat.completions.create(
    model="gemini-4-carbon",  # 示例名稱,以平臺模型列表爲準
    messages=[{"role": "user", "content": "用三句話解釋什麼是長週期 Agent。"}]
)
print(response.choices[0].message.content)

import openai
from typing import Optional, List

def call_model(
    prompt: str,
    models: List[str],
    system_prompt: Optional[str] = None,
    max_tokens: int = 4096
) -> str:
    """
    按順序嘗試多個模型,第一個成功即返回。
    適合在新模型上線初期做平滑回退。
    """
    client = openai.OpenAI(
        api_key="YOUR_API_KEY",
        base_url="https://api.apiyi.com/v1"
    )

    messages = []
    if system_prompt:
        messages.append({"role": "system", "content": system_prompt})
    messages.append({"role": "user", "content": prompt})

    last_error = None
    for model in models:
        try:
            response = client.chat.completions.create(
                model=model,
                messages=messages,
                max_tokens=max_tokens
            )
            return f"[{model}] " + response.choices[0].message.content
        except Exception as e:
            last_error = e
            continue
    return f"Error: {last_error}"

# 使用示例:模型名稱以平臺模型列表爲準
result = call_model(
    prompt="審查這段架構設計中的單點故障風險。",
    models=["gemini-4-carbon", "gemini-4-argon"],
    system_prompt="你是一名資深後端架構師,回答要具體、可執行。"
)
print(result)

🚀 快速上手建議：如果你需要在 Carbon、Argon 以及其他廠商模型之間做橫向對比，可以通過 API易 apiyi.com 用同一個 Key 和統一的 OpenAI 兼容接口完成切換，新用戶有免費測試額度。Gemini 4 Carbon 的具體上線時間和模型名稱，請以平臺控制檯公佈的信息爲準。

Gemini 4 Carbon API 支持哪些能力

根據 Google AI Studio 的 Carbon 模型文檔和官方模型卡，Carbon 是一個“多模態輸入、文本輸出”的推理模型，同時具備完整的 Agent 開發工具鏈。下表彙總了接入時最常用的規格參數。

Gemini 4 Carbon 的參數兼容性限制

Carbon 對部分常用採樣參數的處理與舊模型不同，遷移代碼時容易踩坑。根據 Google Cloud 開發者指南：temperature、top_p、top_k 會被忽略；frequency_penalty、presence_penalty 不受支持；candidate_count 大於 1 會返回錯誤。

緩存方面，Carbon 不支持顯式 Context Caching，但支持自動隱式緩存。當請求之間共享的提示詞前綴達到 4096 Token 及以上時，就有機會觸發緩存。實踐中，建議把系統提示詞、工具聲明、固定參考文檔放在請求最前面並保持不變，把每次變化的用戶輸入放在末尾，以提高緩存命中率。

Gemini 4 Carbon 首發價格窗口與 12 月 1 日價格變化

Gemini 4 Carbon 的價格有兩個必須記住的時間節點：2026 年 11 月 30 日前爲首發價格，2026 年 12 月 1 日起輸入和輸出價格均上漲一倍。以下價格均來自 Google AI Studio 官方 API 定價頁面，單位爲美元 / 每百萬 Token，爲 Google 官方服務口徑。

從表中可以看到，緩存輸入價格相當於普通輸入價格的 95% 折扣。Batch 和 Flex 的單價是 Standard 的一半，適合對實時性要求不高的離線任務；Priority 價格更高，適合對延遲和穩定性更敏感的生產場景。

Gemini 4 Carbon 的實際賬單怎麼算

單價只是起點，Carbon 的實際費用還受三個因素影響：

• 思考 Token 計入輸出費用：模型在 medium 或 high 檔位下產生的推理過程按輸出單價計費，賬單不能只按用戶看到的最終回答長度估算。
• Grounding 會帶來額外開銷：使用 Grounding 時，內部工具系統指令和函數聲明也會計入計費。Google Search Grounding 每月有 5,000 次免費請求額度，與 Gemini 3 及更新模型共享，超出後每 1,000 次收費 14 美元，一次用戶請求可能觸發多次搜索。
• 緩存命中率：隱式緩存命中的輸入部分按緩存價格計費，結構良好的提示詞能明顯降低長上下文成本。

舉一個假設性的估算：某次請求輸入 20,000 Token，思考加最終輸出共 8,000 Token，不考慮緩存和工具調用。按首發 Standard 價格計算約爲 0.02 × $2 + 0.008 × $10 = $0.12；12 月 1 日後同樣用量約爲 $0.24。思考 Token 越多，輸出側費用佔比就越高。

第三方數據也印證了這一點。Artificial Analysis 按 $4 / $20 標準價格測算，Carbon 在其 Intelligence Index v5.0.1 中每個評測任務的平均成本爲：Low 約 $7.19、Medium 約 $6.59、High 約 $7.76。Medium 的任務成本反而低於 Low，說明檔位與成本並非線性關係，這些數字是綜合評測任務的平均值，不代表單次普通請求的價格。

💰 成本建議：正式上線前，建議先用小批量真實任務分別測試 low、medium、high 三個檔位，記錄思考 Token 和輸出 Token 的比例，再決定默認檔位。如果項目同時使用多家模型，也可以藉助 API易 apiyi.com 的統一計費面板對比不同模型的實際消耗。

接入 Gemini 4 Carbon 前需要注意什麼

在正式寫進生產代碼之前，下面幾條邊界條件值得逐一覈對：

1. 沒有免費 API 層:AI Studio Playground 可以選擇 Carbon 試用，但 Carbon 本身不提供免費 API 層，調用需要付費賬戶。
2. Ultra 訂閱不是 API 前提：開發者無需購買 Google AI Ultra；反過來，Ultra 訂閱也不能替代 API 賬單。
3. 響應延遲偏高：模型卡提示高推理檔位可能出現較慢響應和超時。Artificial Analysis 測得 Carbon High 首個回答 Token 時間約 67.54 秒，不適合直接替代實時聊天模型。
4. 仍可能出現幻覺:Google 承認 Carbon 仍可能產生幻覺，Prompt Injection 防護也仍需改進，關鍵業務要保留校驗環節。
5. 網絡安全專項能力有門檻：官方公佈的漏洞發現成績反映的是通過 Fairwind Program 使用時的專項能力，不能等同於普通 API 的無條件開放能力。
6. 價格快照有時效：本文價格與權限信息基於 2026 年 11 月 11 日的資料，後續請以官方頁面爲準。

常見問題 FAQ

Gemini 4 Carbon 核心要點 Key Takeaways

• 正式開放:2026 年 11 月 10 日起，Gemini API 付費開發者可直接調用 Carbon。
• 模型 ID：穩定 ID 爲 gemini-4-carbon，官方推薦用 Interactions API 接入。
• 調用入口:Google AI Studio 創建 Key，綁定 Cloud Billing 後即可使用。
• 價格窗口:11 月 30 日前 $2 / $10,12 月 1 日起 $4 / $20（每百萬 Token）。
• 權限區分:API 調用不需要 Ultra，App 內使用 Carbon 才需要 Ultra 訂閱。
• 成本關鍵：思考 Token 計入輸出，實際賬單取決於檔位、工具調用和緩存。
• 多模型對比：可藉助 API易 apiyi.com 統一接口測試，Carbon 上線情況以平臺公佈爲準。

總結

Gemini 4 Carbon 正式開放 API 的核心要點：

1. 入口明確:Google AI Studio → API Keys → Cloud Billing → 選擇 gemini-4-carbon → 發起調用，5 步即可完成接入。
2. 接口優先級：新項目優先使用 Interactions API，GenerateContent 仍受支持，遷移時注意 thinking_budget 等參數已不可用。
3. 價格節點:11 月 30 日前是首發價格窗口，12 月 1 日起全線翻倍，評估預算時要把思考 Token 算進輸出成本。

如果你計劃在首發窗口內完成評估，建議先用 medium 檔位跑一批真實任務，記錄 Token 結構後再決定生產配置。需要在多家模型之間橫向對比時，推薦通過 API易 apiyi.com 統一接入測試，Gemini 4 Carbon 是否可用請以平臺模型列表爲準。

📚 參考資料

1. Gemini 4 Carbon 正式開放公告:Google 官方博客
2. 鏈接： blog.google/innovation-and-ai/models-and-research/gemini-models/gemini-4-carbon-now-available

3. 說明： 正式開放時間、各渠道權限與價格變化

4. Gemini 4 Carbon API 模型文檔:Google AI Studio

5. 鏈接： aistudio.google.com/docs/models/gemini-4-carbon

6. 說明： 模型 ID、輸入輸出模態、上下文與工具能力

7. What’s new in Gemini 4 Carbon:Google AI Studio 接入指南

8. 鏈接： aistudio.google.com/docs/whats-new-gemini-4-carbon

9. 說明： Interactions API 示例與 thinking_level 參數

10. Gemini API 定價:Google AI for Developers

11. 鏈接： ai.google.dev/gemini-api/docs/pricing

12. 說明： Standard、Batch、Flex、Priority 與緩存價格

13. Gemini 4 Carbon 開發者指南:Google Cloud

14. 鏈接： docs.cloud.google.cn/gemini-enterprise-agent-platform/models/guides/gemini-4-carbon

15. 說明： 參數限制、Long Decode 與隱式緩存規則

16. Gemini 4 Carbon 模型卡:Google DeepMind

17. 鏈接： deepmind.google/models/model-cards/gemini-4-carbon

18. 說明： 技術參數、知識截止日期與已知限制

19. Gemini 4 Carbon 獨立模型分析:Artificial Analysis

20. 鏈接： artificialanalysis.ai/models/gemini-4-carbon
21. 說明： 不同思考檔位的任務成本與延遲數據

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