# v1.0

## x402 NFT Upload

Endpoint: POST https://api.nftitem.io/upload
Auth: x402 · eip155:8453 (Base) · USDC · $0.10/upload

Docker (preferred): nftitem/upload:latest
Env: X402_PRIVATE_KEY=<hex> (account holds USDC on Base)

Commands:
  docker run --rm -e X402_PRIVATE_KEY=<hex> nftitem/upload:latest --command upload
  docker run --rm -e X402_PRIVATE_KEY=<hex> -v ./images:/data nftitem/upload:latest --command upload --file /data/image.png
  docker run --rm nftitem/upload:latest --command inspect   # 402 probe, no spend
  docker run --rm nftitem/upload:latest --get-nft <tokenId>

Direct API: POST body { "command":"UPLOAD", "data":{ "content":"<base64 PNG>", "contentType":"image/png" } }
Retrieve: GET https://api.nftitem.io/nfts/{tokenId} → { "url": "..." }