この記事は AIHubMix が作成しました。Carbon の API 仕様は Google のガイドに基づき、AIHubMix のライブ検証は実施していません。Google ネイティブの Interactions / background 機能は AIHubMix で文書化されていません。
TL;DR
-
gemini-4-carbonを使い、AIHubMix のmax_tokensは65,536以下にします。 - Google ネイティブの長文デコードを使う場合、HTTP 読み取りタイムアウトはストリームごとに15〜20分に設定します。
-
temperature、top_p、top_kは無視されます。ペナルティと、1を超えるcandidate_countは Google の Carbon ガイドで400です。 - ネイティブの
thinking_budgetとthinking_level=MINIMALは400です。互換層のreasoning_effort=minimalは別のマッピングで、AIHubMix の Carbon への適用は未公開です。
ハマりどころ
candidate_count を2以上にすると400になる
candidate_count は省略するか1にします。複数候補には対応していません。
バックグラウンド実行で store=true がない
Google ネイティブの Interactions でバックグラウンド実行する場合は、store=true と明示的な max_output_tokens を付けます。Google のエラーは「store=true is required for background interactions.」です。AIHubMix はこの経路を文書化していません。
履歴がモデルのターンで終わる
履歴の最後をユーザーターンにします。モデルの事前入力もサポートされません。
上限を低くすると空の incomplete になる
8,192など低い上限では、モデルが思考中に止まることがあります。テキストが空でも完了済みの処理は課金されるため、上限を上げて再試行します。
60秒の打ち切りでは最初の回答が間に合わないことがある
60秒で打ち切ると、最初の回答トークンを受け取れるでしょうか。Artificial Analysis の測定では、Carbon High は67.1秒、Medium は23.2秒、Low は12.9秒、Argon High は40.1秒でした。
最初の回答トークンまでの時間であり、リクエスト全体の所要時間ではありません。出典：Artificial Analysis、2026年11月11日。
この測定で60秒を超えたのは Carbon High だけです。この値からリクエスト全体に必要なタイムアウトは決められません。Google の15〜20分という読み取りタイムアウトの推奨は、ネイティブ API の長文デコードのストリームに対する別の指針です。図は1時点の測定であり、遅延の保証でも AIHubMix での検証結果でもありません。
出力上限と料金
標準の出力上限は65,536トークンです。Google ネイティブの長文デコードは入力を除いて最大1,048,576まで、131,072または262,144が例として示されていますが、OpenAI 互換レイヤーは継続トークンを取得できません。AIHubMix では65,536以下にします。
思考トークンは出力として課金され、ネイティブ長文デコードの各ホップも課金されます。キャンセルされた場合も完了済みセグメントは請求対象です。明示的キャッシュは使えず、暗黙キャッシュは4,096トークン以上で始まります。Google はツールの順次実行を推奨し、AIHubMix は tool_choice="auto" を文書化していますが、Carbon 固有のゲートウェイ対応は未確認です。
11月30日まで Carbon と Argon は入力2ドル/100万、出力10ドル/100万、キャッシュ読み取り0.10ドルです。12月1日から倍になります。AIHubMix の12月以降の価格は未公開です。
初回チェックリスト
- モデル ID は
gemini-4-carbon。 - サンプリングパラメーターとペナルティを送らない。
-
candidate_countは省略または1。 -
max_tokensは65,536以下。Google ネイティブ長文デコードのタイムアウトは15分以上。 -
reasoning_effortとthinking_levelはどちらか一方。ネイティブの MINIMAL と thinking_budget は無効。 - Google ネイティブではツールを順番に実行。AIHubMix は
tool_choice="auto"を文書化していますが対応は未確認。 - 明示的キャッシュ API を呼ばない。
まとめ
まず上限、タイムアウト、400になるフィールドを直します。Claude Code の Messages と Codex の Responses は Carbon で未確認なので、接続前にモデルページを確認してください。
あわせて読みたい：Gemini 4 Carbon シリーズ
参考
- Gemini 4 Carbon guide（Google Cloud）
- Long decode（Google AI Studio）
- Pricing（Google AI Studio）