> ## Documentation Index
> Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# X402 価格説明

> Platform API guide - Ace Data Cloud

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

## 核心結論

X402は独立した価格体系ではありません。各API呼び出しには元々**Credits**で計算されたコストがあり、これはすべての課金方法（APIトークンによるクレジットの引き落とし、アカウント残高、X402のオンチェーン支払い）で共通の唯一の価格源です。X402はこのCreditsコストを固定レートでオンチェーンUSDCに換算します：

> **1 Credit = 0.095215 USDC**（つまり`95215` atomic USDC、USDCは6桁の小数）

つまり：

```text theme={null}
X402 価格 (USDC) = この呼び出しのCreditsコスト × 0.095215
```

このレートは無作為に設定されたものではなく、プラットフォームの**最適な階層（大口）Credits単価**に等しいです。したがって、X402で支払うことは、最適な階層単価でCreditsを購入して消費することにほぼ等しく、**X402のプレミアムはありません**。むしろ、最も安いCredits単価を直接享受でき、事前のチャージやAPIトークンは不要です。

## 価格基準

| 項目 | 値 | 説明 |
| - | - | - |
| 換算レート | `1 Credit = 0.095215 USDC` | プラットフォームが統一して設定した固定レート |
| atomic単位 | `1 Credit = 95215 atomic USDC` | USDC 6桁の小数、`atomic = floor(credits × 0.095215 × 1e6)` |
| 最小課金 | `1 atomic USDC`（\$0.000001） | コストが極めて低くても、少なくとも1 atomicで決済される |
| 価格通貨 | USDC | Base / SKALEはERC-20 USDC、SolanaはSPL USDC |

換算はプラットフォームによって統一され、金額はすべてのサポートされているネットワーク（Base、SKALE、Solana）で一致します。異なるネットワークは資産契約と署名方法が異なるだけで、価格は同じです。

### 通常のCredits単価との関係

プラットフォームのCreditsは「使用量が多いほど、単価が低くなる」階段式で販売されています。X402は呼び出し時に、常に階段の最適単価を使用します：

| 購入/支払い方法 | 大体のCredits単価 | 説明 |
| - | - | - |
| 入門 / 小額チャージ | 約`$0.13 / Credit` | リスト価格、小額でCreditsを購入する際の単価 |
| 大口 / 最適階層 | `$0.095215 / Credit` | 最も安い単価 |
| **X402による呼び出し課金** | **`$0.095215 / Credit`** | **常に最適階層単価に等しい** |

言い換えれば、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`課金プラン](https://platform.acedata.cloud/documents/x402-metered-upto)を参照してください。以下では価格についてのみ説明します。

## Chat（チャット補完）価格

チャット補完は`upto`計量：プロンプト/コンプリーショントークンの実際の使用量に基づいて課金されます。百万（1M）トークンの価格 = `このモデルの1MトークンあたりのCreditsコスト × 0.095215`で、プラットフォームが公開しているモデルディレクトリ（`/api/v1/models?with_pricing=true`）に表示されているUSD単価と完全に一致します。

以下の表は実際の価格（モデルディレクトリから取得し、X402レートで計算）で、単位はUSD / 1Mトークン：

| モデル | 入力 / 1M | 出力 / 1M | `upto` 上限 |
| - | - | - | - |
| gpt-4o-mini | \$0.0796 | \$0.3183 | 1 Credit（\$0.095215） |
| gemini-2.5-flash | \$0.1591 | \$1.3262 | 5 Credits（\$0.476074） |
| gpt-5 / gpt-5.1 | \$0.6631 | \$5.3050 | 20 Credits（\$1.904299） |
| gemini-2.5-pro | \$0.6631 | \$5.3050 | 50 Credits（\$4.760750） |
| gpt-4.1 | \$1.0610 | \$4.2440 | 20 Credits（\$1.904299） |
| claude-sonnet-4-5 | \$0.6006 | \$3.0028 | 50 Credits（\$4.760750） |
| grok-4 | \$1.5915 | \$7.9574 | 10 Credits（\$0.952149） |
| claude-opus-4-1 | \$3.0028 | \$15.0140 | 50 Credits（\$4.760750） |

説明：

* 表中はトークン計量の単価；1回のリクエスト費用 = 入力トークン × 入力単価 + 出力トークン × 出力単価。
* `upto`上限はそのモデルの1回のリクエストで署名可能な最大金額；実際の引き落としではなく、ほとんどのリクエストは上限を大きく下回ります。
* 上限は「最大でどれだけ引き落とされる可能性があるか」を決定するだけで、実際の決済はトークンの使用量に基づいて計算されます。

### 例：見積もりと引き落としが一致する（`exact`）

以下は公式のX402Clientを使用して`serp/google`に対して行った**実際の有料呼び出し**（Base `exact`）です。これは3つの一致を示しています：402見積もり、署名金額、および成功レスポンス内で返される`cost`。

```text theme={null}
# 1) 未支払いリクエスト -> 402、見積もりを取得（引き落としなし）
POST /serp/google  ->  402
base/exact maxAmountRequired = 952 atomic = $0.000952 = 0.01 Credit
# 0.01 × 0.095215 = 0.00095215、atomicに切り下げて952

