Gemini 4 Carbon、APIを正式公開：呼び出しエンドポイント、モデルID、発売時の価格ウィンドウ一覧（5ステップで接続）

作者注：本記事では、Gemini 4 Carbon の公式 API の入口、モデル ID、呼び出し方法、そして発売記念価格の期間を整理します。11 月 30 日の優待期限までに、開発者が導入を検討するための材料としてお使いください。

導入前に知っておきたい 7 つの用語

Google は 2026 年 11 月 10 日に「Gemini 4 Carbon is now available」を公開し、Gemini 4 Carbon を Gemini API の有料開発者向けに正式に開放すると発表しました。10 月 28 日に初めて公表されて以降、このモデルは選ばれた一部のサイバーセキュリティ防御担当者にしか提供されていませんでした。

ここでは、単なるモデル発表ニュースの焼き直しはしません。開発者が本当に知りたい 4 つのポイントに絞って解説します。Gemini 4 Carbon の呼び出し入口はどこか、モデル ID には何を指定するのか、コードはどう書くのか、そして発売記念価格はいつ終わるのかです。

この記事で得られること：5 つのステップで Gemini 4 Carbon の API 導入を完了できます。さらに、API の有料利用権限、一般向けサブスクリプションの権限、実際のタスクにかかるコストという 3 つの違いも整理できます。

Gemini 4 Carbon が正式公開：開発者が直接呼び出せるようになりました

Gemini 4 Carbon は Google DeepMind が開発したモデルで、Gemini 4 Argon をベースに構築されています。高難度の推論、複雑なソフトウェアエンジニアリング、長期にわたる Agent ワークフロー、科学研究、サイバーセキュリティ防御に向けたフラッグシップの推論モデルという位置づけです。特徴は、より多くの思考トークンを使い、複雑なタスクに対して仮説の探索、計画、実行、検証、修正まで行える点にあります。

11月10日の正式公開では、複数のチャネルが対象となりました。開発者は Gemini API の有料プラン、Google AI Studio、Android Studio から利用できます。企業は Gemini for business を通じて利用権限を取得できます。一般ユーザーの場合は、Google AI Ultra のサブスクリプションに加入すると、Gemini アプリ、Google Antigravity、Google 検索の AI モードで利用できます。一般の開発者にとって最も大きな変化は、有料 API を有効にすれば、Carbon を直接呼び出せることです。

Gemini 4 Carbon 導入の重要ポイント

Gemini 4 Carbon と Argon の使い分け

注意したいのは、Carbon が Argon を全面的に置き換えるものではないという点です。Google は、ソフトウェアエンジニアリングやナレッジワークの大半のタスクには、引き続き Gemini 4 Argon が最適だと明言しています。Carbon が向いているのは、より深い推論、より長時間の実行、より複雑な検証が必要なタスクです。

そのため、導入を計画するうえでは、Carbon をアーキテクチャ設計、複雑なコード監査、サブシステムをまたいだ根本原因の調査といった「難しいタスク」に充て、通常のコード生成やバッチ処理は、より高速で軽量なモデルに任せるのが現実的です。これは、Google が Antigravity のマルチ Agent プレビュー機能 /swarm でも推奨している使い分けです。

Gemini 4 Carbon のAPI呼び出し口はどこにある？

Gemini 4 Carbon の公式な接続ルートは、Google AI Studio に集約されています。流れは次の5ステップで、それぞれ決まったページや設定項目に対応しています。

1. Google AI Studio にアクセスする：Google アカウントで AI Studio にログインします。
2. APIキーを作成する：API Keys ページを開き、Carbon を呼び出すための新しいキーを作成します。
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 アプリで Carbon を使えるか」と「API 経由で Carbon を呼び出せるか」が混同されがちです。実際にはまったく別の経路です。下の表で、チャネルごとの条件を整理しました。

