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

> https://router.one/zh/openai-compatible-api 的 Markdown 镜像，供 AI 助手与爬虫使用。Router One 是 OpenAI 兼容的统一 LLM API 网关。
> 最后更新：2026-09-05

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，也不用重写。

## 用 OpenAI SDK 调用任意模型

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

## 适配你已经在用的工具

任何支持自定义 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 是否强制执行由模型决定。各功能的最新细节见文档，以及流式输出、工具调用、结构化输出三篇指南。

## 相关页面

- 确认 Chat Completions 请求：https://router.one/zh/docs/chat/createChatCompletion
- 打开客户端专属接入指南：https://router.one/zh/integrations
- 配置 LlamaIndex：https://router.one/zh/integrations/llamaindex
- 用 SSE 做流式输出：https://router.one/zh/llm-streaming
- 跨模型使用 Tool Calling：https://router.one/zh/llm-tool-calling
- 拿到 JSON mode 或 JSON Schema 回复：https://router.one/zh/llm-structured-outputs
- 为 /v1/responses 选择当前可用模型：https://router.one/zh/codex-responses-api
- 在 Trace 中核对请求：https://router.one/zh/llm-observability
- 了解网关层负责什么：https://router.one/zh/llm-api-gateway
- 从「什么是 AI API 网关」开始：https://router.one/zh/blog/what-is-ai-api-gateway
- 本页规范地址：https://router.one/zh/openai-compatible-api
- 模型与每模型 token 价格：https://router.one/zh/models （markdown：https://router.one/zh/models.md ）
- 定价：https://router.one/zh/pricing
- API 文档（markdown）：https://router.one/zh/docs.md
- 公司事实（markdown）：https://router.one/zh/facts/company.md