OpenRouter
Use this when one aggregation or routing layer should sit in front of multiple upstream model vendors while staying explicit in config.At A Glance
| Field | Value |
|---|---|
| Built-in kind | openrouter |
| Provider group | Gateway And Compatibility Providers |
| Protocol family | openai_chat_completions |
| Feature family | openai_compatible |
| Auth scheme | bearer |
| Credential envs | OPENROUTER_API_KEY |
| Aliases | openrouter_compatible |
| Default base URL | https://openrouter.ai |
| Request endpoint | https://openrouter.ai/api/v1/chat/completions |
| Models endpoint | https://openrouter.ai/api/v1/models |
Minimal Config
Verify It
list-models is unreliable for this account or region, pin an explicit provider.model or add preferred_models instead of leaving recovery implicit.
Auth And Routing Contract
| Contract | Value |
|---|---|
| Auth optional | no |
| Model probe auth optional | no |
| Default API key env | OPENROUTER_API_KEY |
| OAuth env | none |
| Primary request route | https://openrouter.ai/api/v1/chat/completions |
| Primary model-catalog route | https://openrouter.ai/api/v1/models |
Related Docs
- Continue to Providers And Models when you still need the broader chooser page.
- Continue to Provider Guides for the full built-in provider matrix.
- Continue to Provider Recipes for representative rollout recipes.
- Continue to Configuration Patterns for the shared provider-profile shape.