# Combos

Source: https://docs.getworg.com/combos

A combo is an ordered list of lanes that you call as one model. Worg tries the lanes in your order and stops at the first one that answers.

## 1. Build a combo in the console

Open Combos, give it a name, and add lanes in the order you want them tried. Only lanes your organization can use are offered. A combo holds up to 5 lanes, and an organization can have up to 10 combos. Names use lowercase letters, digits, dot, `_` or `-`, up to 40 characters.

## 2. Call it by name

- Base URL: `https://api.getworg.com/v1`
- Model: `combo/<name>`

The `model` field in the response names the lane that served the request. Your combos also appear in `GET /v1/models`.

## 3. How the lanes are tried

- Worg moves to the next lane when a lane fails before it sends anything: a server error, no answer within 60 seconds, or the lane is busy or refusing requests.
- A server error or a dropped connection before anything arrives is tried once more on the same lane, then the next lane.
- An error about your request itself, such as a bad parameter, comes back to you as it is. The next lane is not tried.
- Once the first chunk of a stream reaches you, the request stays on that lane.
- A lane that failed three times in a row is tried last for the next 30 seconds, still within your list.
- When every lane fails, the answer is `429 capacity_busy` if a lane was busy, otherwise `502 upstream_unavailable`.

## 4. How it is billed

Each request is billed at the rate of the lane that served it. Before sending, Worg sets aside the cost for the most expensive lane in the combo, then charges only what the serving lane used. Usage shows the combo name and the serving lane side by side.

> Combo or model name alone
>
> A lane ID such as `deepseek-v4.1-flash:cached` stays on its lane. The model name alone, such as `deepseek-v4.1-flash`, tries the lanes of that model in a fixed order (see [Models](https://docs.getworg.com/models#model-without-a-lane)). Use a combo to choose the lanes and their order yourself, or to fall back to another model.

Next: [Errors and retries](https://docs.getworg.com/errors) · [Models and compatibility](https://docs.getworg.com/models)