连接你的工具

你的工具，一个 API Key。

找到正在使用的工具，按指南完成配置，再验证第一次模型调用。Router One 处理模型请求，agent 与工作流仍由你的应用运行。

获取 API Key 发起第一次 API 调用

找到你的接入方式

按工具或使用场景查找，再核对对应的 provider 配置与模型要求。

核对 API 地址

搜索工具

显示 38 / 38 篇接入指南

编程与 agent 工具

SDK 与框架

聊天、知识库与翻译

工作流与 API 工具

第一次请求前，核对这三件事

地址与客户端字段对应
base URL 和完整请求端点不是同一个值。复制地址前，先确认客户端的配置字段与所选协议。
检查连接配置
填写精确的模型 ID
从模型目录复制 ID，核对模型支持的端点与能力，是否满足客户端需要的功能。
查看模型与能力
确认请求完成与结算
先发送纯文本请求，在日志里核对结果、请求 ID 和结算状态，再开启流式输出或工具调用。
了解如何读请求日志

这里该填哪个 API 地址？

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

对照各客户端的地址设置

这里该填哪个 API 地址？
客户端 / 配置字段	应填写的值	使用的 API
SDK 的 Chat Completions 配置`base_url / baseURL / apiBase`	`https://api.router.one/v1`	Chat Completions`POST /v1/chat/completions`
Codex CLI`base_url; wire_api = "responses"`	`https://api.router.one/v1`	Responses`POST /v1/responses`
Claude Code`ANTHROPIC_BASE_URL`	`https://api.router.one`	Anthropic Messages`POST /v1/messages`
沉浸式翻译`自定义 API 接口地址`	`https://api.router.one/v1/chat/completions`	Chat Completions`POST /v1/chat/completions`
GitHub Copilot（VS Code）`chatLanguageModels.json → models[].url; apiType: "chat-completions"`	`https://api.router.one/v1/chat/completions`	Chat Completions`POST /v1/chat/completions`
OpenHands`Base URL（Advanced）/ LLM_BASE_URL（GPT-5 系列 ID 走 /v1/responses，见指南）`	`https://api.router.one/v1`	Chat Completions`POST /v1/chat/completions`
NextChat`BASE_URL / 接口地址`	`https://api.router.one`	Chat Completions`POST /v1/chat/completions`
CrewAI`base_url; custom_openai=True (or OPENAI_API_BASE)`	`https://api.router.one/v1`	Chat Completions`POST /v1/chat/completions`
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`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`ClaudeAgentOptions(env={ANTHROPIC_BASE_URL, ANTHROPIC_AUTH_TOKEN})`	`https://api.router.one`	Anthropic Messages`POST /v1/messages`
Haystack`OpenAIChatGenerator(api_base_url=…)`	`https://api.router.one/v1`	Chat Completions`POST /v1/chat/completions`
AnythingLLM`Settings → LLM → Base URL / GENERIC_OPEN_AI_BASE_PATH`	`https://api.router.one/v1`	Chat Completions`POST /v1/chat/completions`
FastGPT`AI Proxy channel → Base url (Protocol Type: OpenAI)`	`https://api.router.one/v1`	Chat Completions`POST /v1/chat/completions`
Xcode`Settings → Intelligence → Add a Chat Provider → Internet Hosted → URL（Xcode 自行拼接 /v1/models 与 /v1/chat/completions）`	`https://api.router.one`	Chat Completions`POST /v1/chat/completions`
Qwen Code`OPENAI_BASE_URL (.qwen/.env) / modelProviders.openai[].baseUrl`	`https://api.router.one/v1`	Chat Completions`POST /v1/chat/completions`
Google ADK`LiteLlm(model="openai/<id>", api_base=…, api_key=…)`	`https://api.router.one/v1`	Chat Completions`POST /v1/chat/completions`
smolagents`OpenAIModel(model_id=…, api_base=…, api_key=…)`	`https://api.router.one/v1`	Chat Completions`POST /v1/chat/completions`
Goose`OPENAI_HOST（OPENAI_BASE_PATH 保持默认 v1/chat/completions；gpt-5、gpt-6 与 o 系列名称走 /v1/responses，见指南）`	`https://api.router.one`	Chat Completions`POST /v1/chat/completions`

