Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
94 changes: 94 additions & 0 deletions docs/customize/model-providers/more/router-one.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,94 @@
---
title: "Router One"
description: "Configure Router One with Continue through its OpenAI-compatible API, using a pinned model or server-managed routing"
---

<Info>
[Router One](https://router.one) is an LLM API gateway that exposes multiple
model providers through one OpenAI-compatible endpoint. Configure it with
Continue's existing `openai` provider and a custom `apiBase`; no dedicated
provider implementation is required.
</Info>

<Tip>
Create a key in [Dashboard → API Keys](https://router.one/dashboard/api-keys)
and choose an exact model ID from the [model catalog](https://router.one/models).
</Tip>

## Configuration

The following example pins a tool-capable model for chat, edit, and apply roles:

<Tabs>
<Tab title="YAML">
```yaml title="config.yaml"
name: My Config
version: 0.0.1
schema: v1

models:
- name: Router One GPT-5.4 Mini
provider: openai
model: openai/gpt-5.4-mini
apiBase: https://api.router.one/v1
apiKey: <YOUR_ROUTER_ONE_API_KEY>
capabilities:
- tool_use
roles:
- chat
- edit
- apply
```
</Tab>
<Tab title="JSON (Deprecated)">
```json title="config.json"
{
"models": [
{
"title": "Router One GPT-5.4 Mini",
"provider": "openai",
"model": "openai/gpt-5.4-mini",
"apiBase": "https://api.router.one/v1",
"apiKey": "<YOUR_ROUTER_ONE_API_KEY>",
"capabilities": ["tool_use"]
}
]
}
```
</Tab>
</Tabs>

`provider: openai` selects Continue's OpenAI-compatible client. The `model`
value is still sent unchanged to Router One, so it may reference a model from
any upstream provider in the Router One catalog.

## Server-managed routing

Set `model` to `auto` when you want Router One to select from its server-managed
candidate set. For predictable Agent mode capability detection, pin an exact
tool-capable model as shown above.

```yaml title="config.yaml"
models:
- name: Router One Auto
provider: openai
model: auto
apiBase: https://api.router.one/v1
apiKey: <YOUR_ROUTER_ONE_API_KEY>
roles:
- chat
```

With an exact model ID, Router One keeps the requested model fixed while it may
retry another eligible provider route serving that same model. With `auto`,
candidate selection is managed by Router One.

## Troubleshooting

- Keep `/v1` in `apiBase`; Continue appends the OpenAI-compatible endpoint path.
- A `401` response usually means the API key is missing or invalid.
- A `402` response means the wallet balance or API-key spend limit is exhausted.
- A `429` response means the API key's configured rate limit was reached.

See the [Router One API documentation](https://router.one/docs) for endpoint and
error details.
1 change: 1 addition & 0 deletions docs/customize/model-providers/overview.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -34,6 +34,7 @@ Beyond the top-level providers, Continue supports many other options:
| [Together AI](/customize/model-providers/more/together) | Platform for running a variety of open models |
| [DeepInfra](/customize/model-providers/more/deepinfra) | Hosting for various open source models |
| [OpenRouter](/customize/model-providers/top-level/openrouter) | Gateway to multiple model providers |
| [Router One](/customize/model-providers/more/router-one) | OpenAI-compatible multi-model gateway with exact-model and server-managed routing |
| [ClawRouter](/customize/model-providers/more/clawrouter) | Open-source LLM router with automatic cost-optimized model selection |
| [Tetrate Agent Router Service](/customize/model-providers/top-level/tetrate_agent_router_service) | Gateway with intelligent routing across multiple model providers |
| [Cohere](/customize/model-providers/more/cohere) | Models specialized for semantic search and text generation |
Expand Down
1 change: 1 addition & 0 deletions docs/docs.json
Original file line number Diff line number Diff line change
Expand Up @@ -117,6 +117,7 @@
"customize/model-providers/more/moonshot",
"customize/model-providers/more/nous",
"customize/model-providers/more/nvidia",
"customize/model-providers/more/router-one",
"customize/model-providers/more/tensorix",
"customize/model-providers/more/together",
"customize/model-providers/more/xAI",
Expand Down
Loading