· reAPI Team
Gemini 4 Carbon の使い方：利用方法、リクエストと制限
Gemini 4 Carbon の利用先、ネイティブの generateContent リクエストの書き方、考慮すべき出力上限を解説します。reAPI はこのモデルをホストしていません。
Gemini 4 Carbon は、Google がサイバーセキュリティの防御担当者向けに初めて公開してから2週間後の2026年11月10日、有料で利用する開発者にも提供されました。リクエスト用モデル ID は gemini-4-carbon で、テキスト、画像、動画、音声、PDF を入力として受け付け、テキストを返します。[1][2] 10月下旬に書かれたガイドの多くには、まだ利用できないと記載されています。内容をコピーする際は、日付を確認してください。
このガイドでは、現在の Gemini 4 Carbon の使い方を説明します。実行できるサービス、Gemini のネイティブ形式での初回リクエストの書き方、旧世代の Gemini モデルから移行する際につまずきやすい出力上限を扱います。reAPI はこのモデルの推論実行を提供しません。 reAPI の Gemini 4 Carbon の概要にはリクエストエディターがあり、サービス自体は SeedRouter で実行されます。
SeedRouter の Gemini 4 Carbon ページに進んでください。 そこで、自分のアカウントでの利用可否と現在の料金を確認します。以下のリクエストボディは Google と SeedRouter のドキュメントに基づいて作成したテンプレートであり、このガイドのために実際に行った呼び出しの記録ではありません。[3]
要点
- 開発者は Gemini API の有料枠で Gemini 4 Carbon を利用できます。無料枠では利用できません。Google AI Ultra の加入者は、Gemini アプリ、Google Antigravity、検索の AI Mode でも利用できます。[1][4]
- Gemini 4 Argon からの移行に必要なのはモデル ID の変更だけですが、Carbon は1ターンあたりの思考トークンをより多く消費するため、出力上限とクライアントのタイムアウトに余裕を持たせてください。[5]
- 主な制御項目は
thinkingLevelで、low、medium（デフォルト）、highから選びます。Temperature、top-p、top-k は無視されます。[5] - ストリーミングを使わない REST 呼び出しで返される出力は、1ホップあたり最大32,768トークンです。継続トークンなしでそれ以上を要求すると、400 エラーが返されます。[6]
- SeedRouter では、Gemini 4 Carbon は Gemini のネイティブ形式を使い、
generateContentとstreamGenerateContentで呼び出します。[3]
現在 Gemini 4 Carbon を利用できるサービス
Google の11月10日の発表には、複数の利用経路が記載されています。それぞれ製品もアカウントも異なります。Gemini アプリの Ultra サブスクリプションは API キーではなく、有料の API キーで一般ユーザー向けアプリが使えるようになるわけでもありません。[1]
| 利用経路 | 対象 | 必要なもの |
|---|---|---|
| Gemini API（Google AI Studio、Android Studio） | 開発者 | Gemini API の有料枠 |
| Gemini for business、Antigravity、CodeMender | 企業 | ビジネスアカウント |
| Gemini Enterprise Agent Platform | Google Cloud プロジェクト | Cloud プロジェクトと、グローバルエンドポイントまたは us / eu マルチリージョン[7] |
| Gemini アプリ、検索の AI Mode、Antigravity | 一般ユーザーと個人開発者 | Google AI Ultra サブスクリプション |
| Antigravity の研究者向け利用枠 | 科学者・研究者 | 申請の承認（6か月間、順次利用開始） |
| Fairwind Program | サイバーセキュリティの防御担当者 | 別モデルである Carbon for cyber 向けの申請の承認 |
| SeedRouter | サードパーティーのサービスを利用する開発者 | SeedRouter のアカウントとキー[3] |
無料で利用できるかという質問が最も多いのですが、API については利用できません。Google の料金ページでは、Gemini 4 Carbon のすべての項目について、無料枠は「利用不可」と記載されています。[4] 一般ユーザー向けの利用には通常の有料プランではなく、Ultra が必要です。
タスクに合わせて Carbon と Argon を選ぶ
Google は、ソフトウェアエンジニアリングや知識労働の大半には Argon が適しているとしています。Carbon は、大規模なコードベースにまたがる多段階のデバッグや、答えがあらかじめ定まらない研究など、モデルに高度な推論を求めるタスク向けです。検討と検証に Argon より多くのトークンを使います。[1] Google の移行ガイドも、実務上の指針として同じことを述べています。速い応答や1ターンあたりのトークン消費量の少なさを重視する場合は、Argon を使い続けてください。[5]
両モデルはリクエストスキーマが共通なので、2つのクライアントを保守せずに、難しいタスクを gemini-4-carbon に送り、日常的なリクエストは gemini-4-argon で処理できます。また、Google は Carbon の提供開始時のトークン料金を Argon と同額に設定しました。[1] ただし、Carbon はより長く思考するため、トークン単価が同じでも、同一のプロンプトで Carbon のほうが高額になることがあります。思考トークンは出力として課金されます。[4]
Google が公表する Gemini API の料金は、2026年11月30日までは入力100万トークンあたり $2、出力100万トークンあたり $10 で、12月1日以降はそれぞれ $4 と $20 です。[4] キャッシュ済み入力は、提供開始時の割引期間中は100万トークンあたり $0.10、その後は $0.20 です。これらは Google 自身の API の料金です。他のサービスは独自に料金を設定するため、SeedRouter で実際に支払う料金は同サービスのモデルページで確認してください。
Gemini 4 Carbon の初回リクエストを準備する
既知のバグがある短い関数など、回答を自分で確認できるタスクを選んでください。最初からリポジトリ全体を渡すと、問題が利用権限、リクエスト、プロンプトの不備のどこにあるのかを見分けにくくなります。
Gemini のネイティブ形式では、モデルはボディではなく URL パスに指定し、必須フィールドは contents だけです。[3] 以下は POST /v1beta/models/gemini-4-carbon:generateContent のボディです。
{
"contents": [
{
"role": "user",
"parts": [
{
"text": "This retry loop re-reads an account balance before taking the lock. Explain the race condition and propose a fix with one test."
}
]
}
],
"generationConfig": {
"thinkingConfig": { "thinkingLevel": "medium" },
"maxOutputTokens": 32768
}
}出力上限の 32768 は、このフィールドを明示的に設定する場合は少なくとも32,768にするという Google の推奨に従っています。Carbon は上限の大部分を思考に使うことがあるためです。[5] この値は、次のセクションで説明する、ストリーミングを使わない REST 呼び出し1回の上限でもあります。
SeedRouter のドキュメントでは、同じパスを同サービスのホスト api.seedrouter.ai で使い、Authorization ヘッダーに Bearer トークンを指定しています。一方、Google 自身の REST の例では x-goog-api-key ヘッダーを使います。[3][6] キーは発行元のサービスと組み合わせて使ってください。Google のキーでは SeedRouter の認証は通らず、SeedRouter のキーは Google のホストでは使えません。
Gemini 4 Carbon が無視または拒否する設定は省いてください。Google によると、temperature、topP、topK は送信しても無視され、明示的なコンテキストキャッシュには対応していません。暗黙的なキャッシュは4,096トークン以上のプロンプトに自動で適用されるため、コードベースや長い文書などの大きな固定データはプロンプトの先頭に置いてください。[5] クライアントが旧モデル用の thinkingBudget をまだ送信している場合は、thinkingLevel に置き換えます。Google の Agent Platform ガイドによると、同プラットフォームの Gemini 4 モデルでは thinking_budget と MINIMAL を指定すると HTTP 400 が返されます。[7]
ストリーミング、出力上限と継続処理
Gemini 4 Carbon には、入力、思考、出力で共有する1,048,576トークンの統合ウィンドウがあります。ただし、1回の同期呼び出しは、それよりはるかに少ないトークン数で停止します。[2] Google の長文生成ガイドでは、1ホップあたりの上限を次のように定めています。[6]
| 呼び出しの種類 | 1ホップあたりの出力トークン数 | 上限を超える場合 |
|---|---|---|
generateContent、ストリーミングなしの REST | 32,768 | continuationToken なしで maxOutputTokens を32,768より大きくすると400が返される |
streamGenerateContent | 65,536 | 返されたトークンで継続する |
| 複数ホップにまたがる長文生成 | 最大1,048,576から入力分を引いたトークン数 | 継続処理が必要 |
継続処理はホップ単位で行います。ホップが上限に達し、出力の予算が残っている場合、レスポンスは finishReason: "CONTINUATION" と continuationToken を返して終了します。そのトークンを追加し、それ以外は同一のリクエストを再送してください。トークンにはすでにモデルの状態が含まれているため、途中までの回答を contents に追加しないでください。終了理由が CONTINUATION の間は処理を続けます。[6]
ホップから空のテキストが返されることもあります。難しい問題では、モデルが1ホップ全体を思考に費やす場合があります。Google は、継続トークンを伴う空の text を、失敗ではなく通常の進行として扱っています。[6]
応答が遅くなることも想定してください。Google は長文生成時の HTTP 読み取りタイムアウトを20分にすることを推奨しています。一方、SeedRouter は、ストリーミングを使わないリクエストの実行時間が約100秒を超えると、回答が届く前に HTTP 524 で終了する可能性があると注意を促しています。長時間のタスクには、SeedRouter は streamGenerateContent?alt=sse を推奨しています。[3][6] 接続が切れたことだけでは、生成が失敗したとは判断できません。同じリクエストを再送する前に、途中までの結果を確認してください。
思考の強度を選ぶ
thinkingLevel は、品質と、応答時間・トークン使用量のバランスを調整する設定です。[5]
| 強度 | トークン使用量 | Google が推奨する用途 |
|---|---|---|
low | トークン使用量が最少で、応答時間も最短 | 比較的単純でコストを重視する作業。難しいタスクでは品質が下がることがある |
medium（デフォルト） | バランス型 | 複雑なコードやエージェントによる作業を含む、大半のタスク |
high | トークン使用量が最多で、最初のトークンまでの時間も最長 | 難しい数学・科学の問題、最も難度の高いコード。長文生成と組み合わせる |
Google は、3つの強度すべてを自分で評価し、品質基準を満たす最も低い強度を選ぶよう勧めています。[5] Argon でうまくいった強度は、出発点としては妥当です。ただし、Carbon はトークンの使い方が異なるため、そのまま最適だと結論づけることはできません。
利用規模を拡大する前にレスポンスを確認する
回答テキスト以外にも目を通してください。ネイティブ形式のレスポンスには candidates[].content.parts、finishReason、usageMetadata が含まれます。SeedRouter のドキュメントでも、確認すべきフィールドとして continuationToken、safetyRatings、promptFeedback が挙げられています。[3]
finishReason: "MAX_TOKENS"は、出力上限に達したことを意味します。Google によると、返されたトークンを付けてmaxOutputTokensを増やして再送するか、最初からやり直して両方の実行分を支払うことができます。[6]thoughtsTokenCountは、出力として課金された思考トークン数を示します。画面に表示される回答が短くても、思考トークンは大量に使われていることがあります。[4][6]- REST では、ホップごとに使用量が返されます。コストを求める際は各ホップのフィールドを合計し、プロンプトのサイズは最初のホップの値だけを使ってください。[6]
- SeedRouter のストリーミングで返される使用量は累積値です。各チャンクを合計せず、最新のカウンターを読んでください。[3]
会話履歴を組み立てる際は、thoughtSignature を含むコンテンツパーツ全体を保持してください。[3] コード修正では、パッチを採用する前にテストを実行します。200 レスポンスが示すのは、サービスがリクエストを受け付けたことだけです。
公開時に Google が報告した結果
Google の10月28日の発表では、Gemini 4 Carbon は Artificial Analysis Intelligence Index v5.0 でスコア59を記録し、首位とされました。また、SEC-bench Pro で88.2%、ExploitGym で54.8%、CWE-bench で71.0%を記録したと報告されています。いずれもガードレールなしでの評価です。[8] これらは提供元が報告した結果です。本番のリクエストを送る前に、自分のタスクでモデルを検証してください。
よくある質問
Gemini 4 Carbon は無料で使えますか？
Gemini API では無料で利用できません。Google の料金ページでは無料枠は利用不可とされており、Gemini アプリでの一般ユーザー向けの利用には Google AI Ultra サブスクリプションが必要です。[1][4] 研究者は6か月間の Antigravity の無料利用を申請できますが、選考があります。
Gemini 4 Carbon はもう利用できますか？
はい。2026年11月10日から、Gemini API を有料で利用する開発者、Gemini for business、Google AI Ultra の加入者向けに提供されています。それ以前は、Fairwind Program の防御担当者に限定されていました。[1]
Gemini 4 Carbon の料金はいくらですか？
Google の API では、2026年11月30日までは入力100万トークンあたり $2、出力100万トークンあたり $10、その後はそれぞれ $4 と $20 です。[4] 思考トークンは出力に数えられます。SeedRouter はモデルページで独自の料金を公開しています。
Gemini 4 Carbon のコンテキストウィンドウはどのくらいですか？
入力、思考、出力で共有する1,048,576トークンです。同期呼び出しのデフォルトの出力上限は65,536トークンで、ストリーミングを使わない REST 呼び出しでは32,768トークンです。長文生成ではさらに多く出力できます。[2][6]
Gemini 4 Argon から Carbon に切り替えられますか？
はい。Google によると、移行にはリクエストスキーマの変更は不要で、モデル ID の変更だけで済みます。思考時間が長くなることを見込み、出力上限とタイムアウトに余裕を持たせてください。[5]
Gemini 4 Carbon は reAPI で使えますか？
いいえ。reAPI はこのモデルの推論実行、課金、キーの提供を行っていません。概要ページでリクエストを準備でき、実行先は SeedRouter です。
Gemini 4 Carbon の初回実行で押さえること
小さなタスクから始め、URL に gemini-4-carbon を指定し、thinkingLevel と maxOutputTokens を意識して設定してください。長時間かかる可能性があるタスクには、ストリーミングを使います。プロンプトを大きくする前に、終了理由とトークン数を確認してください。準備ができたら、SeedRouter の Gemini 4 Carbon を開き、自分のアカウントでの利用可否を確認します。
参考資料
- Google. Gemini 4 Carbon is now available. 2026年11月10日公開、2026年11月11日取得：blog.google/innovation-and-ai/models-and-research/gemini-models/gemini-4-carbon-now-available。
- Google AI for Developers. Gemini 4 Carbon model page. 2026年11月11日取得：ai.google.dev/gemini-api/docs/models/gemini-4-carbon。
- SeedRouter. Gemini 4 Carbon API documentation. 2026年11月11日取得：seedrouter.ai/docs/gemini-4-carbon。モデルページ：seedrouter.ai/models/gemini-4-carbon。このガイドのための実際のモデル実行テストは行っていません。
- Google AI for Developers. Gemini Developer API pricing: Gemini 4 Carbon. 2026年11月11日取得：ai.google.dev/gemini-api/docs/pricing。
- Google AI for Developers. What's new in Gemini 4 Carbon. 2026年11月11日取得：ai.google.dev/gemini-api/docs/whats-new-gemini-4-carbon。
- Google AI for Developers. Long decode (generateContent). 2026年11月11日取得：ai.google.dev/gemini-api/docs/long-decode。
- Google Cloud. Get started with Gemini 4. Gemini Enterprise Agent Platform のドキュメント、2026年11月11日取得：docs.cloud.google.com/gemini-enterprise-agent-platform/models/start/get-started-with-gemini-4。
- Google. Gemini 4 Carbon: our next frontier model. 2026年10月28日公開、2026年11月11日取得：blog.google/innovation-and-ai/models-and-research/gemini-models/introducing-gemini-4-carbon。