# Clawy AI Gateway — v1.1.0

> Pay-per-call AI inference gateway. GPT-5.5 (OpenAI) and Claude Opus 4.8 (Anthropic), plus a cost-optimized `/v1/chat/auto` tier, and AI image generation via `/v1/images/generate` — all billed per request in USDC via the x402 protocol on Base mainnet. Service wallet: `0x767C96C228560DE259C2DB1D3c636B4C87b01a0C`. Coinbase facilitator.

## Endpoints

- `POST /v1/chat/chatgpt` — OpenAI-compatible GPT-5.5 — **$0.10 USDC / call**
- `POST /v1/chat/opus` — OpenAI-compatible Claude Opus 4.8 — **$0.15 USDC / call**
- `POST /v1/chat/auto` — OpenAI-compatible cost-optimized tier (always safe margin) — **$0.04 USDC / call**
- `POST /v1/images/generate` — AI image generation (MiniMax image-01, single tier) — **$0.01 USDC / call (promo) / $0.05 (normal)**
- `GET /health` — free health check, lists current pricing and configured providers

## Models served

- `openai/gpt-5.5` — primary on /v1/chat/chatgpt, falls back to anthropic/claude-haiku-4-5 on error
- `anthropic/claude-opus-4-8` — primary on /v1/chat/opus
- `minimax/image-01` — single tier on /v1/images/generate (no model selection exposed)
- cost-optimized router — always-on for /v1/chat/auto (cheapest reliable)

Every response includes `x_clawy.provider` and `x_clawy.delivery` so the caller always knows which backend served the request.

## Payment

- Protocol: x402 v2 (HTTP 402 Payment Required)
- Networks: Base Mainnet (`eip155:8453`, default) + Solana Mainnet (`solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp`, opt-in via `SOLANA_ENABLED=1`)
- Asset: USDC on either chain (`0x8335...` on Base, `EPjF...` on Solana)
- Pay to: `0x767C96C228560DE259C2DB1D3c636B4C87b01a0C` (Base) / `8Zob6pHeTeCp7YTYAKbxEhncWVkevs2o1Ydi6mrSBj9w` (Solana)
- Facilitator: Coinbase CDP (Base) / Satoshi (Solana)

## Usage (Agent)

```bash
# 1. Initial request → 402 with payment requirements in the PAYMENT-REQUIRED header
curl https://clawy.uk/v1/chat/opus \
  -H "Content-Type: application/json" \
  -d '{"messages":[{"role":"user","content":"Hello"}]}'

# 2. Sign EIP-3009 transferWithAuthorization for the required amount
#    (0.10 / 0.15 / 0.04 USDC depending on endpoint)
#    Any standard x402 client does this — see https://x402.org

# 3. Retry the same POST with the X-PAYMENT header
curl https://clawy.uk/v1/chat/opus \
  -H "Content-Type: application/json" \
  -H "X-PAYMENT: <base64-encoded signed payment>" \
  -d '{"messages":[{"role":"user","content":"Hello"}]}'
```

## Response format

OpenAI-compatible `chat.completion` object: `{ id, object, model, choices[].message.content, usage }`. Plus non-standard `x_clawy` block: `{ provider, delivery, fallback }`.

## Discovery

- `/openapi.json` — OpenAPI 3.1 spec, registered with Coinbase Bazaar
- `/.well-known/x402.json` — x402 Bazaar manifest
- `/.well-known/agent-services.json` — generic agent catalog
- `/llms.txt` — this file

Listed on [x402scan](https://www.x402scan.com/recipient/0x767C96C228560DE259C2DB1D3c636B4C87b01a0C/resources). Coinbase Bazaar-discoverable.

## Legal

- Imprint / Anbieterkennzeichnung: <https://clawy.uk/impressum.html>
- Datenschutzerklärung: <https://clawy.uk/datenschutz.html>
- AGB: <https://clawy.uk/agb.html>
- Widerrufsbelehrung: <https://clawy.uk/widerruf.html>

## Categories

inference, llm, chat, openai-compatible, ai-agent, base, usdc, x402, gpt-5, claude-opus