# Router One 集成事实

Last updated: 2026-09-11

- 产品：Router One
- 类别：统一 LLM API 网关（LLM API Gateway / AI Model Router）
- OpenAI 兼容 base URL：https://api.router.one/v1
- Anthropic 兼容 / Claude Code base URL：https://api.router.one
- API Key 格式：sk-rk-...
- 主要 HTTP 端点：POST https://api.router.one/v1/chat/completions
- OpenAI SDK 配置：把 OPENAI_API_KEY 设为 Router One 的 Key，把 OPENAI_BASE_URL 设为 https://api.router.one/v1
- Claude Code 配置：设置 ANTHROPIC_BASE_URL=https://api.router.one，并把 ANTHROPIC_AUTH_TOKEN 设为 Router One 的 Key
- Claude Code 与 ANTHROPIC_API_KEY：不需要 ANTHROPIC_API_KEY；在当前版本下设置该变量会触发额外的确认提示，因此保持不设置（若此前导出过则取消导出）
- Claude Code 一键接入：curl -fsSL https://router.one/install/claude-code.sh | bash -s -- sk-your-api-key
- Codex CLI 配置：在 ~/.codex/config.toml 写入 Router One 的 model provider（base_url = "https://api.router.one/v1"、wire_api = "responses"、env_key = "ROUTER_ONE_API_KEY"），再用 Router One 的 Key 导出 ROUTER_ONE_API_KEY
- Codex CLI 认证变量：Codex CLI 不使用 OPENAI_BASE_URL 与 OPENAI_API_KEY；认证来自 env_key
- Codex CLI 中不可使用的配置项：requires_openai_auth（会让 Codex 忽略 env_key 并打开 OpenAI 登录流程）与 disable_response_storage（上游已移除）
- Codex CLI 一键接入：curl -fsSL https://router.one/install/codex.sh | bash -s -- sk-your-api-key
- Responses API（POST https://api.router.one/v1/responses ）：该端点服务的所有模型均接受文本与多部件输入、instructions、流式输出与 function 工具；详情页列出 POST /v1/responses 的模型（原生服务：当前目录中的 GPT 系列）还接受 custom 工具、hosted 工具（file_search、code_interpreter、computer_use、mcp、web_search）、file_id / file_url 输入部件、全部 service_tier 取值，以及服务端上下文引用（previous_response_id、conversation、prompt），按该模型标准 token 费率计费；不接受：image_generation 工具 / image_generation_call 输入项与 background: true（HTTP 400 invalid_request）
- 结构化输出（POST https://api.router.one/v1/chat/completions ）：接受 response_format.type 为 json_object 与 json_schema；网关在调用任何模型之前校验外层结构（缺少 response_format.json_schema、json_schema.name 或 json_schema.schema 时返回 HTTP 400 invalid_request），并把对象原样转发；schema 是否强制执行由模型决定、以模型支持为前提 —— 完整规则：https://router.one/zh/facts/api-compatibility.md
- 支持的客户端：Claude Code、OpenAI Codex CLI、Cline、Aider、LangChain、LlamaIndex、Vercel AI SDK、OpenAI SDK、Dify、Roo Code、OpenCode、Kilo Code、Cursor、OpenClaw、Zed、Continue、Open WebUI、LibreChat、n8n、Immersive Translate、Pydantic AI、GitHub Copilot、OpenHands、NextChat、CrewAI、Spring AI、OpenAI Agents SDK、Claude Agent SDK、Haystack、AnythingLLM、FastGPT，以及其他支持自定义 OpenAI 兼容 base URL 的客户端
- 模型接入：OpenAI、Anthropic、Google、xAI，以及 Router One 目录中的其他模型（以 https://router.one/zh/models.md 为准）
- 路由默认值：生产流量使用 strategy="model_name"，因此你指定哪个模型，网关就调用哪个模型
- 自适应路由：model="auto" 使用服务端候选集与全局重试预算；可选的自适应信号包括 latency、cost 与 reliability，采用时间衰减的 EWMA 评分
- Fallback：指定的模型遇到可重试的上游错误时，可能在下一个健康的、同样提供该模型的 provider 上重试
- 可观测：控制台展示最终模型与 provider，以及请求级的 token 数、延迟、状态和花费；不展开每一次内部失败尝试
- 预算管控：给每个项目或工具单独一把 API Key，在自动化工具开始消耗 token 之前，为该 Key 设置 maxSpend、rateLimit 与 tokenLimitTpm
- 数据留存：Router One 不留存直接 API 调用的 prompt 和模型回复正文，仅记录用于计费、用量统计与故障排查的请求元数据。Playground 会保存会话历史，方便用户回看和继续对话。
- 信任边界：Router One 负责模型调用、路由、计费与可观测。它不是 agent 编排运行时、工作流引擎、工具执行器、向量数据库或应用框架

