From 88b7bb7ecb61dfca887c9680297ed8533e24ecb1 Mon Sep 17 00:00:00 2001
From: dddddddrrrr <143711482+dddddddrrrr@users.noreply.github.com>
Date: Tue, 14 Jul 2026 14:02:55 +0800
Subject: [PATCH] docs: add Router One model provider guide

---
 .../model-providers/more/router-one.mdx       | 94 +++++++++++++++++++
 docs/customize/model-providers/overview.mdx   |  1 +
 docs/docs.json                                |  1 +
 3 files changed, 96 insertions(+)
 create mode 100644 docs/customize/model-providers/more/router-one.mdx

diff --git a/docs/customize/model-providers/more/router-one.mdx b/docs/customize/model-providers/more/router-one.mdx
new file mode 100644
index 00000000000..2f3a7e91853
--- /dev/null
+++ b/docs/customize/model-providers/more/router-one.mdx
@@ -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.
diff --git a/docs/customize/model-providers/overview.mdx b/docs/customize/model-providers/overview.mdx
index 7ba030dcb4d..20e0041db87 100644
--- a/docs/customize/model-providers/overview.mdx
+++ b/docs/customize/model-providers/overview.mdx
@@ -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 |
diff --git a/docs/docs.json b/docs/docs.json
index b7a1d83f13a..ff389cdd831 100644
--- a/docs/docs.json
+++ b/docs/docs.json
@@ -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",