DEEN

DocsModels

Your own provider

Bring your own provider key. Those calls go straight to the provider: Ottili doesn’t see, meter or bill them.

How do I add my own provider?

Keep the key in your environment, then add the provider:

bash
export MY_PROVIDER_API_KEY=...
alran provider add --name my-provider --base-url https://example.com/v1 \
  --api-format openai-completions --model my-model \
  --api-key-env MY_PROVIDER_API_KEY --use

With --api-key-env, the key is never written to disk. Supported formats: openai-completions, openai-responses and anthropic-messages. Your own key needs no Ottili account.

Known providers

alran models --third-party explains the catalogue of known providers and how to use each with your key. In the TUI, /provider shows providers and edits credentials.

Manage providers

CommandWhat it does
alran provider listList configured providers
alran provider test <id>Test a provider or one of its models
alran provider remove <id>Remove a custom provider
alran provider use <source>Choose where Alran takes credentials from

Images

If the provider's model accepts images, say so with --support-image when you add it. Alran never guesses image support from a model's name.

Common questions

How do I add my own provider?

Keep the key in your environment, then add the provider with alran provider add --name my-provider --base-url https://example.com/v1 --api-format openai-completions --model my-model --api-key-env MY_PROVIDER_API_KEY --use. With --api-key-env the key is never written to disk, and your own key needs no Ottili account.

Which providers can I use with my own key?

alran models --third-party explains the catalogue of known providers and how to use each with your key. The supported API formats are openai-completions, openai-responses and anthropic-messages.

Does Ottili see or bill the calls to my own provider?

No. Those calls go straight to the provider: Ottili neither sees, meters nor bills them. Providers are yours to manage, with alran provider list, alran provider test, alran provider remove and alran provider use.