# imagegen.coinopai.com
> AI image generation API. Pay per image via x402 on Base mainnet.

## Endpoints
GET /generate?prompt={text}&aspect={ratio}
- Requires x402 payment: 0.25 USDC on Base (eip155:8453)
- Tier: standard
- Returns: {"image_url":"...","prompt":"...","aspect":"...","generated_at":"..."}
- aspect options: 1:1 (default, 1024x1024), 16:9 (1024x576), 9:16 (576x1024), 4:3 (1024x768)

GET /generate/clean?prompt={text}&aspect={ratio}
- Requires x402 payment: 0.35 USDC on Base (eip155:8453)
- Tier: clean image with background removal
- Returns transparent PNG URL

GET /generate/hd?prompt={text}&aspect={ratio}
- Requires x402 payment: 0.50 USDC on Base (eip155:8453)
- Tier: premium image with 4x upscale
- Returns high-resolution image URL

GET /generate/pro?prompt={text}&aspect={ratio}
- Requires x402 payment: 0.75 USDC on Base (eip155:8453)
- Tier: top-tier image with background removal + 4x upscale
- Returns transparent high-resolution image URL

## Rate Limits
- 10 requests per minute per IP across all tiers

## Payment
- Network: Base mainnet
- Receiving wallet: 0x4C1a4FcE51Fea51f128a01ccE8BecB106d391155
- Facilitator: https://x402.xyz/facilitate
- Live extensions: Bazaar discovery and optional payment-identifier idempotency
- Signed offer/receipt extension: available when OFFER_RECEIPT_SIGNING_PRIVATE_KEY is configured
- Builder code extension: configured when BUILDER_CODE is present
- Sign-in-with-x: not needed for one-shot image outputs

## Use cases
- Automated image generation for AI agents and bots
- Bot-to-bot creative workflows
- Programmatic content creation pipelines

## ForgeMesh Fleet
- Paid registry: POST https://x402.forgemesh.io/fleet-products ($0.05) — id, name, host, category, route_count, price_range per product
- Paid spec sheet: POST https://x402.forgemesh.io/fleet-product-detail ($0.05) — every route, method, price, input schema, worked example for one product
- Free index: https://x402.forgemesh.io/llms.txt