> ## Documentation Index
> Fetch the complete documentation index at: https://docs.onyx.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Bifrost

> Configure Bifrost as a language model gateway for Onyx

## Guide

Configure Onyx to use models served through [Bifrost](https://docs.getbifrost.ai/overview).

<Note>
  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.
</Note>

<Steps>
  <Step title="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**.
  </Step>

  <Step title="Navigate to Language Models">
    Access the Admin Panel from your user profile icon, then navigate to **Configuration → Language Models**.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>
</Steps>