11月10日に Gemini 4 Carbon が公開されたあと、12月1日の値上げ前に Interactions API の JSON で thinking_level、background、usage をどう置くか

有料枠のみ。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日までの導入価格は入力 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_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 トークンを超えるには、トップレベルの 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

  1. 本文が gemini-4-carbon で、thinking_level は low、medium、high のいずれか。temperature、top_p、top_k、thinking_budget、cached_content がない。
  2. 64K トークンを超える呼び出しは background: true と 65536 を超える max_output_tokens を両方持つ。
  3. パーサはすべての model_output の text を連結し、status を残す。
  4. 請求は入力、キャッシュ入力、出力、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 トークンは可視出力と分けて請求し、サンプリング項目と明示キャッシュは送る前に外します。