Guide
Configure Onyx to use models served by OpenRouter.1
Create an OpenRouter API Key
Log in to your OpenRouter account and create a new API key.
2
Navigate to Language Models
Open the Admin Panel from your user profile icon, then open Language Models.
3
Connect OpenRouter
Under Gateways & Routers, click Connect on the OpenRouter card.Paste your OpenRouter API Key.Keep the default API Base URL (
https://openrouter.ai/api/v1),
or enter the URL of an OpenRouter-compatible endpoint.
4
Load Your Models
In the Models section, click Refresh models. Onyx reads the current OpenRouter catalog,
including each model’s context size and capabilities (vision, reasoning).
5
Choose Visible Models
In the Models section, select the models that users can pick in chat. If a model is missing,
open More Models or type its name and click Add Model.Limiting visible models helps when a provider publishes many models and versions of the same model.
6
Set Models Access
Under Models Access, choose All Users & Agents or Named Groups & Agents.With Named Groups & Agents, only Admins and the User Groups and Agents you name can use the models.
Named groups need a Business plan or higher.
7
Connect
Click Connect. Onyx tests the API key with one of the selected models before it saves the provider.
Auto Mode with the OpenRouter Router
OpenRouter exposes a router model (openrouter/auto) that picks a model for each request.
Onyx can offer this router to users as an Auto option in the chat model picker.
1
Enable the Router Model
Select the OpenRouter router model in the provider’s Models list and save the provider.
2
Turn On Auto Mode
On the Language Models page, turn on Auto Mode.
3
Select the Router Model
Under Router Model, select the OpenRouter router.