# 2) ウォレットで952 atomicのPAYMENT-SIGNATUREに署名し、再試行
POST /serp/google (PAYMENT-SIGNATURE) -> 200
body.cost = {"amount": 0.000952, "currency": "usdc", "settlement": "authorized"}
```

応答の返却された `cost.amount`（0.000952 USDC）は、402の見積もり、`Credits × 0.095215` と完全に一致しています。`settlement` フィールドはこの支払いの決済状態（`authorized` = 認可済み）を示します；チェーン上の決済はプラットフォームによって処理され、メカニズムは [`exact` と `upto` 課金プラン](https://platform.acedata.cloud/documents/x402-metered-upto) を参照してください。

### `upto` 見積もり計算（チャット）

チャットはトークンで計測されます。あるリクエストの見積もり（上限ではない）は、以下の式で計算されます（gpt-4o-mini の例）：

```text theme={null}
Credits = 1e-6 × (0.835733 × prompt_tokens + 3.342933 × completion_tokens)
USDC    = Credits × 0.095215
```

500のプロンプトトークンと200のコンプリーショントークンのリクエスト：

```text theme={null}
Credits = 1e-6 × (0.835733 × 500 + 3.342933 × 200) ≈ 0.001086 Credits
見積もり USDC ≈ 0.001086 × 0.095215 ≈ $0.0001034
```

クライアントは `upto` 上限（gpt-4o-mini は 1 Credit = `95215` atomic）で署名しますが、これは**最大でどれだけ引かれるか**を示すだけです；このリクエストの実際の見積もり（上記の例では約 \$0.0001）は上限を大きく下回り、トークンの使用量に基づいて決済されます。`upto` のチェーン上の決済メカニズムは [`exact` と `upto` 課金プラン](https://platform.acedata.cloud/documents/x402-metered-upto) を参照してください。

## その他のサービス価格（固定価格 `exact`）

画像、動画、音楽、検索などのインターフェースは、リクエスト時に価格が確定し、`exact` を使用します。以下の表は実際の価格で、オンラインインターフェースから未払いリクエストに対して返された402 `maxAmountRequired`から取得したものです（見積もりの問い合わせは課金されません）：

| サービス | サンプルモデル / パラメータ | Credits | USDC | atomic |
| - | - | - | - | - |
| ウェブ検索 | serp/google，≤10 件の結果 | 0.01 | \$0.000952 | 952 |
| 画像 | nano-banana | 0.14 | \$0.013330 | 13330 |
| 画像 | gpt-image-1，1024×1024 | 0.20 | \$0.019043 | 19043 |
| 画像 | flux-dev | 0.24 | \$0.022851 | 22851 |
| 画像 | midjourney imagine | 0.27 | \$0.025708 | 25708 |
| 画像 | seedream-4 | 0.32 | \$0.030468 | 30468 |
| 音楽 | suno generate | 0.55 | \$0.052368 | 52368 |
| 音楽 | producer generate | 0.68 | \$0.064746 | 64746 |
| 動画 | luma | 1.19 | \$0.113305 | 113305 |
| 動画 | hailuo（minimax-hailuo-2-3） | 1.72 | \$0.163769 | 163769 |
| 動画 | kling-v2-6 std | 2.10 | \$0.199951 | 199951 |
| 動画 | kling-v3 std | 4.20 | \$0.399903 | 399903 |
| 動画 | veo-3 text→video | 5.00 | \$0.476074 | 476074 |
| 動画 | seedance-1-0-pro，1080p / 5s | 5.60 | \$0.533204 | 533204 |
| 動画 | wan2.6-t2v | 13.50 | \$1.285402 | 1285402 |

説明：

* 同一サービスの価格は**モデル、解像度、時間、アクション**によって変動します（特に動画）。上表は特定のパラメータの下での実際の値であり、量的参考のためのものです。
* このような固定価格（`exact`）インターフェースでは、リクエストの402応答内の `maxAmountRequired` がその回の支払い金額となります（成功応答の `cost.amount` と一致し、前節で実測済み）。
* 各価格は `Credits × 0.095215` を下に切り捨てて atomic 単位に変換したものです（上記の価格基準を参照）、チャットで使用されるのと同じ換算方法です。浮動小数点表示と切り捨てのため、個別の値は単純な積と1 atomic（\$0.000001）異なる場合がありますが、すべて402の返却値を基準とします。

## 注文支払い価格

X402 支払いコンソールでの注文（パッケージ購入 / Credits 充填）の際、価格は注文ページに表示されるものが基準となり、402の `amount` が最終的な署名の根拠となります。注文支払いはプラットフォーム API を通じて行われ、アカウントトークンが必要です。詳細は [注文支払いチュートリアル](https://platform.acedata.cloud/documents/x402-order-payment) を参照してください。

注文支払いチュートリアルの実際の例（10 Credits 購入）：

```text theme={null}
description Ace Data Cloud Credits x 10.0
created price 1.26          # 注文作成価格（USD）
settled    1.20 USDC        # 最終署名/決済金額（= 402 amount）
            = 1200000 atomic USDC