SDK 的 Chat Completions 配置base_url / baseURL / apiBase
应填写的值
https://api.router.one/v1
使用的 API
Chat CompletionsPOST /v1/chat/completions
Codex CLIbase_url; wire_api = "responses"
应填写的值
https://api.router.one/v1
使用的 API
ResponsesPOST /v1/responses
Claude CodeANTHROPIC_BASE_URL
应填写的值
https://api.router.one
使用的 API
Anthropic MessagesPOST /v1/messages
沉浸式翻译自定义 API 接口地址
应填写的值
https://api.router.one/v1/chat/completions
使用的 API
Chat CompletionsPOST /v1/chat/completions
GitHub Copilot（VS Code）chatLanguageModels.json → models[].url; apiType: "chat-completions"
应填写的值
https://api.router.one/v1/chat/completions
使用的 API
Chat CompletionsPOST /v1/chat/completions
OpenHandsBase URL（Advanced）/ LLM_BASE_URL（GPT-5 系列 ID 走 /v1/responses，见指南）
应填写的值
https://api.router.one/v1
使用的 API
Chat CompletionsPOST /v1/chat/completions
NextChatBASE_URL / 接口地址
应填写的值
https://api.router.one
使用的 API
Chat CompletionsPOST /v1/chat/completions
CrewAIbase_url; custom_openai=True (or OPENAI_API_BASE)
应填写的值
https://api.router.one/v1
使用的 API
Chat CompletionsPOST /v1/chat/completions
Spring AIspring.ai.openai.base-url (2.0.x; 1.x uses the host root)
应填写的值
https://api.router.one/v1
使用的 API
Chat CompletionsPOST /v1/chat/completions
OpenAI Agents SDKAsyncOpenAI(base_url=…) + OpenAIChatCompletionsModel (string model names default to /v1/responses)
应填写的值
https://api.router.one/v1
使用的 API
Chat CompletionsPOST /v1/chat/completions
Claude Agent SDKClaudeAgentOptions(env={ANTHROPIC_BASE_URL, ANTHROPIC_AUTH_TOKEN})
应填写的值
https://api.router.one
使用的 API
Anthropic MessagesPOST /v1/messages
HaystackOpenAIChatGenerator(api_base_url=…)
应填写的值
https://api.router.one/v1
使用的 API
Chat CompletionsPOST /v1/chat/completions
AnythingLLMSettings → LLM → Base URL / GENERIC_OPEN_AI_BASE_PATH
应填写的值
https://api.router.one/v1
使用的 API
Chat CompletionsPOST /v1/chat/completions
FastGPTAI Proxy channel → Base url (Protocol Type: OpenAI)
应填写的值
https://api.router.one/v1
使用的 API
Chat CompletionsPOST /v1/chat/completions
XcodeSettings → Intelligence → Add a Chat Provider → Internet Hosted → URL（Xcode 自行拼接 /v1/models 与 /v1/chat/completions）
应填写的值
https://api.router.one
使用的 API
Chat CompletionsPOST /v1/chat/completions
Qwen CodeOPENAI_BASE_URL (.qwen/.env) / modelProviders.openai[].baseUrl
应填写的值
https://api.router.one/v1
使用的 API
Chat CompletionsPOST /v1/chat/completions
Google ADKLiteLlm(model="openai/<id>", api_base=…, api_key=…)
应填写的值
https://api.router.one/v1
使用的 API
Chat CompletionsPOST /v1/chat/completions
smolagentsOpenAIModel(model_id=…, api_base=…, api_key=…)
应填写的值
https://api.router.one/v1
使用的 API
Chat CompletionsPOST /v1/chat/completions
GooseOPENAI_HOST（OPENAI_BASE_PATH 保持默认 v1/chat/completions；gpt-5、gpt-6 与 o 系列名称走 /v1/responses，见指南）
应填写的值
https://api.router.one
使用的 API
Chat CompletionsPOST /v1/chat/completions

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

接入时的常见问题

Router One 的 base URL 到底该填哪个？

按这些指南配置 OpenAI 兼容 SDK 时，填写 https://api.router.one/v1。Claude Code 与 Claude Agent SDK 使用主机根地址 https://api.router.one。需要完整 Chat Completions 端点的客户端应填写 https://api.router.one/v1/chat/completions。部分客户端会自行拼接 /v1，应以对应指南中的实际字段为准，避免重复添加。

列在这里的工具，能使用全部模型和功能吗？

每份指南对应一种具体的 provider 配置。API 协议、模型和客户端都要支持所需功能。请在模型详情页核对精确 ID、端点、上下文限制，以及工具调用或图片支持。纯文本请求成功，不代表已经验证流式输出、工具调用或图片输入。

Router One 会运行 agent 或建立知识库索引吗？

agent 循环、工具执行和文档管理由客户端或框架完成，Router One 处理其中受支持的模型调用。知识库所需的 embeddings、rerank 和向量存储需要单独配置；接通聊天模型不等于接通这些服务。

如何确认接入成功？

先发送简单请求并检查最终结果，再到控制台的请求日志，按模型、时间和请求 ID 核对 token、延迟、状态与结算。HTTP 200 不足以证明流式输出完整结束，待结算也不表示免费。客户日志界面不展示供应商尝试记录或内部 fallback 链。

没找到正在使用的工具？

先确认它是否支持自定义 provider 地址和 API Key，再将请求协议与模型支持范围对应起来。API 文档列出了可用端点。

阅读 Markdown 版本