model を gemini-4-carbon に変えても、リクエストは完成しません。 2026年11月10日、Google は有料の Gemini API、Google AI Studio、AI Ultra 加入者向け Antigravity で Gemini 4 Carbon を公開しました。11月30日までの導入価格は入力 100万トークンあたり $2、出力 $10 で、出力には thinking トークンが含まれます。12月1日から $4 と $20 です。暗黙キャッシュのヒットは 95% 引き($0.10、その後 $0.20)。Carbon は無料枠にありません。
この記事は 2026年11月13日時点で、11月10日の開発者ガイドと What's new に基づきます。3日前に 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 トークンの一つの窓を共有します。同期応答は、長いデコードを選ばない限り 65,536 トークンで止まります。
gemini-4-argon は同じ窓、同じ thinking_level、組み込みツール、同じ導入単価です。Carbon はターンごとに thinking トークンを多く使います。対話的なコーディングは Argon に残し、原因究明、設計、検証ループを Carbon に回します。
| 期間 | 入力 / 100万 | 出力(thinking を含む)/ 100万 | キャッシュ入力 / 100万 |
|---|---|---|---|
| 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 トークンを超えるには、トップレベルの 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 と開発者ガイドはモデル ID だけでなく JSON を変えるよう求めています。
temperature、top_p、top_kは無視されます。開発者ガイドは非推奨の警告が返ると書いています。- 明示的な
cached_contentとcaches.createを外します。暗黙キャッシュは 4,096 トークンから始まり、ヒットは 95% 引きです。 thinking_budgetをthinking_levelに置き換えます。max_output_tokensが 32,768 未満なら、少なくとも 32,768 に上げます。トークンを減らすなら思考レベルを下げます。- 難しいプロンプトは数分かかることがあります。background を使うか、HTTP クライアントのタイムアウトを 15 分以上にします。
独自の JSON Schema は応答スキーマの項目に残します。Gemini API で構造化 JSON を作る と 構造化出力とは何か を参照してください。Carbon は判定を確率にはしません。それは別エンドポイントです。
12月1日の価格改定前の usage
完了した interaction は usage を持ちます。公開サンプルでは入力 7 + 出力 20 + thought 22 が 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 の検索クエリは別課金で、ツール説明も処理トークンに入ります。usage オブジェクト全体を保存すれば、12月1日の価格を既存ログに適用できます。
Argon の振り分けと agent_config
モデルは設定で分け、全体を一つにしないでください。Argon は同じ定価の速い経路、Carbon は thinking トークンを使うターンです。
{
"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 トークンを超える呼び出しは
background: trueと 65536 を超えるmax_output_tokensを両方持つ。 - パーサはすべての
model_outputの text を連結し、statusを残す。 - 請求は入力、キャッシュ入力、出力、thought を分け、12月1日の単価を用意する。
ローカルでは JSON バリデーター、JSONPath($.usage.total_thought_tokens)、JSON Diff で前のリクエストと比べます。アップロードされません。
FAQ
gemini-4-carbon は無料枠ですか?
いいえ。What's new は有料枠のみと書いています。導入価格 $2/$10 は 2026年11月30日まで、その後は $4/$20 です。
thinking_level に xhigh を送れますか?
Carbon ガイドにあるのは low、medium、high です。minimal と xhigh は他モデル向けの Interactions 列挙です。Claude の effort をこの項目へコピーしないでください。
答えが 64K トークンで止まるのはなぜですか?
同期応答は 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 を保持しますか?
しません。次の interaction で generation_config、tools、system_instruction を送り直します。id が保つのは履歴です。
明示キャッシュは残せますか?
残せません。cached_content を外します。暗黙キャッシュは 4,096 トークンからで、ヒットは 95% 引きです。
まとめ
2026年11月10日に公開された Carbon が変えるのは、モデルがどれだけ考えるかと、11月30日以降の支払いです。 gemini-4-carbon と thinking_level の low、medium、high を使います。64K を超える答えには background: true と 65536 を超える max_output_tokens を組にします。thought トークンは可視出力と分けて請求し、サンプリング項目と明示キャッシュは送る前に外します。