---
title: "Your own provider · Alran Code Docs"
url: https://alran.dev/en/docs/byok
locale: en
updated: 2026-11-16
---

[Docs](https://alran.dev/en/docs)Models

# Your own provider

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

On this page

[How do I add my own provider?](#add) [Known providers](#catalogue) [Manage providers](#manage) [Images](#images) [Common questions](#faq)

## How do I add my own provider? {#add}

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 {#catalogue}

`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 {#manage}

| 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 {#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 {#faq}

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.

[PreviousModels and credit](https://alran.dev/en/docs/models) [NextWerk API](https://alran.dev/en/docs/api)
