Skip to main content
この文書は、X402を使用してAce Data Cloud APIを呼び出す際の価格設定と、それがプラットフォームの通常のCredits(クレジット)価格との関係について説明します。

核心結論

X402は独立した価格体系ではありません。各API呼び出しには元々Creditsで計算されたコストがあり、これはすべての課金方法(APIトークンによるクレジットの引き落とし、アカウント残高、X402のオンチェーン支払い)で共通の唯一の価格源です。X402はこのCreditsコストを固定レートでオンチェーンUSDCに換算します:
1 Credit = 0.095215 USDC(つまり95215 atomic USDC、USDCは6桁の小数)
つまり:
このレートは無作為に設定されたものではなく、プラットフォームの最適な階層(大口)Credits単価に等しいです。したがって、X402で支払うことは、最適な階層単価でCreditsを購入して消費することにほぼ等しく、X402のプレミアムはありません。むしろ、最も安いCredits単価を直接享受でき、事前のチャージやAPIトークンは不要です。

価格基準

換算はプラットフォームによって統一され、金額はすべてのサポートされているネットワーク(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)で、実際は真の使用量に基づいて決済され、上限を超えません。
この2つのスキームのプロトコル詳細については、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 の例):
500のプロンプトトークンと200のコンプリーショントークンのリクエスト:
クライアントは 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 が使用量に基づいて決済される実際の金額(≤ 上限)です。

関連文書