> ## 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 は HTTP `402 Payment Required` に基づくオンチェーン支払いプロトコルです。Ace Data Cloud の X402 機能を通じて、呼び出し元は API トークンを作成せず、アカウントの残高を事前にチャージすることなく、毎回の API リクエストで直接 USDC を使用してオンチェーン支払いを行うことができます。 このドキュメントは、実際の接続順序に従って整理されています：まず最小リクエストを通して、次に SDK を接続し、その後ネットワーク、料金プラン、注文支払い、Facilitator を理解します。以下の表に従って上から下へ読むことをお勧めします。 | チュートリアル | 適用シーン | リンク | | - | - | - | | クイックスタート | 最小リクエストを使用して 402、`accepts` および `PAYMENT-SIGNATURE` フローを理解する | [X402 クイックスタート](https://platform.acedata.cloud/documents/x402-quickstart) | | TypeScript SDK | ブラウザ、Node.js またはフロントエンドアプリで Ace Data Cloud API を呼び出す | [TypeScript SDK 接続](https://platform.acedata.cloud/documents/x402-typescript-sdk) | | Python SDK | Python サービス、スクリプト、エージェントまたはデータパイプラインで API を呼び出す | [Python SDK 接続](https://platform.acedata.cloud/documents/x402-python-sdk) | | 注文支払い | X402 を使用して Ace Data Cloud コンソールの注文を支払う | [注文支払いチュートリアル](https://platform.acedata.cloud/documents/x402-order-payment) | | ネットワークと支払い方法 | Base、SKALE、Solana の資産、署名および適用シーンを理解する | [ネットワークと支払い方法](https://platform.acedata.cloud/documents/x402-networks) | | `exact` と `upto` | 固定価格 API と使用量後払い API を区別する | [料金プラン説明](https://platform.acedata.cloud/documents/x402-metered-upto) | | 価格説明 | X402 価格とクレジット単価の関係、および各サービスの実際の価格を理解する | [X402 価格説明](https://platform.acedata.cloud/documents/x402-pricing) | | Facilitator | `verify`、`settle` および自作の受取 API のサーバーサイドリンクを理解する | [Facilitator 統合](https://platform.acedata.cloud/documents/x402-facilitator) | | E2E とトラブルシューティング | 公開エンドポイントを確認し、高度な検証ツールを実行して一般的な 402、署名および決済の問題を特定する | [E2E 検証とトラブルシューティング](https://platform.acedata.cloud/documents/x402-e2e-troubleshooting) | ## 推奨接続パス Ace Data Cloud API を呼び出したいだけの場合は、公式 SDK を優先して使用してください： * TypeScript：`@acedatacloud/sdk` + `@acedatacloud/x402-client` * Python：`acedatacloud` + `acedatacloud-x402` 公開ソースコードとパッケージのアドレス： | プロジェクト | アドレス | | - | - | | Ace Data Cloud SDK | [https://github.com/AceDataCloud/SDK](https://github.com/AceDataCloud/SDK) | | X402 Client | [https://github.com/AceDataCloud/X402Client](https://github.com/AceDataCloud/X402Client) | | X402 Facilitator | [https://github.com/AceDataCloud/FacilitatorX402](https://github.com/AceDataCloud/FacilitatorX402) | | npm SDK | [https://www.npmjs.com/package/@acedatacloud/sdk](https://www.npmjs.com/package/@acedatacloud/sdk) | | npm X402 Client | [https://www.npmjs.com/package/@acedatacloud/x402-client](https://www.npmjs.com/package/@acedatacloud/x402-client) | | PyPI SDK | [https://pypi.org/project/acedatacloud/](https://pypi.org/project/acedatacloud/) | | PyPI X402 Client | [https://pypi.org/project/acedatacloud-x402/](https://pypi.org/project/acedatacloud-x402/) | SDK は最初の認証なしリクエスト、`402 Payment Required` の解析、支払いハンドラーの呼び出し、`PAYMENT-SIGNATURE` を持ってこれらのステップを再試行することを自動的に行います。あなたは USDC を持つウォレットを準備し、使用したいネットワークを選択するだけです。 自分の API でも X402 受取をサポートさせたい場合は、Facilitator ドキュメントを読み、`paymentRequirements`、`paymentPayload`、`/verify` および `/settle` の関係を理解する必要があります。 ## サポート状況 Ace Data Cloud X402 は公開 API、公式 SDK、Facilitator およびオンチェーン決済パスで検証を完了しました。以下の表は、開発者が接続時に最もよく使用する機能の次元に基づいて現在の状況をまとめています。 | 機能 | 状態 | 説明 | | - | - | - | | Facilitator 機能 | 利用可能 | `https://facilitator.acedata.cloud/.well-known/x402` が支払いネットワークとプロトコルエンドポイントを返します。 | | API 402 `accepts` | 利用可能 | 未支払いリクエストは Base、SKALE および Solana の利用可能な支払い要件を返します。 | | TypeScript SDK | 利用可能 | `@acedatacloud/sdk` と `@acedatacloud/x402-client` は自動的に 402、署名および再試行を処理します。 | | Python SDK | 利用可能 | `acedatacloud` と `acedatacloud-x402` は自動的に 402、署名および再試行を処理します。 | | Base `exact` | チェーン上で検証済み | 固定金額 API および注文支払いに適しています。 | | Base `upto` | チェーン上で検証済み | チャット補完などの後払い計量 API に適しており、現在唯一 `upto` を提供するネットワークです。 | | SKALE `exact` | チェーン上で検証済み | 低ガスコストの EVM 支払いシーンに適しています。 | | Solana `exact` | HTTP paid retry が検証済み | 検証済み API paid retry とモデル応答；チェーン上の署名確認には自分の Solana RPC での照合を推奨します。 | | 注文支払い | チェーン上で検証済み | Base `exact` 注文支払いはチェーン上での決済を完了し、注文状態を更新しました。 | 以下の出力は、検証済みパスの返却形態を示すためのものです。実際の接続時には、常に現在の API が返す `accepts` を基準としてください。 ```text theme={null} パッケージ @acedatacloud/sdk@2026.504.2 インポート成功 @acedatacloud/x402-client@2026.531.3 インポート成功 acedatacloud==2026.4.26.1 インポート成功 acedatacloud-x402==2026.5.31.3 インポート成功 API 402 ステータス 402 受け入れ eip155:8453/exact, eip155:8453/upto, solana:5eykt4.../exact, eip155:1187947933/exact TypeScript SDK コンテンツ ADC_TS_SDK_X402_OK Python SDK コンテンツ ADC_PY_SDK_X402_OK Base exact コンテンツ ADC_BASE_E2E_OK tx 0x408430ab3451bc22a51e510cdb4b063d6b9686724fea7a31fc109af20f5cd2f3 エクスプローラー https://basescan.org/tx/0x408430ab3451bc22a51e510cdb4b063d6b9686724fea7a31fc109af20f5cd2f3 SKALE exact コンテンツ ADC_SKALE_E2E_OK tx 0x9fd09901e74c763325fe118b2bc64765c3fca785b86b24a78b97964384db084f エクスプローラー https://skale-base-explorer.skalenodes.com/tx/0x9fd09901e74c763325fe118b2bc64765c3fca785b86b24a78b97964384db084f Base upto コンテンツ ADC_BASE_UPTO_OK tx 0x4b0b836ce1cd1171cdbc37df1637150b024214ec28e7f6f2d09122f15cbfc036 エクスプローラー https://basescan.org/tx/0x4b0b836ce1cd1171cdbc37df1637150b024214ec28e7f6f2d09122f15cbfc036 署名上限 95215 atomic USDC 転送額 3 atomic USDC Solana exact HTTP 402 -> HTTP 200 コンテンツ ADC_SOLANA_E2E_OK チェーン署名はこの実行では確認されていません 注文支払い 注文 78481793-304e-47f7-bc0c-8231aec9cc1e 状態 完了 支払い方法 X402 tx 0xfec08cc00a159ea1ec692b32faa9bf3d17595a986301169e689d94f58bc44151 エクスプローラー https://basescan.org/tx/0xfec08cc00a159ea1ec692b32faa9bf3d17595a986301169e689d94f58bc44151 ``` 説明： * npm と PyPI パッケージはすべてクリーンな環境にインストールされ、正常にインポートされました。 * 未支払いの API リクエストは 402 を返し、`accepts` には Base、SKALE、Solana の利用可能な支払い方法が含まれています。 * `accepts[].network` は CAIP-2 識別子であり、クライアントがネットワークを選択する際には CAIP-2 文字列に基づいて一致させる必要があります。 * TypeScript SDK と Python SDK はどちらも 402 を自動的に処理し、支払いの再試行を完了します。 * Base `exact`、SKALE `exact`、Base `upto` および注文支払いには公開可能なエクスプローラーのアドレスがあります。 * Base `upto` の署名上限は `95215` atomic USDC であり、実際の決済は `3` atomic USDC で、後置計量が実際の使用量に基づいて決済される特性を示しています。 * Solana `exact` は HTTP 402 -> HTTP 200 とモデル出力を検証しました。公開 RPC クエリが制限される可能性があるため、厳密な照合を行う際には独自の Solana RPC またはプラットフォーム側の決済記録を使用して取引署名を確認することをお勧めします。 ## 接続時の注意事項 開発者が接続する際は、ドキュメント内のサンプル金額やアドレスをコピーするのではなく、現在のリクエストが返すリアルタイムの支払い要件に優先的に注意してください： * `accepts[].maxAmountRequired` は現在のリクエストで署名可能な最大金額です。 * `accepts[].asset` は今回のリクエストで使用する USDC コントラクトまたはミントです。 * `accepts[].extra.chainId`、`accepts[].extra.facilitatorAddress` および `accepts[].extra.verifyingContract` は EVM タイプデータの署名に関与します。 * `upto` では、ウォレットが最初にターゲットチェーンの USDC に対して Permit2 を承認する必要があります。未承認の場合は `PERMIT2_ALLOWANCE_REQUIRED` が返されます。 * 明示的に後置計量を使用したい場合は、TypeScript SDK に `preferScheme: 'upto'` を渡してください。そうでない場合、SDK はそのネットワークでサーバーが返した最初の利用可能な要件を選択します。 ## 公開検証可能な範囲 接続前にこれらの公開エンドポイントと SDK の動作を検証できます： * `Authorization` または `PAYMENT-SIGNATURE` を持たない API リクエストは `402 Payment Required` を返し、レスポンス内の `accepts` は今回のリクエストの唯一の署名根拠です。 * TypeScript SDK と Python SDK はどちらも支払いハンドラーを提供し、SDK のトランスポート層は 402 を受け取るとハンドラーを呼び出し、再試行を行います。 * `https://facilitator.acedata.cloud/.well-known/x402`：ファシリテーターがサポートするネットワーク、スキーム、およびプロトコルエンドポイントを返します。API 価格は依然としてターゲットリクエストがリアルタイムで返す 402 に基づきます。 * `https://facilitator.acedata.cloud/supported`：ファシリテーターがサポートするネットワークとスキームを返します。 * X402Client リポジトリには、高度なチェーン上検証ツールが含まれており、署名、再試行、および決済動作を確認するために使用できます。ツールの出力はオンライン API が返す `accepts` を代替するものではありません。 `upto` は後置計量決済に属し、チャット補完、モデル呼び出しなど、実際の使用量が応答後にのみわかる API に適しています。現在、Base のみが `upto` を提供しています。署名検証が失敗した場合は、チェーン ID、ファシリテーターアドレス、支出者、USDC コントラクト、および Permit2 アローワンスが 402 レスポンスと一致しているか確認してください。 ``` ``` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.