Code Examples

npm install x402-fetch

import { wrapFetch } from 'x402-fetch'
 
const fetchX402 = wrapFetch(fetch, {
  payerWalletPrivateKey: process.env.WALLET_PRIVATE_KEY,
})
 
// Step 1: Make the request (x402-fetch handles the 402 → sign → retry flow)
const res = await fetchX402('https://402claw.cloud/api/x402/nano-banana', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    prompt: 'A photorealistic sunset over the ocean',
    aspect_ratio: '16:9',
  }),
})
 
const { taskId, statusUrl } = await res.json()
console.log('Task created:', taskId)
 
// Step 2: Poll for results
let result
while (true) {
  await new Promise(r => setTimeout(r, 2000))
  const status = await fetch(`https://402claw.cloud${statusUrl}`).then(r =>
    r.json()
  )
 
  if (status.status === 'success') {
    result = status.resultUrl
    break
  }
  if (status.status === 'failed') {
    throw new Error(`Generation failed: ${status.error}`)
  }
  console.log(`Status: ${status.status}, elapsed: ${status.elapsed}s`)
}
 
console.log('Image URL:', result)

const res = await fetchX402('https://402claw.cloud/api/x402/nano-banana', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    prompt: 'A cyberpunk city at night',
    aspect_ratio: '16:9',
    output_format: 'webp',
  }),
})

curl -s -w "\n%{http_code}" -X POST \
  https://402claw.cloud/api/x402/nano-banana \
  -H "Content-Type: application/json" \
  -d '{"prompt": "A beautiful mountain landscape"}'

{
  "error": "X402: Payment Required",
  "accepts": [{
    "scheme": "exact",
    "network": "base",
    "asset": "USDC",
    "amount": "50000",
    "recipient": "0x..."
  }]
}

# Replace TASK_ID with the taskId from the response
curl -s https://402claw.cloud/api/task/TASK_ID | jq

# After sending USDC to the gateway wallet on Base:
curl -X POST https://402claw.cloud/api/proxy-generate \
  -H "Content-Type: application/json" \
  -d '{
    "slug": "nano-banana",
    "prompt": "A beautiful mountain landscape",
    "txHash": "0xabc123...your_transaction_hash"
  }'

import requests
import time
 
BASE_URL = "https://402claw.cloud"
 
# Step 1: Discover endpoints
manifest = requests.get(f"{BASE_URL}/.well-known/agent-manifest.json").json()
endpoints = manifest["availableEndpoints"]
wallet = manifest["identity"]["walletAddress"]
 
print(f"Gateway wallet: {wallet}")
for ep in endpoints:
    print(f"  {ep['slug']}: {ep['title']} — ${ep['price']} USDC")
 
# Step 2: Send USDC to the gateway wallet on Base using web3.py
# (implementation depends on your wallet library)
# tx_hash = send_usdc(wallet, amount=0.05)
 
# Step 3: Submit generation request with tx hash
tx_hash = "0x..."  # Your transaction hash
response = requests.post(f"{BASE_URL}/api/proxy-generate", json={
    "slug": "nano-banana",
    "prompt": "A futuristic robot in a garden",
    "txHash": tx_hash,
})
data = response.json()
task_id = data["taskId"]
status_url = data["statusUrl"]
 
# Step 4: Poll for results
while True:
    time.sleep(2)
    status = requests.get(f"{BASE_URL}{status_url}").json()
 
    if status["status"] == "success":
        print(f"Done! Image URL: {status['resultUrl']}")
        break
    elif status["status"] == "failed":
        print(f"Failed: {status['error']}")
        break
    else:
        print(f"  Processing... ({status.get('elapsed', '?')}s)")