Gemini 4 Carbon APIの料金を計算する:タスク全体でいくらかかる?

検証済みのPython計算ツールでGemini 4 Carbonのタスク費用を算出。現行・12月以降の料金、キャッシュ、思考、再試行、エージェントの複数ターン、ツール料金を整理します。

曲がりくねった経路の横に置かれた機械式カウンター。オレンジ色の区間が、途中の処理も合計に含まれることを示している。

Gemini 4 Carbonのタスク費用は、独立した各試行と継続処理について、確認できた費用を合計して見積もります。対象はキャッシュ未命中の入力、キャッシュ命中分、思考を含む生成トークン、別途課金されるツールです。先に適用する料金期間を決めてください。 最後に表示される回答だけでは、費用の全体像は分かりません。採用できる成果を出せなかった再試行や、それ以前のエージェント呼び出しでも、リソースを消費することがあります。

この記事では、ダウンロード可能な完全なPython計算ツール、用量を統一して記録する形式、再計算できる例を提供します。使用するのは、2026年11月15日に確認したGoogleの gemini-4-carbon 向けStandard料金(米ドル) です。Batch、Flex、Priority、個別契約、Ofox経由の料金は対象外です。まずAPIを動かしたい場合は、Carbon APIの接続手順から始めてください。

本記事の発行元はOfoxです。計算ツールとCLIは24件のオフラインテストに合格しています。例に使うトークン数やタスクの結果はすべて仮定であり、モデルの実行測定値でも、プロバイダーの請求書でもありません。ツールはAPIを呼び出さず、キーを読み込まず、プロバイダーの生のusageを自動解釈しません。意味を確認済みの用量台帳を再計算し、重複計上などを見つけるためのものです。

モデル、サービス区分、料金の適用日を確認する

GoogleのCarbon料金表(英語)では、Standard料金を次のように示しています。単位はすべて100万トークン当たりの米ドルであり、1リクエストや1件の受入済みタスク当たりの料金ではありません。

課金対象2026年11月30日まで2026年12月1日から適用する用量
通常入力$2.00$4.00キャッシュに命中しなかった入力トークン
キャッシュ入力$0.10$0.20実際にキャッシュに命中した入力部分
出力(思考を含む)$10.00$20.00合算範囲を確認した課金対象の生成量

確認日時点で12月の列は将来の料金を使うシナリオであり、現行料金ではありません。同じトークン数なら、この3種類のトークン単価は2倍になります。別途発生するツール料金まで自動的に2倍になるわけではありません。GoogleはCarbonのFree区分を掲載しておらず、ツールの無料枠があっても、Carbonのトークン処理が無料になるわけではありません。

Google公式英語ページのCarbon Standard料金表。2026年12月1日前後の入力、思考込み出力、暗黙的キャッシュの単価が表示されている。

公式英語ページの実際のスクリーンショットです。アカウント情報を含まないStandardのトークン料金部分に切り出しています。料金の出典であり、請求書やOfoxの見積もりではありません。

記録にはモデルID、サービス区分、通貨、単位、適用期間をセットで残してください。別のGeminiモデルや別区分の単価をコピーしただけでは、Carbonのリクエストを計算できません。Googleモデルの選び方ではタスクとの相性を説明していますが、この記事はCarbonが同等の成果を得る最安手段だと証明するものではありません。

Googleは一部のツールも別途課金します。Search groundingの説明では、1件の顧客リクエストから複数の検索クエリが発生することがあり、そのクエリ単位がツール課金に関わります。共有枠や制限は最新のツール料金欄で確認してください。実際の課金単位がアプリケーションのリクエストでない限り、固定のツール料金にアプリのリクエスト数を掛けてはいけません。この計算ツールが受け取るのは確認済みの別途ツール料金(USD) であり、推測した呼び出し回数ではありません。

式に入れる前に用量の意味をそろえる

台帳のフィールド名はこの記事独自のものです。GoogleやOfoxのレスポンスフィールド名ではありません。実際の値を入れる前に、対象エンドポイント、SDKバージョン、実行モードの仕様を読み、生の用量記録を非公開で保管して変換過程を説明できるようにします。

