跳到主要内容
Router One

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

Router One 在 https://api.router.one/v1 提供一个 OpenAI 兼容端点。只改一个 base URL,继续用你已有的 OpenAI SDK,即可通过单一端点直连 Claude、GPT、Gemini、Grok 等 30+ 模型,并获得智能路由、自动故障转移,以及每次调用的成本 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="anthropic/claude-sonnet-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 是可直接替换的 OpenAI 兼容 API:它在 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、Grok 或其他受支持模型的 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 调用,以及 response_format(json_object,或带命名 schema 的 json_schema)都走同一套请求格式,具体支持程度因底层模型而异。网关检查 response_format 信封并转发给模型,schema 是否强制执行由模型决定。各功能的最新细节见文档,以及流式输出、工具调用、结构化输出三篇指南。

按 OpenAI 兼容接入任务选择下一步

本页负责 base URL 迁移;准确请求约定、当前模型 ID、客户端专属指南、流式输出、工具调用、首个请求核对与网关概念入门分别由下方唯一入口承接。

API 参考确认 Chat Completions 请求更换 base URL 后,在接口参考中核对准确字段、响应结构、流式行为与错误。模型选择选择当前模型 ID 与费率填写 model 字段前,先核对可用模型 ID、能力、上下文窗口与公开价格。客户端配置打开客户端专属接入指南编程 agent、SDK、聊天客户端和 LLM 应用平台都有专属接入指南,base URL 与 Key 完全一致。框架配置 LlamaIndex把 LlamaIndex 的 OpenAI 兼容 LLM 类指向网关 base URL,改字符串切换模型。流式用 SSE 做流式输出在同一端点开启 stream,按分块格式读取输出,并正确处理长生成的超时与取消。工具调用跨模型使用 Tool Calling用同一份 OpenAI 兼容 tools 声明走完调用循环,并借助请求 Trace 排查各模型差异。结构化输出拿到 JSON mode 或 JSON Schema 回复在同一请求里发送 response_format,了解网关先执行的 400 外层结构检查,并按模型设定强制执行的预期。Responses API为 /v1/responses 选择当前可用模型Responses 端点家族、接受与拒绝的请求字段,以及依赖它的 Codex CLI 接线。验证在 Trace 中核对请求首个请求完成后,核对最终模型与供应商、Token 用量、延迟、状态和计费成本。网关层了解网关层负责什么路由、自动故障转移、消费上限与每请求 Trace——兼容端点背后的这层管控。背景从「什么是 AI API 网关」开始从零解释网关这一层做什么,以及「一个端点调所有模型」在什么场景下真正划算。

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

立即接入