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:
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 --useWith --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
| Command | What it does |
|---|---|
alran provider list | List 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.