台帳フィールド必要な意味避けたい誤り
id個別に数える1試行または継続ステップの一意な識別子同じリクエストの複数スナップショットを別件として計上する
input_totalキャッシュ分を含む、その行の全課金対象入力未キャッシュ分だけの値を入力総数として使う
cached_inputinput_total のうち、命中を確認したキャッシュ部分対象条件を満たすすべてのトークンが命中したと考える
generated_including_thinking思考を一度だけ含めた、課金対象の生成量合計既に思考込みの値へ思考量を再加算する
tools_usd確認済みの別途ツール料金を表す十進文字列。ゼロと確認した場合のみ "0"不明な料金やツールのトークン数をゼロドルと扱う

Googleのトークン計数ドキュメント(英語)には、total_input_tokens、total_output_tokens、total_thought_tokens、total_cached_tokens、total_tool_use_tokens などの名前があります。しかし、名前だけでは全請求方式に共通する変換規則は決まりません。今回確認したドキュメントとSDKコメントからも、すべてのCarbon経路・モードで出力と思考の包含関係が同じだとは確認できませんでした。

変換は条件付きで行います。対象の仕様が「出力総数に思考を含む」と確認できるなら、その合計を一度だけ使います。可視出力と思考が互いに重ならない課金量だと確認できるなら、一度だけ足して統一フィールドにします。関係を確認できなければ処理を止めて不明と記録し、数値がもっともらしいという理由で式を選ばないでください。ツール使用トークン数も、そのまま別途の金額にはなりません。

usageが1リクエスト、1継続ステップ、累積インタラクションのどれを表すかも確認します。ストリーミングの累積スナップショットを足し合わせてはいけません。最終値に過去のステップが含まれるなら、最終値を一度だけ使うか、重ならないと確認したステップ別値を使います。両方を混ぜると過大計上になります。

意味を統一できれば、1行の式は次のとおりです。

ordinary_input = input_total - cached_input
row_cost_usd = (
    ordinary_input * ordinary_input_rate
    + cached_input * cached_input_rate
    + generated_including_thinking * generated_rate
) / 1_000_000 + tools_usd

task_cost_usd = sum(cost of each non-overlapping row)

この引き算をするため、キャッシュ入力は総入力の部分集合である必要があります。総入力を通常単価で課金した後にキャッシュ分を追加すると、そのトークンを二重に数えます。また、Carbonのこの式に明示的キャッシュの保存料金を追加しないでください。引用した料金は暗黙的キャッシュに命中した入力のもので、Carbonは明示的キャッシュに対応していません。

完全な計算ツールをローカルで実行する

Carbonタスク費用ツールキットをダウンロードし、展開後に carbon-task-cost-kit に移動します。内容は cost.py、CLIの calculate.py、2つのテストモジュール、2つのサンプル台帳、英語READMEです。Python標準ライブラリだけを使うため、モデルSDK、キー、ネットワーク通信は不要です。

Python 3.11以降を使います。サンプルを置き換える前にテストを実行してください。

python -m unittest test_cost.py test_cli.py -v

期待結果は24件のテスト成功です。計算処理16件とCLI8件で、十進演算、キャッシュの部分集合、用量欠落、ID重複、不正な料金期間、JSONキー重複、不正な台帳、正確なCLI出力を検証しています。これはローカル計算ツールの検証であり、プロバイダーの請求処理の正しさを検証した結果ではありません。

同梱の single-attempt.json は、仮定した1回の試行を表します。

[
  {
    "id": "illustrative-success",
    "input_total": 50000,
    "cached_input": 40000,
    "generated_including_thinking": 6000,
    "tools_usd": "0"
  }
]

同梱シナリオを実行します。

python calculate.py single-attempt.json --period through-2026-11-30
python calculate.py single-attempt.json --period from-2026-12-01
python calculate.py retry-task.json --period through-2026-11-30