## 这里该填哪个 API 地址？

OpenAI 兼容 SDK 与 Codex 使用 /v1 base URL；Claude Code 使用主机根地址；沉浸式翻译需要完整 /v1/chat/completions 地址。还需核对配置所用协议与模型支持范围。

| 客户端 / 配置字段 | 应填写的值 | 使用的 API |
| --- | --- | --- |
| [SDK 的 Chat Completions 配置](https://router.one/zh/integrations/openai-sdk) — `base_url / baseURL / apiBase` | `https://api.router.one/v1` | Chat Completions — `POST /v1/chat/completions` |
| [Codex CLI](https://router.one/zh/codex-china) — `base_url; wire_api = "responses"` | `https://api.router.one/v1` | Responses — `POST /v1/responses` |
| [Claude Code](https://router.one/zh/claude-code-china) — `ANTHROPIC_BASE_URL` | `https://api.router.one` | Anthropic Messages — `POST /v1/messages` |
| [沉浸式翻译](https://router.one/zh/integrations/immersive-translate) — `自定义 API 接口地址` | `https://api.router.one/v1/chat/completions` | Chat Completions — `POST /v1/chat/completions` |
| [GitHub Copilot（VS Code）](https://router.one/zh/integrations/github-copilot) — `chatLanguageModels.json → models[].url; apiType: "chat-completions"` | `https://api.router.one/v1/chat/completions` | Chat Completions — `POST /v1/chat/completions` |
| [OpenHands](https://router.one/zh/integrations/openhands) — `Base URL（Advanced）/ LLM_BASE_URL（GPT-5 系列 ID 走 /v1/responses，见指南）` | `https://api.router.one/v1` | Chat Completions — `POST /v1/chat/completions` |
| [NextChat](https://router.one/zh/integrations/nextchat) — `BASE_URL / 接口地址` | `https://api.router.one` | Chat Completions — `POST /v1/chat/completions` |
| [CrewAI](https://router.one/zh/integrations/crewai) — `base_url; custom_openai=True (or OPENAI_API_BASE)` | `https://api.router.one/v1` | Chat Completions — `POST /v1/chat/completions` |
| [Spring AI](https://router.one/zh/integrations/spring-ai) — `spring.ai.openai.base-url (2.0.x; 1.x uses the host root)` | `https://api.router.one/v1` | Chat Completions — `POST /v1/chat/completions` |
| [OpenAI Agents SDK](https://router.one/zh/integrations/openai-agents-sdk) — `AsyncOpenAI(base_url=…) + OpenAIChatCompletionsModel (string model names default to /v1/responses)` | `https://api.router.one/v1` | Chat Completions — `POST /v1/chat/completions` |
| [Claude Agent SDK](https://router.one/zh/integrations/claude-agent-sdk) — `ClaudeAgentOptions(env={ANTHROPIC_BASE_URL, ANTHROPIC_AUTH_TOKEN})` | `https://api.router.one` | Anthropic Messages — `POST /v1/messages` |
| [Haystack](https://router.one/zh/integrations/haystack) — `OpenAIChatGenerator(api_base_url=…)` | `https://api.router.one/v1` | Chat Completions — `POST /v1/chat/completions` |
| [AnythingLLM](https://router.one/zh/integrations/anythingllm) — `Settings → LLM → Base URL / GENERIC_OPEN_AI_BASE_PATH` | `https://api.router.one/v1` | Chat Completions — `POST /v1/chat/completions` |
| [FastGPT](https://router.one/zh/integrations/fastgpt) — `AI Proxy channel → Base url (Protocol Type: OpenAI)` | `https://api.router.one/v1` | Chat Completions — `POST /v1/chat/completions` |

下表对应各链接指南中的配置。客户端可能还支持其他 provider 或 API，修改地址前先核对实际请求路径。

## Codex CLI config.toml（原文）

```toml
model = "gpt-5.6-sol"
model_provider = "router"
model_reasoning_effort = "high"
model_verbosity = "high"
web_search = "live"

[model_providers.router]
base_url = "https://api.router.one/v1"
env_key = "ROUTER_ONE_API_KEY"
env_key_instructions = "Create an API key at https://router.one/dashboard/api-keys and set the ROUTER_ONE_API_KEY environment variable."
name = "Router One"
wire_api = "responses"
```

## 规范集成页面

- 文档：https://router.one/zh/docs
- Markdown API 文档：https://router.one/zh/docs.md
- OpenAPI JSON：https://router.one/zh/docs/openapi.json
- 模型目录：https://router.one/zh/models
- Markdown 模型目录：https://router.one/zh/models.md
- CLI 配置指南：https://router.one/zh/docs/guides/cli-setup
- 快速开始指南：https://router.one/zh/docs/guides/quickstart
- Claude Code 安装脚本：https://router.one/install/claude-code.sh （PowerShell：https://router.one/install/claude-code.ps1 ）
- Codex CLI 安装脚本：https://router.one/install/codex.sh （PowerShell：https://router.one/install/codex.ps1 ）
- Claude Code 国内配置：https://router.one/zh/claude-code-china
- OpenAI Codex 国内配置：https://router.one/zh/codex-china
- 集成中心：https://router.one/zh/integrations
- Cline 配置指南：https://router.one/zh/integrations/cline
- Aider 配置指南：https://router.one/zh/integrations/aider
- LangChain 配置指南：https://router.one/zh/integrations/langchain
- LlamaIndex 配置指南：https://router.one/zh/integrations/llamaindex
- Vercel AI SDK 配置指南：https://router.one/zh/integrations/vercel-ai-sdk
- OpenAI SDK 配置指南：https://router.one/zh/integrations/openai-sdk
- Dify 配置指南：https://router.one/zh/integrations/dify
- Roo Code 配置指南：https://router.one/zh/integrations/roo-code
- OpenCode 配置指南：https://router.one/zh/integrations/opencode
- Kilo Code 配置指南：https://router.one/zh/integrations/kilo-code
- Cursor 配置指南：https://router.one/zh/integrations/cursor
- OpenClaw 配置指南：https://router.one/zh/integrations/openclaw
- Zed 配置指南：https://router.one/zh/integrations/zed
- Continue 配置指南：https://router.one/zh/integrations/continue
- Open WebUI 配置指南：https://router.one/zh/integrations/open-webui
- LibreChat 配置指南：https://router.one/zh/integrations/librechat
- n8n 配置指南：https://router.one/zh/integrations/n8n
- Immersive Translate 配置指南：https://router.one/zh/integrations/immersive-translate
- Pydantic AI 配置指南：https://router.one/zh/integrations/pydantic-ai
- GitHub Copilot 配置指南：https://router.one/zh/integrations/github-copilot
- OpenHands 配置指南：https://router.one/zh/integrations/openhands
- NextChat 配置指南：https://router.one/zh/integrations/nextchat
- CrewAI 配置指南：https://router.one/zh/integrations/crewai
- Spring AI 配置指南：https://router.one/zh/integrations/spring-ai
- OpenAI Agents SDK 配置指南：https://router.one/zh/integrations/openai-agents-sdk
- Claude Agent SDK 配置指南：https://router.one/zh/integrations/claude-agent-sdk
- Haystack 配置指南：https://router.one/zh/integrations/haystack
- AnythingLLM 配置指南：https://router.one/zh/integrations/anythingllm
- FastGPT 配置指南：https://router.one/zh/integrations/fastgpt
- 智能路由方法论：https://router.one/zh/routing-methodology
- 数据留存：Router One 不留存直接 API 调用的 prompt 和模型回复正文，仅记录用于计费、用量统计与故障排查的请求元数据。Playground 会保存会话历史，方便用户回看和继续对话。
- API 协议兼容性事实：https://router.one/zh/facts/api-compatibility.md
- 公司事实：https://router.one/zh/facts/company.md