核心結論
X402は独立した価格体系ではありません。各API呼び出しには元々Creditsで計算されたコストがあり、これはすべての課金方法(APIトークンによるクレジットの引き落とし、アカウント残高、X402のオンチェーン支払い)で共通の唯一の価格源です。X402はこのCreditsコストを固定レートでオンチェーンUSDCに換算します:
1 Credit = 0.095215 USDC(つまり95215 atomic USDC、USDCは6桁の小数)
つまり:
価格基準
換算はプラットフォームによって統一され、金額はすべてのサポートされているネットワーク(Base、SKALE、Solana)で一致します。異なるネットワークは資産契約と署名方法が異なるだけで、価格は同じです。
通常のCredits単価との関係
プラットフォームのCreditsは「使用量が多いほど、単価が低くなる」階段式で販売されています。X402は呼び出し時に、常に階段の最適単価を使用します:
言い換えれば、X402は各呼び出しを最適階層Credits単価で決済します。小額チャージでCreditsを購入するユーザーは、単価がX402より高くなりますが、大口チャージユーザーの単価はX402と一致します。
2つの価格形態:exactとupto
X402の402レスポンス内のmaxAmountRequiredは、署名する金額です。これには2つの形態があります:
exact(固定価格):リクエスト処理前に価格が確定できる(画像、動画、音楽、検索、注文支払い)。maxAmountRequired = この呼び出しのCreditsコスト × 0.095215、つまりこの呼び出しの支払金額(成功レスポンス内のcost.amountと一致)。upto(使用量後置計量):チャット補完のような「レスポンス終了時にどれだけのトークンを使用したかがわかる」インターフェース。maxAmountRequiredは上限(このモデルで設定された上限額換算:上限Credits × 0.095215)で、実際は真の使用量に基づいて決済され、上限を超えません。
exactとupto課金プランを参照してください。以下では価格についてのみ説明します。
Chat(チャット補完)価格
チャット補完はupto計量:プロンプト/コンプリーショントークンの実際の使用量に基づいて課金されます。百万(1M)トークンの価格 = このモデルの1MトークンあたりのCreditsコスト × 0.095215で、プラットフォームが公開しているモデルディレクトリ(/api/v1/models?with_pricing=true)に表示されているUSD単価と完全に一致します。
以下の表は実際の価格(モデルディレクトリから取得し、X402レートで計算)で、単位はUSD / 1Mトークン:
説明:
- 表中はトークン計量の単価;1回のリクエスト費用 = 入力トークン × 入力単価 + 出力トークン × 出力単価。
upto上限はそのモデルの1回のリクエストで署名可能な最大金額;実際の引き落としではなく、ほとんどのリクエストは上限を大きく下回ります。- 上限は「最大でどれだけ引き落とされる可能性があるか」を決定するだけで、実際の決済はトークンの使用量に基づいて計算されます。
例:見積もりと引き落としが一致する(exact)
以下は公式のX402Clientを使用してserp/googleに対して行った実際の有料呼び出し(Base exact)です。これは3つの一致を示しています:402見積もり、署名金額、および成功レスポンス内で返されるcost。
cost.amount(0.000952 USDC)は、402の見積もり、Credits × 0.095215 と完全に一致しています。settlement フィールドはこの支払いの決済状態(authorized = 認可済み)を示します;チェーン上の決済はプラットフォームによって処理され、メカニズムは exact と upto 課金プラン を参照してください。
upto 見積もり計算(チャット)
チャットはトークンで計測されます。あるリクエストの見積もり(上限ではない)は、以下の式で計算されます(gpt-4o-mini の例):
upto 上限(gpt-4o-mini は 1 Credit = 95215 atomic)で署名しますが、これは最大でどれだけ引かれるかを示すだけです;このリクエストの実際の見積もり(上記の例では約 $0.0001)は上限を大きく下回り、トークンの使用量に基づいて決済されます。upto のチェーン上の決済メカニズムは exact と upto 課金プラン を参照してください。
その他のサービス価格(固定価格 exact)
画像、動画、音楽、検索などのインターフェースは、リクエスト時に価格が確定し、exact を使用します。以下の表は実際の価格で、オンラインインターフェースから未払いリクエストに対して返された402 maxAmountRequiredから取得したものです(見積もりの問い合わせは課金されません):
説明:
- 同一サービスの価格はモデル、解像度、時間、アクションによって変動します(特に動画)。上表は特定のパラメータの下での実際の値であり、量的参考のためのものです。
- このような固定価格(
exact)インターフェースでは、リクエストの402応答内のmaxAmountRequiredがその回の支払い金額となります(成功応答のcost.amountと一致し、前節で実測済み)。 - 各価格は
Credits × 0.095215を下に切り捨てて atomic 単位に変換したものです(上記の価格基準を参照)、チャットで使用されるのと同じ換算方法です。浮動小数点表示と切り捨てのため、個別の値は単純な積と1 atomic($0.000001)異なる場合がありますが、すべて402の返却値を基準とします。
注文支払い価格
X402 支払いコンソールでの注文(パッケージ購入 / Credits 充填)の際、価格は注文ページに表示されるものが基準となり、402のamount が最終的な署名の根拠となります。注文支払いはプラットフォーム API を通じて行われ、アカウントトークンが必要です。詳細は 注文支払いチュートリアル を参照してください。
注文支払いチュートリアルの実際の例(10 Credits 購入):
0.095215/Credit の最適単価を使用します;注文支払いはパッケージ価格に基づき、その作成価格と最終決済金額の差異は 注文支払いチュートリアル を基準とします。
価格をリアルタイムで取得する方法
価格はモデルやパラメータによって変動するため、プログラムを使用してリアルタイムで取得してください。ハードコーディングしないでください:- 呼び出し価格:ターゲット API に対してPAYMENT-SIGNATURE(および
Authorization)を含まないリクエストを1回送信し、返却された402のaccepts[].maxAmountRequiredを読み取ります。このステップでは課金されません。exactインターフェースではそれが最終価格です;uptoインターフェース(チャット)では上限であり、実際には使用量に基づいて決済されます。 - チャットの各トークン単価:
GET https://platform.acedata.cloud/api/v1/models?with_pricing=true&type=chatを実行し、各モデルのpricing.input_usd/pricing.output_usdを読み取ります(すでにcredit_usd_rateに基づいて計算されています)。 - 換算検証:
atomic = floor(Credits × 0.095215 × 1e6)、USDC = atomic / 1e6(つまりUSDC ≈ Credits × 0.095215)。
小結
- X402 価格 = この呼び出しの Credits コスト ×
0.095215、および通常の Credits 課金は同じ価格で、ただしチェーン上の USDC で決済されます。 0.095215/Credit はプラットフォームの最適価格(大口)Credits 単価です;少額チャージで購入した Credits の単価は高いため、X402 は自動的に最適単価を得ることになります。exactインターフェース(画像 / 動画 / 音楽 / 検索 / 注文)での署名金額はその回の支払金額です;uptoインターフェース(チャット)での署名は上限で、実際の使用量に基づいて決済されます。- 権威ある価格は 402 が返す
maxAmountRequiredに基づきます:exactは支払金額(成功した応答のcost.amountと一致し、実測済み);uptoは上限で、成功した応答のcost.amountが使用量に基づいて決済される実際の金額(≤ 上限)です。