ひとことでまとめると、開発者が Carbon を呼び出すのに Ultra の購入は不要で、一般ユーザーがアプリで Carbon を使う場合にだけ Ultra が必要です。なお、Google AI サブスクリプションに付いてくる Google Cloud Developer Credits（たとえば AI Pro の毎月 $10 分）は、Cloud 開発者プログラムの特典です。Carbon 専用の無料トークン枠と同じものではなく、どのサービスに充当できるかは、サービス、地域、アカウントの条件ごとに確認が必要です。

API 経由で Gemini 4 Carbon を呼び出す方法：クイックスタート

公式推奨：Interactions API の最小サンプル（Python）

Google は現在、新規プロジェクトでは Interactions API を優先して使うことを推奨しています。Interactions API なら、モデル呼び出し、ツールのオーケストレーション、マルチターンのやり取り、Agent ワークフローをまとめて扱えます。従来の GenerateContent API も引き続きサポートされています。以下は、公式の Interactions サンプルをもとに整形し直した Python コードです。元の補足資料のコードは 1 行に貼り付けられていたため、そのままでは実行できませんでした。

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 で作成したキーを環境変数 GEMINI_API_KEY に設定してください。genai.Client() が自動的に読み取ります。なお、このサンプルで修正したのは書式のみです。今回のモデル呼び出しを実際に実行して検証してはいませんので、最新の書き方は公式ドキュメントでご確認ください。

REST API の呼び出し例

プロジェクトにSDKを導入しにくい場合は、公式のRESTエンドポイント https://generativelanguage.googleapis.com/v1beta/interactions に直接リクエストできます。APIキーは x-goog-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 の3つです。公開モデル gemini-4-carbon のデフォルトは MEDIUM です。このパラメータをリクエストボディのどこに指定するかは、公式ドキュメント「What’s new in Gemini 4 Carbon」を参照してください。3つのレベルの代表的な用途は次のとおりです。

• low：分類、要約、メタデータ抽出などの軽量なタスク
• medium：一般的なコード作成、ツール呼び出し、ドキュメントQA、動画理解
• high：複数ファイルにまたがるソフトウェアエンジニアリング、アーキテクチャ設計、形式的証明、脆弱性の発見

既存のコードを移行するときは、次の点に注意してください。Carbon では thinking_budget がサポートされておらず、指定すると HTTP 400 が返ります。また、MINIMAL の推論レベルも使えません。

OpenAI互換インターフェースで呼び出す（提供状況はプラットフォームの掲載情報をご確認ください）

すでにOpenAI SDKでプロジェクトを構築していて、1つのキーで複数社のモデルをまとめて管理したい場合は、OpenAI互換の集約インターフェースも使えます。以下の例は書き方を示すためのものです。gemini-4-carbon が利用できるかどうか、実際のモデル名が何になるかは、プラットフォームのモデル一覧でご確認ください。

import openai

client = openai.OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.apiyi.com/v1"  # APIYI の 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、そのほかのベンダーのモデルを横並びで比較したい場合は、APIYI（apiyi.com）を使えば、同じキーと統一された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トークン以上になると、キャッシュが効く可能性があります。実際の運用では、システムプロンプト、ツール宣言、固定の参照ドキュメントをリクエストの先頭に置いて変更せず、毎回変わるユーザー入力は末尾に置くと、キャッシュヒット率を高められます。

Gemini 4 Carbon のローンチ価格期間と 12 月 1 日の価格改定

Gemini 4 Carbon の価格では、2 つの日付を押さえておく必要があります。2026 年 11 月 30 日まではローンチ価格、2026 年 12 月 1 日から入力・出力ともに価格が 2 倍になります。以下の価格はすべて Google AI Studio の公式 API 料金ページに基づくもので、単位は米ドル / 100 万トークン、Google 公式サービスの基準です。

