Router One

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

Router One 在 https://api.router.one/v1 提供一个 OpenAI 兼容端点。只改一个 base URL,继续用你已有的 OpenAI SDK,即可通过单一端点直连 Claude、GPT、Gemini、DeepSeek 等 25+ 模型,并获得智能路由、自动故障转移,以及每次调用的成本 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 设为 "auto",即可按延迟、成本与质量权重在候选模型间路由。
  • 当某个供应商返回 5xx 或超时,智能路由会在有可用同族路由时自动切换到下一个健康路由。
  • 每次请求都会返回一条 Trace——模型、供应商、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 调用所有模型了吗?

免费开始