API REFERENCE
Endpoint, errors and limits
The Achoo gateway exposes a single OpenAI-compatible surface so every workspace can consume it with zero migration.
Base URL
https://gateway.achoo.dev/v1
model: achoo-001auth: Bearer sk-achoo-…
Request shape
POST https://gateway.achoo.dev/v1/chat/completions
{
"model": "achoo-001",
"messages": [{ "role": "user", "content": "Build a dashboard…" }]
}Responses follow the standard chat completion contract. Tokens are billed pay-as-you-go at $2.50 / 1M input and $7.50 / 1M output.
Errors & rate limits
| Code | Label | Detail |
|---|---|---|
| 401 | Unauthorized | Missing or invalid API key. |
| 404 | Not Found | Model or endpoint does not exist. |
| 429 | Rate Limited | Too many requests — retry after backoff. |
| 500 | Server Error | Sovereign engine failure — retry. |
| 503 | Unavailable | Gateway temporarily unavailable. |
Rate limits are enforced per key. Retry with exponential backoff and respect the Retry-After header on 429 responses.