はじめに
Carbon には OpenAI のチャット形式でテキストと画像を渡し、応答、関数呼び出し、JSON のいずれかを受け取ります。推論は回答の前に行われて max_tokens を消費するため、想定する長さより十分大きな上限を設定してください。
| 項目 | 値 |
|---|---|
| 入力 | テキスト |
| 出力 | テキスト |
| 共有コンテキスト | 1,048,576 トークン |
| max_tokens の上限 | 65536 |
主な機能とハイライト
難問のために用意されたモデル
Google は多段階のデバッグや自由度の高い研究で Carbon を Gemini 4 Argon の上位に置く一方、日常的な開発の大半には Argon が適しているとしています。
自分の答えの検証にトークンを使う
Carbon は軽量モデルより多くのトークンを推論と検証に使います。短い回答の前にも、見えない作業の時間が長く続きます。
問題全体を 1 つのウィンドウに
ログ、ソースファイル、メモは、推論や応答とともに 1,048,576 トークンのコンテキストを共有します。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
messages | はい | Carbon との会話を古い順に並べます。user メッセージではテキストパートと |
max_tokens | いいえ | Carbon の応答枠で、1 から 65536 まで指定できます(既定は 4096)。推論もここに含まれ、長い入力に上限 400 で試すと 397 トークンが推論に使われ、本文は返りませんでした。 |
reasoning_effort | いいえ | Carbon の思考の深さで、low、medium、high から選びます(既定は medium)。思考はオフにできず、high が最も多くのトークンを使います。 |
stop | いいえ | 停止文字列を 1 件から 4 件まで、各 32 文字以内で指定します。Carbon の応答は最初の一致の直前で終わり、一致した文字列は返されません。 1 文字以上 · 1 件以上 · 4 件以内 |
temperature | いいえ | OpenAI 形式のクライアントが動作し続けるよう、0 から 2 までの値を受け付けます。Google のドキュメントによると Carbon はこの設定を無視するため、応答は変わりません。 |
top_p | いいえ | OpenAI 形式のクライアントが動作し続けるよう、0.01 から 1 までの値を受け付けます。Google のドキュメントによると Carbon はこの設定も無視します。 |
tools | いいえ | Carbon が呼び出しを要求できる関数を最大 128 件定義します。引数の検証と関数の実行はアプリケーションが行い、結果を tool メッセージで返します。 128 件以内 |
parallel_tool_calls | いいえ | 既定で有効なため、Carbon は 1 ターンで複数の関数を要求できます。1 件ずつ受け取る場合は false を指定してください。 デフォルト値: |
tool_choice | いいえ | Carbon の次の動作を auto、none、required、または特定の関数の指定で制御します。 |
response_format | いいえ | Carbon に JSON オブジェクト、または指定した |
料金
入力 $2 / 出力 $10 100 万トークンあたり
ユースケース
複数サービスにまたがる不具合を追う
エラーログと関連コードを貼り付け、考えられる原因の順位と、それぞれを否定できる確認方法を Carbon に尋ねます。
科学的な論証を検証する
導出や手法の節を渡し、明示されていない仮定に依存している箇所を Carbon に尋ねます。
プロンプトガイドと実践のヒント
max_tokensに十分な余裕を持たせる推論は回答と同じ枠を消費します。長い入力に上限 400 で試すと、397 トークンが推論に使われ、本文は返りませんでした。
Carbon は必要な仕事に絞って使う
定型の書き換えや調べ物は軽量モデルに任せ、誤答の代償が大きい問題で Carbon を使います。
Gemini 4 Carbon は、難しいデバッグ、研究、長時間のエージェント実行に向けた Google で最も強力な推論モデルです。
google/gemini-4-carbon/chat — /v1/chat/completions
reasoning_effort には low、medium、high を指定でき、Carbon の既定は medium です。推論は本文が表示される前に max_tokens を消費します。
推論中に上限へ達すると、finish_reason が length となり応答は空になります。
user メッセージには image_url パートを含められます。Carbon は tools で宣言した関数の呼び出しを要求でき、response_format を使えば JSON を返します。
Carbon へのリクエストには Google の安全システムが適用されるため、一部のプロンプトは拒否されることがあります。
API クイックスタート
curl --fail-with-body -sN https://api.spicyapi.ai/v1/chat/completions \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"model": "google/gemini-4-carbon/chat",
"messages": [
{
"role": "user",
"content": "Summarise the following release notes into three bullet points."
}
],
"stream": true
}' \
| jq --unbuffered -Rrj 'select(startswith("data: ")) | .[6:] | select(. != "[DONE]") | fromjson | if .error then "\n[error] \(.error.message)\n" else (.choices[0].delta.content? // empty) end'
認証、完全なスキーマ、ポーリング、エラー処理は API リファレンスを参照してください。













