OpenRouter
Connect OpenRouter as an AI Gateway provider
An OpenRouter provider forwards Chat Completions requests to OpenRouter. Use it as an aggregator when you want one key to reach many upstream models through OpenAI Chat Completions.
See AI Providers if you haven't created a provider before. Field options are in Provider Configuration.
Defaults
| Setting | Value |
|---|---|
| Upstream URL | https://openrouter.ai/api/v1 |
| Auth type | Bearer |
| Capabilities | OpenAI Chat Completions |
OpenRouter's default capability is Chat Completions only. Clients that require Responses or Anthropic Messages need a different provider, extra capabilities this OpenRouter account actually supports, or a custom endpoint.
Configure
- Sidebar → AI Gateway → Providers → Create.
- Set Provider Type to OpenRouter. Name, capabilities, upstream URL, and auth type fill in from the defaults above.
- Paste your OpenRouter API key.
- Set Allow and Block lists. OpenRouter model keys are often vendor-prefixed, for example
openai/gpt-4ooranthropic/claude-sonnet-4. - Save, then attach the provider to an AI Gateway resource.
Models
OpenRouter is an aggregator. See Model Routing for how allow lists and GET /v1/models discovery work. Add exact keys such as openai/gpt-4o or anthropic/claude-sonnet-4.
Clients
| Client | Guide |
|---|---|
| Codex | Setup guide |
| OpenCode | Setup guide |
| Open WebUI | Setup guide |
| OpenClaw | Setup guide |
Was this page helpful?

