OpenRouter

Use this provider to route to OpenRouter's catalog — a single OpenAI-compatible endpoint that fronts OpenAI, Anthropic, Google, Meta, Mistral, Cohere, and many more. Aurora passes requests through to OpenRouter with no translation.

Activate

OPENROUTER_API_KEY=sk-or-...

Restart Aurora. The openrouter provider appears at /v1/models with OpenRouter's full catalog of 300+ model IDs.

Default models

OpenRouter has hundreds of models; Aurora seeds a representative subset. The full list is always available by calling /v1/models at runtime. Override with OPENROUTER_MODELS=openai/gpt-4o,anthropic/claude-sonnet-4-5,google/gemini-2.5-pro.

Multiple instances

OPENROUTER_TEAM_ALPHA_API_KEY=sk-or-...
OPENROUTER_TEAM_BETA_API_KEY=sk-or-...

Aurora exposes them as openrouter-team-alpha and openrouter-team-beta. Use routing scopes to keep their usage segregated.

Custom base URL

OPENROUTER_BASE_URL=https://openrouter.ai/api/v1

Recommended extras

OpenRouter ranks providers in their dashboard by traffic source. Set these to make your traffic identifiable:

OPENROUTER_SITE_URL=https://your-app.example.com
OPENROUTER_APP_NAME=Your App Name

Gotchas

• Model ID format — OpenRouter uses <provider>/<model> strings, e.g. openai/gpt-4o, anthropic/claude-sonnet-4-5. Aurora's provider/model format lines up naturally; pass the OpenRouter ID through.
• Pricing — OpenRouter adds a small markup. Set your own pricing overrides in Aurora to reflect the real cost.
• Provider passthrough — OpenRouter's non-OpenAI features (their own /api/frontend/models, ranking endpoints) are not in Aurora's translated path. Use passthrough at /p/openrouter/*.
• Streaming — supported, end-to-end SSE.
• Reasoning models — OpenRouter returns reasoning content as reasoning blocks. Aurora preserves them.
• Function calling — full support, no quirks.

Sample request

curl http://localhost:8080/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $AURORA_MASTER_KEY" \
  -d '{
    "model": "openrouter/anthropic/claude-sonnet-4-5",
    "messages": [{"role": "user", "content": "Hello from Aurora"}]
  }'

Related

• Providers Overview
• Pricing — override OpenRouter's listed prices