メインコンテンツへスキップ
Python SDK は、バックエンドサービス、データタスク、自動化 Agent、バッチ処理スクリプトに適しています。acedatacloud は API 呼び出しを担当し、acedatacloud-x402 は PAYMENT-SIGNATURE リクエストヘッダーの署名を担当します。 ソースコードとパッケージのアドレス:

依存関係のインストール

upto を使用する場合は、Permit2 approve CLI を一度呼び出す必要があり、この CLI は web3 に依存します:
クリーンな Python venv でのインストールおよびインポート確認出力:
結果の説明:
  • acedatacloud と acedatacloud-x402 はどちらも PyPI からインストールおよびインポートできます。
  • pip install 'acedatacloud-x402[cli]' は approve-permit2 CLI を含め、upto の事前承認に使用します。

Base の例

以下の例では API Token は不要です。ウォレットの秘密鍵はローカルでの署名にのみ使用され、Ace Data Cloud には送信されません。
Python SDK は現在 dict を返すため、例では res["choices"][0]["message"]["content"] を使用しています。必ず .choices 属性を持つと直接仮定しないでください。

Solana の例

Solana は base58 エンコードされた secret key を使用します:
Solana のパスでは、SPL USDC の 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 を優先して使用する場合:
Base 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 方式:
プログラム方式:
この helper は冪等です。allowance がすでに十分である場合、{"skipped": true} を返し、オンチェーントランザクションを重複して送信しません。

低レベル署名

SDK を使用しない場合でも、低レベル署名関数を直接呼び出せます:
低レベル関数は、テスト、プロキシレイヤー、ゲートウェイ統合、または公式 SDK 以外での利用に適しています。通常の業務コードでは create_x402_payment_handler を優先して使用してください。