API reference

The production API base URL is:

https://api.anonrouter.ai/v1

Requests authenticate one of three ways, depending on the endpoint:

• Inference key (ar_) in Authorization: Bearer to issue tickets and, in compatibility mode, to call inference directly.
• Management key (arm_) in Authorization: Bearer to read balance and usage.
• Inference ticket in the x-anonrouter-ticket header to run a single ticketed request.

Some account and billing operations require an authenticated session and are performed from the dashboard rather than with an API key.

Inference

In compatibility mode, /chat/completions and /embeddings accept an inference key directly instead of a ticket.

Routing

Account

Workspaces

Billing

Response headers

Successful inference responses include:

• x-anonrouter-selected-model: the chosen provider/model.
• x-anonrouter-routing: auto or exact.
• x-ratelimit-limit-requests, x-ratelimit-remaining-requests, x-ratelimit-reset-requests, and the matching -tokens variants.

Errors

Errors use an OpenAI-style envelope with a machine-readable type and a request_id:

{
  "error": {
    "message": "Inference ticket is invalid or expired",
    "type": "invalid_ticket",
    "request_id": "req_..."
  }
}

Common cases:

A 429 response also sets a retry-after header. During streaming, a mid-stream provider failure is delivered as an inline SSE error frame rather than an HTTP status, because the response headers have already been sent.