acedatacloud は API 呼び出しを担当し、acedatacloud-x402 は PAYMENT-SIGNATURE リクエストヘッダーの署名を担当します。
ソースコードとパッケージのアドレス:
- SDK リポジトリ:https://github.com/AceDataCloud/SDK
- X402 Client リポジトリ:https://github.com/AceDataCloud/X402Client
- PyPI SDK:https://pypi.org/project/acedatacloud/
- PyPI X402 Client:https://pypi.org/project/acedatacloud-x402/
依存関係のインストール
upto を使用する場合は、Permit2 approve CLI を一度呼び出す必要があり、この CLI は web3 に依存します:
acedatacloudとacedatacloud-x402はどちらも PyPI からインストールおよびインポートできます。pip install 'acedatacloud-x402[cli]'はapprove-permit2CLI を含め、uptoの事前承認に使用します。
Base の例
以下の例では API Token は不要です。ウォレットの秘密鍵はローカルでの署名にのみ使用され、Ace Data Cloud には送信されません。dict を返すため、例では res["choices"][0]["message"]["content"] を使用しています。必ず .choices 属性を持つと直接仮定しないでください。
Solana の例
Solana は base58 エンコードされた secret key を使用します:TransferChecked トランザクションを構築して送信し、その後トランザクション署名を PAYMENT-SIGNATURE envelope に格納します。
Solana paid retry は本番 API で HTTP 200 と ADC_SOLANA_E2E_OK を返しています。今回の公開 RPC クエリではレート制限が発生し、オンチェーン signature を安定して確認できませんでした。照合が必要な場合は、自身の Solana RPC を使用してそのトランザクションを照会してください。
Async クライアント
同じ payment handler はAsyncAceDataCloud にも使用できます:
upto 後払い計量の使用
チャット補完、モデル呼び出しなどの API の実際のコストは、レスポンスが完了するまで判明しない場合があります。この場合、API は exact と upto を同時に返す可能性があります。upto を優先して使用する場合:
upto のプログラム実行結果:
content ADC_BASE_UPTO_OKは、リクエストが実際にモデル API に到達したことを示します。settled value 3 atomic USDCは、uptoが上限全額を差し引くのではなく、実際の使用量に応じて決済することを示します。settlement txは BaseScan で開くことができ、照合時には tx hash、payer、completion id、リクエスト要約を保存してください。
upto は Permit2 を使用して上限額を承認し、実際の決済額はこの上限を超えることはできません。初回使用前に、対象チェーン上の USDC に対して一度 approve(Permit2, amount) を行う必要があります。
CLI 方式:
{"skipped": true} を返し、オンチェーントランザクションを重複して送信しません。
低レベル署名
SDK を使用しない場合でも、低レベル署名関数を直接呼び出せます:create_x402_payment_handler を優先して使用してください。
