DEEN

DocsModels

Models and credit

Ottili Werk 1.1 by default, Claude Sonnet 5.5 and Opus 5.5 one switch away. Werk runs on your credit, Claude on your own Anthropic key.

Which models can I use?

ModelShort nameInput / output per 1M tokensBilled by
Ottili Werk 1.1 (default)werk$0.50 / $1.50, cached input $0.03Ottili: welcome or purchased credit
Claude Sonnet 5.5sonnet$2.00 / $10.00 (Anthropic’s price)Anthropic, on your own key
Claude Opus 5.5opus$4.00 / $20.00 (Anthropic’s price)Anthropic, on your own key

alran models shows the live prices and whether you can use each model now: green yes, yellow Claude needs your Anthropic key, red the key was rejected or the credit is gone.

Choose a model

bash
alran config model sonnet          # the default from now on
alran models --set-default werk    # the same
alran -m alran/anthropic/claude-opus-5.5   # this session only

In the TUI, /model switches for the session. For one headless run: alran exec --model <provider/model> "…".

Credit and your Anthropic key

Werk is billed by Ottili from your credit, in two parts:

  • Welcome credit, granted on sign-up, pays for Werk.
  • Purchased credit pays for Werk too, once the welcome credit is used up.

Claude does not use your Ottili credit. It runs on your own Anthropic API key: add it once on the Ottili AI Platform under Settings → Provider keys. It is checked with Anthropic, stored encrypted and used only for your requests. Anthropic bills you directly; Ottili charges nothing for Claude and adds no fee. Without a key, a Claude request is refused with byok_key_required before anything is sent.

CommandWhat it shows
alran usageCredit left, the state of your Anthropic key, this month's tokens per model (Claude: billed by Anthropic)
alran billingPlan, payment method, last invoice and where to change them

Top up on the Ottili AI Platform.

When the gateway is down

A model call fails with exit code 4 and names the gateway. Alran Code never falls back to another provider on its own; choose your own provider explicitly if you need one.

Common questions

Which models can I use in Alran Code?

Ottili Werk 1.1 is the default. Claude Sonnet 5.5 and Claude Opus 5.5 can be selected instead, and alran models shows the live prices and whether you can use each model now.

How much does a model call cost?

Per 1M tokens, Ottili Werk 1.1 costs $0.50 input and $1.50 output, with $0.03 for cached input; it is paid from your Ottili credit, and the welcome credit covers it. Claude Sonnet 5.5 lists at $2.00 and $10.00, Claude Opus 5.5 at $4.00 and $20.00. Those are Anthropic’s prices: Claude runs on your own Anthropic API key, Anthropic bills you directly, and Ottili charges nothing for it.

How do I switch to another model?

In the TUI, /model switches for the session. Set a default with alran config model sonnet or alran models --set-default werk, and use alran exec --model provider/model for one headless run.