scrape402

x402 の使用例 — AI エージェント向け従量課金 API

x402 で保護された HTTP API を呼び出すための動作する使用例です。エージェントは Base 上でリクエストごとに USDC を支払います。登録も API キーもサブスクリプションも不要です。

すべての使用例は x402.shizu.me（稼働中のエンドポイント 77 個、料金は 1 回あたり $0.001 から）に対して実行できます。OpenAI 互換の LLM ゲートウェイ（/v1/chat/completions、/v1/embeddings、/v1/models）、ウェブ検索、コードサンドボックス、ウェブスクレイピング、リアルタイムの暗号資産／市場データ、検証可能な乱数、さらに高頻度ループ（毎分 100 回以上の呼び出し、呼び出しごとのガス代なし）向けの前払いオフチェーン従量課金レールを利用できます。

x402 の仕組み

1. 呼び出し — 任意のエンドポイントを呼び出すと、HTTP 402 レスポンスに署名済みの USDC 支払い要件（価格、アセット、受取先）が含まれます。
2. 支払い — x402 クライアントがローカルで支払いに署名し、自動的に再試行します。
3. サービス提供 — 決済はオンチェーンで行われ、呼び出しが成功した場合のみ課金されます。エラーと 4xx は決済されません。

Base 上の USDC をウォレットに数ドル分入金し、秘密鍵をエクスポートすれば、ここにあるすべての使用例をそのまま実行できます。

JavaScript

npm install x402-fetch viem
export X402_PRIVATE_KEY=0x...   # wallet holding USDC on Base
node js/chat.mjs

Python

pip install x402 eth-account httpx
export X402_PRIVATE_KEY=0x...
python python/chat.py

使用例

ファイル	内容
js/chat.mjs	OpenAI 互換のチャット補完を呼び出しごとに支払って利用
js/search.mjs	検索 API アカウントなしでリアルタイムのウェブ検索
python/chat.py	Python x402 クライアント経由のチャット補完
python/embeddings.py	RAG ループ向けの OpenAI 形式の埋め込み
python/metered_loop.py	1 回前払いして、オフチェーンで毎分 100 回以上呼び出し

まずは見てみたいですか？

すべてのルートでは、無料の未払いリクエストで料金を確認できます。

curl -i https://x402.shizu.me/crypto        # → 402 + payment requirements
curl https://x402.shizu.me/llms.txt          # full catalog, agent-readable

リンク

稼働中のサービス：https://x402.shizu.me · OpenAPI：https://x402.shizu.me/openapi.json · MCP ツール：https://x402.shizu.me/.well-known/mcp-tools · お問い合わせ：[email protected]

MIT ライセンスです。