USD合計は順に "0.084"、"0.168"、"0.234" です。JSON出力では各行を通常入力、キャッシュ入力、生成トークン、ツール料金に分けています。金額は精度を維持する十進文字列で出力し、途中の各項目をセント単位へ丸めません。正確な結果を保存した後で、表示用の書式を整えてください。

自分の台帳を使うときはサンプルを別のJSONファイルへコピーし、意味を確認した数値を入れ、python calculate.py your-ledger.json --period through-2026-11-30 またはもう一方の明示的な期間で実行します。大量の行に適用する前に、内訳を手計算と照合してください。空の台帳は拒否されます。空であることは、完了したタスクが無料だった証拠にはなりません。

数量の欠落、負数や整数でないトークン数、総入力を超えるキャッシュ入力、重複ID、重複JSONキー、想定外フィールドがあるとエラー終了します。ツール料金は既知の非負の十進値で、JSONでは "0.01" のような文字列にします。別の思考加算値や行ごとの料金上書きも拒否し、用量の統一を明示的に行う設計です。人が読むメモや元記録への参照は別ファイルに保存し、計算用スキーマへ無造作に混ぜないでください。

タスク別の計算例を再現する

以下は、意味を統一した架空の用量による計算です。あなたのプロンプトにCarbonが必要とするトークン数、キャッシュ命中の有無、品質基準を満たすかどうかを予測するものではありません。

現行料金で1回の試行が採用された場合

総入力を50,000トークン、うちキャッシュ命中を40,000、思考込み生成量を6,000、別途ツール料金を確認済みのゼロとします。通常入力は10,000トークンです。

  • 通常入力:10,000 × $2 / 1,000,000 = $0.020。
  • キャッシュ入力:40,000 × $0.10 / 1,000,000 = $0.004。
  • 思考込み生成量:6,000 × $10 / 1,000,000 = $0.060。
  • 合計:$0.084。

最終テキストの可視トークン数は6,000未満でもかまいません。この例の生成量は既に思考込みなので、別の思考量を加えてはいけません。

同じ用量を発表済みの12月料金で計算する場合

用量を固定すると $0.040 + $0.008 + $0.120 = $0.168 です。3つのStandard単価が2倍になるため、トークンのみの例では正確に2倍になります。これは同じ用量で期間別単価を比較したもので、12月の実タスクも同じトークン数を使うという予測ではありません。

両期間に別途の既知ツール料金 $0.01 があるなら、合計は $0.094 と $0.178 です。最初の合計を2倍して$0.188にすると、変わらないツール料金まで2倍にしてしまいます。この$0.01は説明用の仮定であり、Googleツールの公表価格ではありません。

最初の試行が失敗し、次の結果が採用された場合

retry-task.json では、上の採用済みの例の前に、未キャッシュ入力50,000トークン、思考込み生成5,000トークンという用量既知の試行を追加しています。どちらも別途ツール料金はゼロと仮定します。

[
  {
    "id": "illustrative-failed-attempt",
    "input_total": 50000,
    "cached_input": 0,
    "generated_including_thinking": 5000,
    "tools_usd": "0"
  },
  {
    "id": "illustrative-success",
    "input_total": 50000,
    "cached_input": 40000,
    "generated_including_thinking": 6000,
    "tools_usd": "0"
  }
]

最初の行は $0.100 + $0.050 = $0.150。採用された行と合わせるとタスク全体で$0.234です。採用された試行だけなら$0.084ですが、それが全額ではありません。ここでの「失敗」は課金対象用量が個別に分かっていると仮定した試行であり、拒否されたすべてのHTTPリクエストにこの料金がかかるとは述べていません。

条件を一つずつ変えると、どの量が計算に影響するか確認できます。

仮定したシナリオ合計USD変えた条件
現行単価、キャッシュ命中40,000、生成6,000$0.084上記の基準
現行単価、キャッシュ命中なし、入力・生成総数は同じ$0.160入力50,000すべてが通常単価
現行単価、キャッシュ命中40,000、生成16,000$0.184思考込み生成量が10,000増加
12月単価、基準と同じ用量$0.168料金期間のみ変更
現行単価、基準に既知ツール料金$0.01を追加$0.094別途ツール料金のみ追加
12月単価、基準に同じ$0.01を追加$0.178トークン単価のみ変更、ツール料金は同じ

