API reference
Errors
What comes back when it goes wrong.
Status codes
If the model fails, sources and prices still return. Unknown API paths return JSON, not a page.
| Status | Meaning | What to do |
|---|---|---|
| 422 invalid_body | A field failed validation | q 2–500 chars, n 1–8, max_tokens 32–800, sources from /api/catalog |
| 429 free_tier | Free answers for the day are used up | Connect a wallet and pass your own gateway key |
| 429 rate_limit_exceeded | The devnet gateway is throttling | Back off. Scout already retries inside a 200 s budget |
| 429 miner_capacity_reserved | Every miner is at capacity | Retry shortly |
| 503 / 524 | Origin timeout at the gateway | Congestion, not your request. Sources still return |
| 401 model_not_allowed | Your key is not scoped for that model | New devnet keys get qwen2.5-0.5b only |
| 404 not_found | Unknown API path or miner address | GET /api/catalog lists what exists |