Skip to main content

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.OpenRouter provider setup dialog
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.
Users then see Auto in the model picker. Onyx records the cost of the model that OpenRouter served.