これは計算例であり、モデルのベンチマークでも、特定のプロンプト変更で表の金額だけ節約できるという約束でもありません。

キャッシュの対象条件と短いエージェントターンを理解する

Googleのキャッシュガイド(英語)では、Carbonの暗黙的キャッシュは入力4,096トークン以上が対象です。対象条件を満たしても命中は保証されません。引用したキャッシュ単価は通常入力より95%低いものですが、実際に命中したトークンだけに適用されます。全トークンやタスク総額の95%割引ではありません。

明示的キャッシュの作成と cached_content 参照はCarbonでは使えません。割引列を適用させるためだけに明示的キャッシュIDを追加しないでください。安定した共通プレフィックスや、短い時間内の類似リクエストは暗黙的再利用の可能性を高めますが、台帳は実際の命中量に基づけます。ドキュメントでは命中量を usage.total_cached_tokens で報告するとしています。それでも、正規化前にエンドポイントの入力総数との関係を確認する必要があります。

同じガイドには、Gemini 4の複数ターン・エージェントループに関する別の規則があります。新しいリクエストが、モデル出力、思考、関数結果を含めて少なくとも2,050トークン追加した場合に限り、前のリクエスト全体がキャッシュされます。追加量がそれより少ない場合、前のリクエスト末尾2,050トークンが通常入力単価で再処理されます。

この2,050トークン規則は、対象条件の4,096トークンとは別です。会話全体のキャッシュが失われるという意味でも、毎ターン固定の追加料金がかかるという意味でもありません。統一済みの入力・キャッシュ量に実処理が反映されているなら、さらに2,050を足すと二重計上になります。予想外の用量を説明する規則として使い、測定済みフィールドに架空の用量を追加しないでください。

例えば、同じ長い初期指示を保持する2つのエージェントでも、各ターンに追加する内容量が違えば入力費用も変わり得ます。実際のキャッシュと入力記録を比較してください。対象条件を超えるためだけにプロンプトを水増しせず、追加処理とタスクの成果が改善するかを評価します。

思考、履歴、継続処理を予算に含める

Carbonドキュメント(英語)では、max_output_tokens は思考と出力の合計を制限すると説明しています。エージェントタスク全体のドル予算ではありません。入力、ツール料金、再試行、後続呼び出しは、1レスポンスの生成上限とは別に費用を増やし得ます。

Carbonは low、medium、high の思考レベルを持ち、文書上のデフォルトは medium です。思考を下げると、消費量と有用な結果を得る確率の両方が変わり得ます。再試行が増えるなら、1回が安くても採用可能なタスク全体が安くなるとは限りません。同じタスクと受入基準で試してから設定を選んでください。この記事にはレベル間の品質比較実験はありません。

長い生成は複数の継続ステップにまたがる場合があります。サーバー側のバックグラウンド継続では累積インタラクションが返り、クライアント側ループでは別々の記録になることがあります。Carbonの共有コンテキストには入力、推論、出力が含まれるため、大きなウィンドウが3要素それぞれの独立枠になるわけではありません。Carbon設定ガイドではリクエスト設定と継続方式を扱っています。費用台帳は実際に返る用量の範囲に合わせてください。

複数ターンのエージェントでは、各リクエストにどの履歴やツール結果を含めたか追跡します。ユーザーが短い一文を足しただけでも、課金入力に保持された文脈が含まれる場合があります。一方、統一済み用量がキャッシュ分を正しく分けているなら、その部分を再び通常入力として数えません。最終累積値と、その構成要素である各ステップを同時に足さないでください。

実用的な支出制御には、レスポンスごとの生成上限、最大エージェントステップ数、結果が不明な場合の方針、ステップ間で確認するタスク予算が必要です。計算ツールは既知の用量や、仮定だと明示した予測を評価できます。しかし、実行中のリクエストが特定のドル上限で止まることや、未報告の料金を推定することは保証できません。

