把 model 改成 gemini-4-carbon 並不等於請求寫完了。 2026 年 11 月 10 日,Google 在付費 Gemini API、Google AI Studio,以及 AI Ultra 訂閱的 Antigravity 中開放 Gemini 4 Carbon。促銷價到 11 月 30 日為止:輸入每百萬 token $2,輸出每百萬 $10,輸出含 thinking token。12 月 1 日起改為 $4 與 $20。隱式快取命中打 95 折($0.10,之後 $0.20)。Carbon 不在免費層。
本文寫於 2026 年 11 月 13 日,依據 11 月 10 日的開發者指南與 What's new。三天前我們寫過 Fable 5.2 的 effort 與 usage。Carbon 的開關在 Interactions API:generation_config.thinking_level、background 與 usage。
11 月 10 日開放了什麼
Google 把 Carbon 放在長程工程、密集多模態檔案與科學工作上,稱為最強推理模型。模型 ID 是 gemini-4-carbon。預設思考檔位是 medium。輸入、thinking 與輸出共用 1,048,576 token 視窗。同步回應仍在 65,536 token 停下,除非你打開長輸出。
gemini-4-argon 共用這扇視窗、同一組 thinking_level、內建工具,以及同一檔促銷單價。Carbon 每一輪會花更多 thinking token。互動式程式留在 Argon。根因、架構與驗證迴圈再交給 Carbon。
| 時段 | 輸入 / 百萬 | 輸出(含 thinking)/ 百萬 | 快取輸入 / 百萬 |
|---|---|---|---|
| 截至 2026 年 11 月 30 日 | $2 | $10 | $0.10 |
| 2026 年 12 月 1 日起 | $4 | $20 | $0.20 |
請求 JSON 與 thinking_level
POST https://generativelanguage.googleapis.com/v1beta/interactions,帶標頭 x-goog-api-key 與 Content-Type: application/json。深度寫在 generation_config.thinking_level,不是數字預算。
{
"model": "gemini-4-carbon",
"input": "Analyze this payment pipeline for race conditions during retries and rewrite the locks.",
"generation_config": {
"thinking_level": "medium"
}
}
| thinking_level | Carbon 指南建議的用途 |
|---|---|
| low | 路由、分類、定點抽取 |
| medium | 預設。多數程式與 agent 回合 |
| high | 根因除錯、形式化數學、架構 |
不寫 thinking_level 時,伺服端用 medium。Carbon 指南寫明的值是 low、medium、high。Interactions 的公共列舉裡還有 minimal 與 xhigh,那是給其他模型的;Carbon 頁面沒列出之前不要送。thinking_budget 已棄用,會回傳警告。max_output_tokens 把 thinking 與可見文字算在一起,上限太低會在推理結束前截斷答案。
background 與長輸出
要超過 65,536 token,把頂層 background 設為 true,並把 max_output_tokens 設到 65536 以上。上限是 1,048,576 減去輸入。background: true 但不寫 max_output_tokens,仍然停在 64K。
{
"model": "gemini-4-carbon",
"input": "Write a complete proof of the prime number theorem.",
"background": true,
"generation_config": {
"thinking_level": "high",
"max_output_tokens": 262144
}
}
Carbon 指南在 status 為 in_progress 或 queued 時輪詢。Interaction 資源還有 completed、failed、cancelled、incomplete、requires_action、requires_continuation。incomplete 表示撞上了上限。HTTP 上用 GET /v1beta/interactions/{id} 讀取。入門文件裡的背景範例在這次 GET 上帶了標頭 Api-Revision: 2026-05-20。
長輸出的每一跳都會再追加一個 type: model_output 的 steps[]。把所有 text 接起來。只讀 steps[0] 會丟掉後面的段。previous_interaction_id 只延續歷史,不會重放 generation_config、tools 或 system_instruction;下一輪要再寫 thinking_level。預設 store 為 true(付費層保留 interaction 55 天)。store: false 不能和 background: true 一起用。
舊 Gemini JSON 裡要刪的欄位
從 Gemini 3 或更早遷過來時,What's new 與開發者指南要求改 JSON,而不只是改模型 ID:
temperature、top_p、top_k會被忽略。開發者指南說它們會回傳棄用警告。- 刪掉明確的
cached_content與caches.create。隱式快取從 4,096 token 開始,命中打 95 折。 - 用
thinking_level取代thinking_budget。 - 若
max_output_tokens低於 32,768,至少提到 32,768。要省 token 就降低 thinking 檔位。 - 難題可能要好幾分鐘。用 background,或把 HTTP 用戶端逾時設到至少 15 分鐘。
你自己的 JSON Schema 仍然走回應 schema 欄位。見 用 Gemini API 產生結構化 JSON 與 結構化輸出是什麼。Carbon 不會把判斷變成機率;那是另一個端點。
12 月 1 日漲價前怎麼記 usage
完成的 interaction 帶 usage。公開範例裡 7 個輸入 + 20 個輸出 + 22 個 thought token 等於 total_tokens 49,所以 total_thought_tokens 不在 total_output_tokens 裡面。
{
"id": "v1_example",
"object": "interaction",
"model": "gemini-4-carbon",
"status": "completed",
"steps": [
{
"type": "model_output",
"content": [{ "type": "text", "text": "..." }]
}
],
"usage": {
"total_input_tokens": 7,
"total_cached_tokens": 0,
"total_output_tokens": 20,
"total_thought_tokens": 22,
"total_tool_use_tokens": 0,
"total_tokens": 49,
"input_tokens_by_modality": [{ "modality": "text", "tokens": 7 }]
}
}
未快取輸入按輸入價,total_cached_tokens 按該價格的 5%,total_output_tokens 加 total_thought_tokens 按輸出價。不要再加一次 total_tokens。Grounding 的搜尋查詢另行計費,工具說明也算已處理 token。把整個 usage 物件存下來,12 月 1 日的新價格才能套到已有日誌上。
Argon 路由與 agent_config
用設定拆開模型,不要全域只留一個。Argon 走快路徑,牌價相同;Carbon 接那些會花 thinking token 的回合。
{
"routes": [
{ "if": { "task": "interactive_coding" }, "model": "gemini-4-argon", "thinking_level": "medium" },
{ "if": { "task": "root_cause" }, "model": "gemini-4-carbon", "thinking_level": "high", "background": true }
]
}
託管 agent 把模型寫在 agent_config 裡。設了 model 時用 generation_config;agent_config 是另一條路。
{
"agent": "antigravity-preview-09-2026",
"environment": "remote",
"input": "Audit the site for Core Web Vitals and return a scorecard.",
"agent_config": {
"type": "antigravity",
"model": "gemini-4-carbon"
}
}
上線前要核對的 JSON
- 請求本文是
gemini-4-carbon,thinking_level為 low、medium 或 high,且沒有temperature、top_p、top_k、thinking_budget、cached_content。 - 必須超過 64K token 的呼叫同時寫了
background: true與高於 65536 的max_output_tokens。 - 解析器接上每一個
model_output的 text,並記下status。 - 帳單分開記輸入、快取輸入、輸出與 thought token,並準備好 12 月 1 日的價格。
在本機用 JSON 校驗、JSONPath($.usage.total_thought_tokens)與 JSON 對比 對照上一份請求。資料不會上傳。
常見問題
gemini-4-carbon 在免費層嗎?
不在。What's new 寫明 Carbon 只在付費層。促銷價 $2/$10 到 2026 年 11 月 30 日,之後是 $4/$20。
thinking_level 能寫 xhigh 嗎?
Carbon 指南只寫了 low、medium、high。minimal 與 xhigh 出現在給其他模型的 Interactions 列舉裡。不要把 Claude 的 effort 值抄進這個欄位。
為什麼答案停在 64K token?
同步回應停在 65,536。把 background 設為 true,並把 max_output_tokens 設到 65536 以上。只開 background 仍停在 64K。status 為 incomplete 表示撞上了上限。
帳單該用 total_tokens 嗎?
不要。未快取輸入按輸入價,total_cached_tokens 按 5%,total_output_tokens 加 total_thought_tokens 按輸出價。再加 total_tokens 會重複計算。
previous_interaction_id 會保留 thinking_level 嗎?
不會。下一輪要重送 generation_config、tools 與 system_instruction。這個 id 保留的是歷史。
明確的上下文快取還能留嗎?
不能。刪掉 cached_content。隱式快取從 4,096 token 開始,命中打 95 折。
小結
2026 年 11 月 10 日開放的 Carbon,改的是模型想多久,以及 11 月 30 日之後你付多少。 用 gemini-4-carbon,thinking_level 取 low、medium 或 high。答案必須超過 64K 時,background: true 要配上高於 65536 的 max_output_tokens。thought token 與可見輸出分開記帳,取樣欄位與明確快取在請求送出前刪掉。