> ## Documentation Index
> Fetch the complete documentation index at: https://danswer-mintlify-deep-research-1773355783.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenRouter

> Using OpenRouter with Onyx

## Guide

Configure Onyx to use models served by [OpenRouter](https://openrouter.ai/).

<Steps>
  <Step title="Setup OpenRouter and Deploy your Models">
    Log in to your OpenRouter account and create a new API key.
  </Step>

  <Step title="Navigate to AI Model Configuration Page">
    Access the Admin Panel from your user profile icon → **Admin Panel** → **LLM**
  </Step>

  <Step title="Configure OpenRouter">
    Select **OpenRouter** from the available providers.

    Give your provider a **Display Name**.

    Enter your OpenRouter **API Key**.

    Click the **Fetch Available Models** button to see the models currently available on OpenRouter.

    <img className="rounded-image" src="https://mintcdn.com/danswer-mintlify-deep-research-1773355783/mwF-EX7U3MAkhK8q/assets/admins/ai_models/openrouter_config.png?fit=max&auto=format&n=mwF-EX7U3MAkhK8q&q=85&s=b175782572e975b7e86d1ada880300d0" alt="OpenRouter Provider Configuration" width="1780" height="982" data-path="assets/admins/ai_models/openrouter_config.png" />
  </Step>

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

    <Tip>
      If you select a Fast Model,
      make sure it is a relatively quick and cost-effective model like GPT-4.1-mini or Claude 3.7 Sonnet.
    </Tip>
  </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, you may select whether or not the provider is 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>
