Docs/Model Combos

Model Combos

A Combo is a named group of providers that lina-router treats as a single model. Your tool points to one endpoint — lina-router handles which provider actually gets the request, and what happens when one runs out.

What Combos Unlock

Custom fallback chain

Define exactly which providers to try and in what order — per combo.

Mixed tiers

Combine subscription + cheap API + free in one combo for maximum uptime.

Multi-account rotation

Add multiple accounts for the same provider. lina-router round-robins between them.

One model name

Use your combo name as the model in any tool. No per-session config.

Creating a Combo

  1. 1Dashboard → Combos → New Combo
  2. 2Give it a name — this becomes your model ID (e.g. my-combo)
  3. 3Add providers in priority order — drag to reorder
  4. 4Choose a fallback strategy (see below)
  5. 5Save — use it immediately as a model in any tool

Then use your combo name as the model in your tool:

Using a combo
# Claude Code — use combo as model
export ANTHROPIC_MODEL=my-combo
claude

# Or in any OpenAI-compatible tool
Model: my-combo

Fallback Strategies

Each combo has an independent fallback strategy. You can mix strategies — one combo for speed, one for cost.

1

Tier Waterfall

Default — covers most users

Try Tier 1 → Tier 2 → Tier 3 in order. Falls back when quota is exhausted or on error.

2

Round Robin

Multiple accounts, avoiding rate limits

Distribute requests evenly across all connected providers in the combo.

3

Fastest First

Speed-sensitive tasks

Routes to the provider with the lowest recent latency.

4

Cost Optimized

Long batch jobs

Prefers the cheapest provider that can handle the request.

Multi-Account Rotation

Add the same provider multiple times with different accounts. lina-router tracks each account's quota independently and rotates automatically.

Example: 3 Kiro accounts in one combo

kiro-account-1 → quota: 450/500 req
kiro-account-2 → quota: 120/500 req
kiro-account-3 → quota: 0/500 req (on cooldown)

lina-router round-robins between account 1 and 2, skips account 3 until reset.

Tip: Combos sync across devices via Cloud Sync — set one up on your desktop and it's available on your laptop instantly.