Providers overview

Brut is bring-your-own-key. You add a key for each provider you want to use; Brut calls that provider directly, on your key, at their price. Brut never holds a key that bills anyone but you, and never marks up a token.

#Adding keys

⚙ Settings on the left rail (or the setup wizard) shows every provider as a card — its role, and one status line — grouped by what it does (generation, aggregators, upscalers). Click a card to paste a key (validated on save); the switch on the card turns a provider off without deleting anything. Keys live in your OS keychain — never in a graph, never sent anywhere but the provider.

Image and video models need a billing-enabled key. Free tiers usually have zero generation quota, so your very first call fails with a quota error (429) — that's billing not enabled, not throttling. Turn on billing in the provider's console and it clears.

#The providers at a glance

#Model routes — native first, aggregator fallback

Some models can also run through an aggregator — a third-party service (like an aggregator subscription or a multi-model API) that resells the same model under its own billing. Brut treats those as routes, with three hard rules:

1. Your direct key always wins. If you hold the native provider's key, the generation goes straight to the provider, exactly as before. Routes only activate for a model when you have no native key but do hold the aggregator's credential.
2. Routing is always visible. A routed model shows a ⇄ runs via … chip on the node, the run confirm says who bills, and the ledger records it. Nothing routes silently.
3. The catalog stays curated. An aggregator credential never adds models to Brut — the model list is exactly the one Brut ships, whatever route serves it. Estimates for routed runs come from the route's own measured price, or are absent; aggregators typically charge a margin over the direct API, and the node says so.

Text models route too: with an OpenRouter key the planning models — Refine, the Multi-Shot planner, the cinema crew, Text→Text — run at pass-through token rates when no native text key exists. Marcel routes through OpenRouter too — chat, ambient narration and acting, with Anthropic prompt caching passing through, so one OpenRouter key is a complete text seat.

Deciding between direct keys and an aggregator? The full pros/cons and a feature-by-feature capability matrix live on Keys vs aggregators.

#Text vs generation

Gemini, OpenAI and Anthropic double as planning models — they power the Refine node and the cinema crew, where you pick which LLM writes your treatment or shot plan. Text calls cost cents and are billed separately.

Provider errors are surfaced verbatim on the node — Brut never masks them, so what the provider says is what you see.