Skip to main content

Guide

Configure Onyx to use models served through Bifrost.
Onyx connects to your Bifrost gateway by fetching the models exposed at its /v1/models endpoint. Bifrost can expose models from multiple vendors behind a single endpoint.
1

Set Up Your Bifrost Gateway

Make sure your Bifrost deployment is reachable from the Onyx server.You will need your Bifrost API Base URL.If your Bifrost deployment requires authentication, also generate a Bifrost API Key.
2

Navigate to Language Models

Access the Admin Panel from your user profile icon, then navigate to Configuration → Language Models.
3

Configure Bifrost

Select Bifrost from the available providers.Give your provider a Display Name.Enter the API Base URL for your Bifrost gateway.If your gateway requires authentication, enter your API Key.Click Fetch Available Models to load the language models currently exposed by Bifrost.
4

Review the Imported Models

Onyx will import the model IDs returned by Bifrost and use the display names returned by the gateway when available.This is useful when your Bifrost gateway exposes models from multiple vendors such as Anthropic, OpenAI, or others.
5

Configure Default and Fast Models

The Default Model is selected automatically for new custom Agents and Chat sessions.Designating a Fast Model is optional. This Fast Model is used behind the scenes for quick operations such as evaluating the type of message, generating different queries (query expansion), and naming the chat session.
If you select a Fast Model, make sure it is a relatively quick and cost-effective model such as gpt-4.1-mini, gpt-4.1-nano, or a smaller Claude or Gemini model.
6

Choose Visible Models

In the Advanced Options, you will see a list of all models available from this provider. You may choose which models are visible to your users in Onyx.Setting visible models is useful when a provider publishes multiple models and versions of the same model.
7

Designate Provider Access

Lastly, decide whether the provider should be public to all users in Onyx.If set to private, the provider’s models will be available to Admins and User Groups you explicitly assign the provider to.