表を見ると、キャッシュ入力の価格は通常の入力価格より 95% 安くなっています。Batch と Flex の単価は Standard の半額で、リアルタイム性が求められないオフラインタスクに向いています。Priority は価格が高い分、レイテンシや安定性が特に重要な本番環境に適しています。

Gemini 4 Carbon の実際の請求額はどう計算する？

単価はあくまで出発点です。Carbon の実際の費用には、さらに次の 3 つの要素が影響します。

• 思考トークンは出力料金に含まれる：medium や high のレベルで生成される推論過程は、出力単価で課金されます。そのため、ユーザーに見える最終的な回答の長さだけでは請求額を見積もれません。
• Grounding で追加コストが発生する：Grounding を使うと、内部のツールシステム指示や関数宣言も課金対象になります。Google Search Grounding には毎月 5,000 回の無料リクエスト枠があり（Gemini 3 以降のモデルと共有）、超過分は 1,000 回あたり 14 ドルです。1 回のユーザーリクエストで複数回の検索が行われることもあります。
• キャッシュヒット率：暗黙的キャッシュにヒットした入力部分はキャッシュ価格で課金されるので、構造のよいプロンプトを書けば長いコンテキストのコストを大きく抑えられます。

仮の試算を見てみましょう。ある 1 回のリクエストで、入力が 20,000 トークン、思考と最終出力の合計が 8,000 トークンだったとします（キャッシュとツール呼び出しは考慮しません）。ローンチ時の Standard 価格なら 0.02 × $2 + 0.008 × $10 = $0.12 ほどです。12 月 1 日以降は、同じ使用量で約 $0.24 になります。思考トークンが増えるほど、出力側の費用が占める割合も大きくなります。

サードパーティのデータもこの点を裏付けています。Artificial Analysis が $4 / $20 の標準価格で算出したところ、Carbon の Intelligence Index v5.0.1 における評価タスク 1 件あたりの平均コストは、Low が約 $7.19、Medium が約 $6.59、High が約 $7.76 でした。Medium のタスクコストが Low より低くなっていることから、レベルとコストは単純な比例関係にないことがわかります。なお、これらの数字は総合評価タスクの平均値であり、通常の 1 回のリクエストの価格を表すものではありません。

💰 コストのアドバイス：本番リリース前に、実際のタスクを少量用意して low・medium・high の 3 つのレベルをそれぞれ試し、思考トークンと出力トークンの比率を記録したうえで、デフォルトのレベルを決めることをおすすめします。複数社のモデルを併用しているプロジェクトなら、APIYI（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 の最初の回答トークンが返るまでの時間は約 67.54 秒で、リアルタイムのチャットモデルをそのまま置き換えるのには向きません。
4. ハルシネーションは依然として起こりえます：Google は、Carbon がいまだにハルシネーションを起こす可能性があること、またプロンプトインジェクション対策にも改善の余地があることを認めています。重要な業務では検証プロセスを必ず残してください。
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 でキーを作成し、Cloud Billing を紐付ければ利用できます。
• 価格の期間：11月30日までは $2 / $10、12月1日からは $4 / $20（いずれも100万トークンあたり）です。
• 権限の違い：API 呼び出しに Ultra は不要です。アプリ内で Carbon を使う場合のみ、Ultra サブスクリプションが必要です。
• コストのポイント：思考トークンは出力に含まれます。実際の請求額は、思考レベル、ツール呼び出し、キャッシュによって変わります。
• 複数モデルの比較：APIYI（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日からは全体が2倍になります。予算を見積もるときは、思考トークンも出力コストに含めて計算してください。

発売記念の価格期間中に評価を終えたい場合は、まず medium レベルで実際のタスクを一通り実行し、トークンの内訳を記録してから本番の設定を決めるのがおすすめです。複数のモデルを横並びで比較したいときは、APIYI（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 技術チーム
技術交流：APIYI 公式サイトのトップページからお気軽にお問い合わせください。接続に関する詳しい資料は docs.apiyi.com のドキュメントセンターでご覧いただけます。