Router One

一个 OpenAI 兼容 API，调用所有模型

Router One 在 https://api.router.one/v1 提供一个 OpenAI 兼容端点。只改一个 base URL，继续用你已有的 OpenAI SDK，即可通过单一端点直连 Claude、GPT、Gemini、DeepSeek 等 40+ 模型，并获得智能路由、自动故障转移，以及每次调用的成本 Trace。

立即接入

改一个 base URL 即可接入

Router One 使用 OpenAI Chat Completions API 规范。把客户端指向 Router One 的 base URL，换上你的 Router One Key，其余代码无需改动——不用换 SDK，也不用重写。

terminal
# 继续用 OpenAI SDK——只把它指向 Router One
export OPENAI_BASE_URL=https://api.router.one/v1
export OPENAI_API_KEY=sk-rk-your-router-one-key

用 OpenAI SDK 调用任意模型

因为端点是 OpenAI 兼容的，同一个 SDK 调用也能触达非 OpenAI 模型。把 model 字段设为 Claude 或 Gemini 的模型 ID，请求就会通过 Router One 路由——无需为每个提供方单独维护客户端。

example.py
from openai import OpenAI

# 同一个 OpenAI SDK，调用一个 Claude 模型
client = OpenAI(base_url="https://api.router.one/v1", api_key="sk-rk-...")

resp = client.chat.completions.create(
    model="claude-sonnet-4-5",
    messages=[{"role": "user", "content": "Hello from the OpenAI SDK"}],
)
print(resp.choices[0].message.content)

适配你已经在用的工具

任何支持自定义 OpenAI 兼容 base URL 的客户端都能接入 Router One。设置 base URL 和 Key，保持原有工作流不变。

OpenAI SDK

官方 Python 与 Node OpenAI 库——设置 base_url / OPENAI_BASE_URL 和你的 Router One Key 即可。

Claude Code

Router One 同时在 https://api.router.one 提供 Anthropic 兼容端点，让 Claude Code 原生可用。

OpenAI Codex CLI

把 Codex CLI 指向 OpenAI 兼容 base URL，即可对任意受支持模型运行。

Cursor、Cline 与 Aider

支持自定义 OpenAI 兼容 base URL 的编辑器和 CLI 编程工具，都以相同方式接入。

路由、故障转移与 Trace 开箱即用

同一个 OpenAI 兼容端点自带智能路由与韧性，无需额外集成工作。

  • 生产流量默认使用 model_name 策略。把 model 设为 "auto" 时，由服务端候选集合和全局重试预算完成选择；可选信号包括延迟、成本与可靠性，并使用按时间衰减的 EWMA 评分。
  • 指定模型的请求遇到可重试上游错误时，可能尝试下一个能提供同一模型的健康供应商。
  • 实时 Dashboard 展示最终模型与供应商，以及请求级 Token、成本、延迟和状态；不展示每次内部失败尝试。

常见问题

它真的 OpenAI 兼容吗？

是的。Router One 在 https://api.router.one/v1 实现了 OpenAI Chat Completions API 规范。为 OpenAI 编写的库和工具，改个 base URL 和 Key 就能用。

我现有的 OpenAI 集成可以原样运行吗？

多数情况下可以。你只需改 base URL 和 API Key，请求与响应处理逻辑保持不变。主要区别在于：现在 model 字段可以填入其他家族的模型。

可以用 OpenAI SDK 调用 Claude 或 Gemini 吗？

可以。把 model 字段设为 Claude、Gemini、DeepSeek 或其他受支持模型的 ID，OpenAI SDK 的调用就会通过 Router One 路由到该模型。完整模型列表见 /models 页。

Claude Code 用的 Anthropic 兼容端点是什么？

Claude Code 需要 Anthropic API 的格式，因此 Router One 同时在 https://api.router.one 提供 Anthropic 兼容端点。把 ANTHROPIC_BASE_URL 指向那里，Claude Code 即可原生使用。

支持流式输出和工具调用吗？

Router One 遵循 OpenAI Chat Completions 约定，包括流式响应和 tool/function 调用，具体支持程度因底层模型而异。各功能的最新细节见文档。

相关页面

准备好用 OpenAI SDK 调用所有模型了吗？

立即接入