Bring your own model

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 deployment: the assistant, agent, and automations. Bring your own model applies to a single deployment, not to your whole organization. If your organization has more than one deployment, configure each one separately. Deployments you don’t configure use Mintlify’s default models.

​

Supported providers

Each provider supports a fixed set of models.

​

Configure your model

Editors and admins can configure the model.

1. Select the deployment you want to configure.
2. Navigate to the API keys page in your dashboard.
3. In the AI model section, enable Bring your own model.
4. 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.
5. Select a model.
6. Enter your provider API key.
7. Click Save.

Mintlify stores your key encrypted and never displays it again after you save it.

​

How credits work

Mintlify’s AI products still consume credits when you bring your own model, but at a reduced rate for the deployment you configured. Credits pool at the organization level, so the reduced rate applies only to the AI usage on deployments where you use your own model. Other deployments draw from the same balance at the standard rate. Your provider bills you directly for inference. Those charges do not appear in your Mintlify usage, so set any spending limits with your provider.

​

Rotate or remove your key

Mintlify reuses your saved key across models for the same provider on that deployment. Enter a key again only when you rotate it, switch providers, or configure another deployment. 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 deployment, and its AI products return to Mintlify’s default models at the standard credit rate. Other deployments keep their own configurations.