# Ged x402 — Workers AI pay-per-request API

> https://ged-x402.jvalamis.workers.dev

Autonomous agents discover, pay (HTTP 402 + USDC on Base), and call inference — no API keys.

## Flow

1. `GET /.well-known/x402` or `/.well-known/x402.json` for route catalog
2. Call any paid route without payment → `402 Payment Required` with `outputSchema`
3. Pay via x402 facilitator (AgentCash, AgentKit, `withX402Client`, etc.)
4. Retry with `PAYMENT-SIGNATURE` header → inference JSON

## Agent setup (AgentCash)

```bash
npx agentcash init
npx agentcash fund --network base-sepolia
npx agentcash try https://ged-x402.jvalamis.workers.dev/v1/sentiment --data '{"text":"great"}'
```

## Endpoints

- https://ged-x402.jvalamis.workers.dev/v1/chat/completions
- https://ged-x402.jvalamis.workers.dev/v1/chat/fast
- https://ged-x402.jvalamis.workers.dev/v1/chat
- https://ged-x402.jvalamis.workers.dev/v1/chat/smart
- https://ged-x402.jvalamis.workers.dev/v1/chat/micro
- https://ged-x402.jvalamis.workers.dev/v1/embed
- https://ged-x402.jvalamis.workers.dev/v1/embed/small
- https://ged-x402.jvalamis.workers.dev/v1/embed/large
- https://ged-x402.jvalamis.workers.dev/v1/rerank
- https://ged-x402.jvalamis.workers.dev/v1/translate
- https://ged-x402.jvalamis.workers.dev/v1/summarize
- https://ged-x402.jvalamis.workers.dev/v1/sentiment
- https://ged-x402.jvalamis.workers.dev/v1/classify/image
- https://ged-x402.jvalamis.workers.dev/v1/vision/describe
- https://ged-x402.jvalamis.workers.dev/v1/speech/transcribe

## Pricing

- `GET /v1/models` — live catalog + computed `price_usd` per route
- 402 gate prices use deploy-time worst-case tiers from `pricing/catalog.json`
- Formula: max(floor, (neurons/1000)*0.011*MARKUP + buffer)

## Discovery

- https://ged-x402.jvalamis.workers.dev/openapi.json
- https://ged-x402.jvalamis.workers.dev/.well-known/x402
- https://ged-x402.jvalamis.workers.dev/.well-known/x402.json
- https://ged-x402.jvalamis.workers.dev/llms.txt