Skip to main content

簡潔な回答

ログページコスト列 は、その呼び出しの USD 金額です。そこで見える内容は、次の4点で説明できます。
  1. 使用量ベースのモデル(多くのテキストモデルに加え、gpt-image-2、SeeDance 2.0 ファミリーなど)は、レスポンスの usage フィールド に token 数を返すため、コストはクライアント側で計算できます;
  2. 呼び出しごとのモデルはレスポンスに金額を返しませんが、単価は固定なので、コスト = 呼び出し回数 × 固定価格 — 同じく簡単に計算できます;
  3. ログの金額は割引前です。実際のコストは、その金額をチャージ時のボーナス比率で割ったものになります(10% のボーナスなら ÷1.1 で、おおむね 9% の割引です);
  4. ログに記録されるのは、課金に成功した呼び出しのみです。 エラーは API レスポンスで返されます。課金が発生しなかった失敗した呼び出しはログに表示されず、課金もされません。
一言でいうと: 呼び出しごとの課金 = 固定コスト; 使用量ベースの課金 = token から算出され、レスポンスで返されます。

各列の読み方

Per-call models は Prompt / Completion に token 数を表示する場合がありますが、金額はこれらの列から算出されません。簡単な見分け方は、同じパラメータで繰り返した呼び出しの料金がまったく同じで、0.030000 のようなきりのいい数になっている場合です。その場合は per-call 課金です。

2つの課金モード

使用量ベース(token ごと)

レスポンスの usage フィールドは token 数を直接返します。コスト = 入力 token × 入力レート + 出力 token × 出力レート。適用対象: ほとんどのテキストモデルに加え、gpt-image-2SeeDance 2.0 ファミリーのような token 価格の画像および動画モデル。

呼び出しごと(固定単価)

金額は返されません が、各呼び出しには固定価格があるため、コスト = 呼び出し回数 × 単価 — 予算を組むうえで最も簡単です。適用対象: 画像ごとまたは秒ごとに課金されるほとんどの画像および動画モデル。コンソールのモデル料金ページで料金を確認してください。

API はコストを直接返せますか?

金額は返しませんが、コストは完全に算出できます:
  • 使用量ベース: usage の値にレートを自分で掛けてください — これはベンダー自身の token 数であり、どんな推定よりも正確です;
  • 呼び出しごと: 単価は固定なので、呼び出し回数を掛けるだけです。
最終的なコストは、グループ倍率お客様アカウントのチャージボーナス比率 にも左右されるため、金額をあえてレスポンスに含めていません。中途半端な数値をレスポンスに埋め込むと、突合はむしろ分かりにくくなります。

使用量から算出する

使用量ベースのモデルは次のような内容を返します:
対応する式は次のとおりです:
キャッシュされた input は キャッシュヒット率 で課金されます(通常は input レートの約0.1倍)ので、長いコンテキストのワークロードでは、記録される金額が prompt_tokens に基づく通常価格ベースの見積もりを大きく下回ることがあります。キャッシュ課金 を参照してください。

gpt-image-2 の token 数を確認する

モデル概要の料金セクションには、入力画像と出力画像が token にどう変換されるかの実測データがあります

ログ金額が「割引前」である理由

ログには、モデルのレートから算出された生の金額が記録されます。実際の費用には、チャージ時に付与されたボーナス残高があるため、ここからさらにもう1段階の割引がかかります。
たとえば、$0.011 と記録された呼び出しが 10% のチャージボーナス付きであれば、実際の費用は 0.011 ÷ 1.1 = 0.01 となり、約 9% の割引に相当します。

チャージボーナスの階層を見る

階層ごとのボーナス率、初回ボーナス、クレジットの付与方法
グループ割引をもう一度適用する必要はありません: モデルグループのレート倍率は課金時にすでに適用されているため、ログ金額にはその分が含まれています。換算が必要なのは、チャージボーナスの部分だけです。モデルのレート倍率 をご覧ください。

失敗した呼び出しは課金されますか?

いいえ — そして、それらはコストログにも一切表示されません。 これはログを正しく読むうえでの重要なポイントです:
エラーは API レスポンスで返されます。コンソールログは正常に課金されたものを記録するためにあります。 そのため、「ログに記録がない」ことは通常、「この呼び出しは課金されていない」ことを意味します。
典型的な例として、gpt-image-2 を呼び出して次のような結果を受け取った場合です。
このようなリクエストは 即座に返され、リトライはありません。そのためコスト記録は作成されず、課金もされません。同様に、VEO や Sora 2 などの動画モデルが PUBLIC_ で始まるエラーを返した場合、それは上流側のコンテンツモデレーションであり、課金対象ではなく、prompt を調整したあとで安全に再試行できます。
逆の見方もデバッグに非常に役立ちます。 つまり、課金記録 が存在する なら、そのリクエストは確実に上流まで到達し、リソースを消費しています。存在しない 場合、失敗はほぼ確実に上流へ到達する前に起きています(ネットワーク、認証、パラメータ検証)。接続問題を診断するときは、「課金記録があるか?」が最も強い単一の手がかりになることがよくあります。
事前控除のホールドは課金ではありません。 リクエストの実行前に、システムは見積額を一時的に確保します。リクエストが失敗するとそのホールドは解除され、決済は常に実際の使用量に基づきます。残高が一時的に減ってから戻るのは想定どおりです — 事前控除メカニズム を参照してください。

よくある質問

はい。従量課金では金額は使用量に応じて変動します。主な原因は次のとおりです:
  • 入力の長さが異なる: 長いコンテキスト、複数ターンの履歴、画像や音声はすべて入力 token 数を大きく押し上げます
  • 推論 token: 推論が有効なモデルは追加の出力 token を生成し、Completion列に計上されます
  • キャッシュヒット: キャッシュされた入力ははるかに低いレートで課金されるため、同じ prompt の2回目の実行はずっと安くなることがあります
  • 画像/動画パラメータ: 解像度、長さ、画像枚数が token 数または呼び出し回数に直接影響します
レスポンスの**usageフィールド**とログを信頼してください。どちらも同じソースから来ています。不一致の主な原因は次のとおりです: マルチモーダルコンテンツ(画像、音声)がベンダー固有のルールで token に変換されること、システム prompt と tools スキーマが入力として計上されること、そして推論 token が可視テキストに現れないまま出力として計上されることです。
ログインしてコンソールのモデル料金ページ、またはこのサイトのモデル料金の概要をご確認ください。呼び出しごとの価格は固定なので、コストは単純に価格 × 呼び出し回数です。
まず、タイムスタンプでログを確認し、実際にコスト記録が作成されたかを確かめてください。もし本当に異常な課金であれば、ログのタイムスタンプとモデル名を添えてサポートへ連絡してください。こちら側の問題で発生した損失は再発行したクレジットで補償されます。 SLA保証をご覧ください。
いいえ。プライバシーと保存容量の理由から、ログに保存されるのは課金に必要な情報だけです。つまり、時刻、モデル、token 数、金額であり、リクエストやレスポンスの内容は記録されません呼び出し記録の確認方法をご覧ください。

関連ドキュメント