再試行と用量欠落を請求確認の問題として扱う

クライアントのタイムアウトだけでは、サーバーで処理されたかは分かりません。HTTPエラーだから毎回課金されたとも、usageがないから消費ゼロとも判断できません。リクエスト識別子を保持し、プロバイダー記録で解決するまで不明として分類します。台帳を通すために架空のゼロを入れないでください。

再試行前に、認証、アクセス権、割り当て、無効パラメーター、一時的障害を分けます。Gemini 4 APIエラーガイドの診断分類は参考になりますが、モデル固有の例はCarbonではなくArgonです。Ofox API上のアプリには、対応するエラー処理と再試行のドキュメントを使います。この参照は、Ofoxが当該Carbon経路に対応していることの証明ではありません。

本当に別の試行を一度ずつ記録します。再試行は新規リクエストになる一方、結果取得のGETは既存処理を取得するだけかもしれません。仕様を確認せず、両方を2回目の生成と呼ばないでください。同じ試行についてアプリとプロバイダーにログがあっても、記録元が2つという理由で費用行を2つ作ってはいけません。

成功はタスク単位で定義します。コーディングなら、依頼した変更、該当テスト結果、最終成果物の受入可否を記録できます。抽出なら、スキーマの妥当性や確認済み出典との一致が考えられます。HTTP 200だけでは、いずれの結果も証明できません。非公開の元資料を保護しながら、台帳と受入証拠を一緒に管理します。

代替案を比較するなら同じタスク群と受入規則を使い、分かっている不成功試行を含め、未解決の用量は別途報告します。その上で、帰属させられる支出を受入済みタスク数で割れます。採用されたタスクがゼロなら、その事実を報告し、有限の「成功1件当たり費用」を作り出さないでください。この記事の例は受入ラベルを仮定したもので、成功率を測定していません。

台帳をプロバイダーの記録と照合する

まず用量の境界を説明できる小さなタスクから始めます。生のレスポンス、変換メモ、正確なモデルと区分、料金スナップショット、請求期間、試行ID、計算ツールのバージョン、受入結果を非公開で保存します。計算後に各内訳をプロバイダー記録と比較し、何千件ものタスクへ見積もりを広げる前に差異を調べます。

料金変更日をまたぐタスクでは、行を適用期間ごとに分け、それぞれを計算して正確な合計を足します。CLIは意図的に入力全体へ一つの期間を適用します。請求日やタイムゾーンを推測せず、行単位の上書きも拒否します。実データの割り当ては、プロバイダーが実際に扱う適用日の規則に従ってください。計算が正確でも将来料金のシミュレーションは予測です。

用量から計算した費用は、請求書レベルの税、通貨換算、個別契約の調整、丸めとは区別します。途中では十進精度を保ち、後で表示を丸める場合は記録します。過去の請求書を現在の料金表で書き換えないでください。

Ofox対応モデルについては、用量追跡ドキュメントにリクエスト・トークン・費用の内訳、課金ドキュメントに費用画面とモデルカタログへの案内があります。11月15日の確認では、ofoxai/home-page のコミット 0e0c8cc6e655b606466142aae0929a666fbaaf0e にあるcatalogプロキシを追跡し、公開レスポンスの全133件を保存しました。このスナップショットにはCarbonの項目がありませんでした。永久に利用できない証拠ではありませんが、この記事で示せる確認済みOfox Carbon料金がないということです。上記Google料金をOfox料金として扱ってはいけません。

Ofoxのリクエスト内容ログは、用量・請求記録とは別機能です。内容保存はデフォルトで無効で、権限のあるチーム管理者が有効化した後、設定範囲内の後続リクエストに適用されます。以前のプロンプトを復元できるとは考えず、費用を数えるだけで全文保存が必要とも考えないでください。証拠の収集はチームのデータ取扱規則に従います。

最終的に必要なのは、既知の用量、指定した料金期間、タスクの受入結果へさかのぼれる台帳です。不明な値があれば、その制約を残します。未検証の仮定で精密に見せた総額より、範囲が明確で再計算できる結果の方が役立ちます。