Skip to main content

​
Base URL

https://api.arouter.com

​
Authentication

All endpoints (except /healthz) require authentication via one of:
MethodHeader / ParameterUsed By
Bearer TokenAuthorization: Bearer <key>OpenAI SDK, most clients
API Key HeaderX-Api-Key: <key>Anthropic SDK
Query Parameter?key=<key>Gemini SDK
See the Authentication Guide for details.

​
Endpoint Groups

OpenAI Compatible

/v1/chat/completions, /v1/embeddings, /v1/modelsUse with any OpenAI-compatible SDK. Supports provider/model routing.

Anthropic Native

/v1/messages, /v1/messages/batches, /v1/messages/count_tokensDrop-in compatible with the Anthropic SDK.

Gemini Native

/v1beta/models/{model}:generateContentDrop-in compatible with the Google Gemini SDK.

Key Management

/api/v1/keysCreate, list, update, and delete API keys via the management API.

​
Response Format

All responses are JSON. Successful responses match the upstream provider’s format exactly. Error responses follow a consistent format: 
{
  "error": {
    "message": "description of what went wrong",
    "type": "error_type"
  }
}

​
Rate Limits

Rate limits are applied per API key. Default limits can be customized per key via the Dashboard or via key configuration in the management API.
HeaderDescription
X-RateLimit-LimitMaximum requests per window
X-RateLimit-RemainingRequests remaining
X-RateLimit-ResetWindow reset time (Unix timestamp)