核心的な結論
X402 は独立した価格体系ではありません。各 API 呼び出しにはもともと Credits で表されるコストがあり、これはすべての課金方式(API Token によるクレジット消費、アカウント残高、X402 オンチェーン決済)で共通する唯一の価格ソースです。X402 はこの Credits コストを固定為替レートでオンチェーン USDC に換算しているだけです:
1 Credit = 0.095215 USDC(すなわち 95215 atomic USDC、USDC は小数点以下 6 桁)
つまり:
価格設定の基準
換算はプラットフォームで一律に行われ、金額は対応するすべてのネットワーク(Base、Solana)で同一です。ネットワークごとに異なるのはアセットコントラクトと署名方式のみであり、価格は同じです。
通常の Credits 単価との関係
プラットフォームの Credits は、「利用量が多いほど、単価が低くなる」段階制で販売されます。X402 の呼び出しごとの課金では、一律で最優遇階層の単価が使用されます:
言い換えると、X402 はすべての呼び出しを最優遇階層の Credits 単価で決済します。少額チャージで Credits を購入するユーザーの単価は X402 より高くなり、大口チャージのユーザーの単価のみが X402 と一致します。
2 種類の価格形態:exact と upto
X402 の 402 レスポンスにおいて、maxAmountRequired は署名する必要がある金額です。これには 2 種類の形態があります:
exact(固定価格):リクエスト処理前に価格を確定できるもの(画像、動画、音楽、検索、注文決済)。maxAmountRequired = その呼び出しの Credits コスト × 0.095215、すなわちその呼び出しで支払うべき金額です(成功レスポンス内のcost.amountと一致します)。upto(利用量の後払い計測):チャット補完のような「レスポンス終了時に初めて何 token 使用したか分かる」インターフェース。maxAmountRequiredは上限です(そのモデルに設定された上限クレジットを換算:上限 Credits × 0.095215)。実際には実使用量に応じて決済され、上限を超えることはありません。
exact と upto 課金方式をご覧ください。以下では価格のみを説明します。
Chat(チャット補完)価格
チャット補完はupto 計測です:prompt / completion token の実際の使用量に応じて課金されます。100 万(1M)token あたりの価格 = そのモデルの 1M token あたりの Credits コスト × 0.095215 であり、プラットフォームの公開モデルカタログ(/api/v1/models?with_pricing=true)に表示される USD 単価と完全に一致します。
以下の表は実際の価格です(モデルカタログから取得し、X402 の為替レートで計算)。単位は USD / 1M token:
説明:
- 表内は token ごとの従量単価です。1 回のリクエスト料金 = 入力 token × 入力単価 + 出力 token × 出力単価。
upto上限は、そのモデルで 1 回のリクエストに対して署名できる最大金額です。実際の請求額ではなく、大半のリクエストは上限を大きく下回ります。- 上限は「最大でいくら請求される可能性があるか」のみを決定し、実際の決済は token 使用量に基づいて計算されます。
例:見積もりと請求額は一致する(exact)
以下は、公式 X402Client を使用して serp/google に対して行った実際の有料呼び出しです(Base exact)。これは、402 の見積もり、署名金額、および成功レスポンスで返される cost の 3 つが一致することを示しています。
cost.amount(0.000952 USDC)は、402 見積もり、および Credits × 0.095215 と完全に一致します。settlement フィールドはこの支払いの決済ステータスです(authorized = 承認済み);オンチェーン決済はプラットフォームによって処理され、その仕組みは exact と upto の課金方式 を参照してください。
upto 見積もり計算(チャット)
チャットは token 単位で計量されます。あるリクエストの見積もり(上限ではない)は、次式で計算されます(gpt-4o-mini を例とする):
upto 上限(gpt-4o-mini では 1 Credit = 95215 atomic)で署名します。これは最大でいくら引き落とされる可能性があるかにすぎません;このリクエストの実際の見積もり(上例では約 $0.0001)は上限を大きく下回り、token 使用量に応じて決済されます。upto のオンチェーン決済の仕組みは、exact と upto の課金方式 を参照してください。
その他サービス価格(固定価格 exact)
画像、動画、音楽、検索のような API は、リクエスト時に価格を確定できるため、exact を使用します。以下の表は実際の価格であり、未払いリクエストに対してオンライン API が返す 402 の maxAmountRequired から取得したものです(見積もりの照会では料金は発生しません):
説明:
- 同一サービスの価格は、モデル、解像度、長さ、動作によって変わります(特に動画)。上表はある一組のパラメータにおける実際の値であり、規模感の参考用にすぎません。
- この種の固定価格(
exact)API では、そのリクエストの 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を読み取ります。この手順では料金は発生しません。exactAPI ではこれが最終価格です;uptoAPI(チャット)ではこれが上限であり、実際には使用量に応じて決済されます。 - チャットの token ごとの単価:
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が使用量に基づいて決済される実際の金額です(≤ 上限)。

