Bring your own model
Use your own LLM provider API key and choose the model that powers the Mintlify assistant, agent, and automations on Enterprise plans.
By default, Mintlify selects the models that power the assistant and agent. To use a specific model with your own provider account, supply an API key and choose the model. Mintlify then runs inference against your provider.
One configuration covers every AI product on a project: the assistant, agent, and automations.
Bring your own model applies to a single project, not to your whole organization. If your organization has more than one project, configure each one separately. Projects you don't configure use Mintlify's default models.
Supported providers
Section titled “Supported providers”| Provider | Coverage |
|---|---|
| OpenRouter | Full. Every AI product uses your key and your model. |
| Anthropic | Limited. The assistant uses your key. The agent and automations continue to use Mintlify's models. |
| OpenAI-compatible | Limited. The assistant uses your key. The agent and automations continue to use Mintlify's models. |
Each provider supports a fixed set of models.
Configure your model
Section titled “Configure your model”Editors and admins can configure the model.
- Select the project you want to configure.
- Navigate to the API keys page in your dashboard.
- In the AI model section, enable Bring your own model.
- Select a provider. For an OpenAI-compatible provider, enter a provider name and base URL. The base URL must use HTTPS and point to a publicly reachable host.
- Select a model.
- Enter your provider API key.
- Click Save.
Mintlify stores your key encrypted and never displays it again after you save it.
How credits work
Section titled “How credits work”AI usage on a project with bring your own model enabled does not consume Mintlify credits. Your provider bills you directly for inference, and those charges do not appear in your Mintlify usage. Set any spending limits with your provider.
Credits pool at the organization level. Other projects in the same organization still draw from that shared balance at the standard rate for their AI usage.
Rotate or remove your key
Section titled “Rotate or remove your key”Mintlify reuses your saved key across models for the same provider on that project. Enter a key again only when you rotate it, switch providers, or configure another project.
To rotate your key, enter the new key in the API key field, then click Save.
To stop using your own model, disable Bring your own model. Mintlify deletes the stored configuration and key for that project, and its AI products return to Mintlify's default models. AI usage on the project then consumes credits at the standard rate. Other projects keep their own configurations.