```

注意：**呼び出しごとの支払い**（上記のチャット / その他のサービス）と**注文支払い**は異なる経路です。呼び出しごとの支払いは統一して `0.095215`/Credit の最適単価を使用します；注文支払いはパッケージ価格に基づき、その作成価格と最終決済金額の差異は [注文支払いチュートリアル](https://platform.acedata.cloud/documents/x402-order-payment) を基準とします。

## 価格をリアルタイムで取得する方法

価格はモデルやパラメータによって変動するため、プログラムを使用してリアルタイムで取得してください。ハードコーディングしないでください：

* **呼び出し価格**：ターゲット 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`）。

価格取得の最小リクエスト例：

```bash theme={null}
curl -sS -X POST https://x402.acedata.cloud/midjourney/imagine \
  -H 'Content-Type: application/json' \
  -d '{"prompt": "a cat"}'
# 返却された402のaccepts[].maxAmountRequiredがこの回（exact）の呼び出し価格です
```

## 小結

* X402 価格 = この呼び出しの Credits コスト × `0.095215`、および通常の Credits 課金は**同じ価格**で、ただしチェーン上の USDC で決済されます。
* `0.095215`/Credit はプラットフォームの**最適価格**（大口）Credits 単価です；少額チャージで購入した Credits の単価は高いため、X402 は自動的に最適単価を得ることになります。
* `exact` インターフェース（画像 / 動画 / 音楽 / 検索 / 注文）での署名金額はその回の支払金額です；`upto` インターフェース（チャット）での署名は上限で、実際の使用量に基づいて決済されます。
* 権威ある価格は 402 が返す `maxAmountRequired` に基づきます：`exact` は支払金額（成功した応答の `cost.amount` と一致し、実測済み）；`upto` は上限で、成功した応答の `cost.amount` が使用量に基づいて決済される実際の金額（≤ 上限）です。

## 関連文書

| 文書 | リンク |
| - | - |
| X402 統合ガイド（概要） | [X402 統合ガイド](https://platform.acedata.cloud/documents/x402-integration) |
| クイックスタート | [X402 クイックスタート](https://platform.acedata.cloud/documents/x402-quickstart) |
| `exact` と `upto` 課金プラン | [課金プラン説明](https://platform.acedata.cloud/documents/x402-metered-upto) |
| ネットワークと支払い方法 | [ネットワークと支払い方法](https://platform.acedata.cloud/documents/x402-networks) |
| 注文支払いチュートリアル | [注文支払いチュートリアル](https://platform.acedata.cloud/documents/x402-order-payment) |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.