Google 11 月 10 日開放 Gemini 4 Carbon 之後,Interactions API 的 JSON 該如何設定 thinking_level、background 長輸出和 usage,趕在 12 月 1 日漲價之前?

僅付費層。11 月 30 日前 $2/$10,其後 $4/$20。thinking_level 為 low、medium 或 high;長輸出需要 background 和更高的 max_output_tokens。

把 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_levelCarbon 指南建議的用途
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

  1. 請求本文是 gemini-4-carbon,thinking_level 為 low、medium 或 high,且沒有 temperature、top_p、top_k、thinking_budget、cached_content。
  2. 必須超過 64K token 的呼叫同時寫了 background: true 與高於 65536 的 max_output_tokens。
  3. 解析器接上每一個 model_output 的 text,並記下 status。
  4. 帳單分開記輸入、快取輸入、輸出與 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 與可見輸出分開記帳,取樣欄位與明確快取在請求送出前刪掉。