跳到主要内容
注册

连接你的工具

你的工具,一个 API Key。

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

找到你的接入方式

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

核对 API 地址

显示 59 / 59 篇接入指南

编程与 agent 工具

26

SDK 与框架

17

聊天、知识库与翻译

08

工作流与 API 工具

08

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

  1. 地址与客户端字段对应

    base URL 和完整请求端点不是同一个值。复制地址前,先确认客户端的配置字段与所选协议。

    检查连接配置
  2. 填写精确的模型 ID

    从模型目录复制 ID,核对模型支持的端点与能力,是否满足客户端需要的功能。

    查看模型与能力
  3. 确认请求完成与结算

    先发送纯文本请求,在日志里核对结果、请求 ID 和结算状态,再开启流式输出或工具调用。

    了解如何读请求日志

这里该填哪个 API 地址?

OpenAI 兼容 SDK 与 Codex 使用 /v1 base URL;Claude Code 使用主机根地址;沉浸式翻译填完整的 /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 接口地址(完整地址各版本通用;1.30.2 及以后的版本也接受 /v1)
    应填写的值
    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(或 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 填主机根地址)
    应填写的值
    https://api.router.one/v1
    使用的 API
    Chat CompletionsPOST /v1/chat/completions
  • OpenAI Agents SDKAsyncOpenAI(base_url=…) + OpenAIChatCompletionsModel(字符串模型名默认走 /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 → AI Providers → LLM → Base URL / GENERIC_OPEN_AI_BASE_PATH
    应填写的值
    https://api.router.one/v1
    使用的 API
    Chat CompletionsPOST /v1/chat/completions
  • FastGPT模型渠道 → 代理地址(协议类型: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
  • MastraAgent model: { id: "custom/<model-id>", url: …, apiKey: … }
    应填写的值
    https://api.router.one/v1
    使用的 API
    Chat CompletionsPOST /v1/chat/completions
  • DSPydspy.LM("openai/<model-id>", api_base=…, api_key=…)
    应填写的值
    https://api.router.one/v1
    使用的 API
    Chat CompletionsPOST /v1/chat/completions
  • Microsoft Agent FrameworkOpenAIChatCompletionClient(model=…, api_key=…, base_url=…) / .NET OpenAIClientOptions.Endpoint
    应填写的值
    https://api.router.one/v1
    使用的 API
    Chat CompletionsPOST /v1/chat/completions
  • FlowiseOpenAI Custom Model node → Additional Parameters → Base Path
    应填写的值
    https://api.router.one/v1
    使用的 API
    Chat CompletionsPOST /v1/chat/completions
  • LangflowSettings → Model Providers → OpenAI Compatible → Base URL (OPENAI_COMPATIBLE_BASE_URL)
    应填写的值
    https://api.router.one/v1
    使用的 API
    Chat CompletionsPOST /v1/chat/completions
  • RAGFlowModel providers → OpenAI-API-Compatible → Base URL
    应填写的值
    https://api.router.one/v1
    使用的 API
    Chat CompletionsPOST /v1/chat/completions
  • AgnoOpenAILike(id=…, base_url=…, api_key=…)
    应填写的值
    https://api.router.one/v1
    使用的 API
    Chat CompletionsPOST /v1/chat/completions
  • MaxKBOpenAI 供应商 → API URL
    应填写的值
    https://api.router.one/v1
    使用的 API
    Chat CompletionsPOST /v1/chat/completions
  • Pi Agentmodels.json → providers.router-one.baseUrl (api: openai-completions)
    应填写的值
    https://api.router.one/v1
    使用的 API
    Chat CompletionsPOST /v1/chat/completions
  • AutoGenOpenAIChatCompletionClient(model=…, base_url=…, api_key=…, model_info={…})
    应填写的值
    https://api.router.one/v1
    使用的 API
    Chat CompletionsPOST /v1/chat/completions
  • Crushcrushrc → provider add router-one --type openai-compat --base-url (legacy crush.json: base_url)
    应填写的值
    https://api.router.one/v1
    使用的 API
    Chat CompletionsPOST /v1/chat/completions
  • JetBrains AI AssistantProviders & API keys → Third-party AI providers → OpenAI-compatible → URL
    应填写的值
    https://api.router.one/v1
    使用的 API
    Chat CompletionsPOST /v1/chat/completions
  • Copilot for ObsidianSettings → Copilot → BYOK → Add a custom provider → Base URL
    应填写的值
    https://api.router.one/v1
    使用的 API
    Chat CompletionsPOST /v1/chat/completions
  • AiderOPENAI_API_BASE(或 --openai-api-base);--model openai/<完整目录 ID>
    应填写的值
    https://api.router.one/v1
    使用的 API
    Chat CompletionsPOST /v1/chat/completions
  • ClineAPI Provider:OpenAI Compatible → Base URL(CLI:cline auth --baseurl)
    应填写的值
    https://api.router.one/v1
    使用的 API
    Chat CompletionsPOST /v1/chat/completions
  • Zedlanguage_models.openai_compatible.<id>.api_url
    应填写的值
    https://api.router.one/v1
    使用的 API
    Chat CompletionsPOST /v1/chat/completions
  • Zed(anthropic_compatible,可选)language_models.anthropic_compatible.<id>.api_url
    应填写的值
    https://api.router.one
    使用的 API
    Anthropic MessagesPOST /v1/messages
  • DifyOpenAI-API-compatible 插件 → API Base URL(0.0.53 及以前叫 API endpoint URL)
    应填写的值
    https://api.router.one/v1
    使用的 API
    Chat CompletionsPOST /v1/chat/completions
  • Open WebUI管理员面板 → 设置 → 外部连接 → URL(或首次启动时的 OPENAI_API_BASE_URL)
    应填写的值
    https://api.router.one/v1
    使用的 API
    Chat CompletionsPOST /v1/chat/completions
  • OpenClawopenclaw onboard --custom-base-url(--custom-compatibility 为 openai 或 openai-responses;anthropic 填主机根地址)
    应填写的值
    https://api.router.one/v1
    使用的 API
    Chat CompletionsPOST /v1/chat/completions
  • TRAE(TraeCode)设置 > 模型 > 添加模型 > 自定义模型 → 自定义请求地址(OpenAI Chat Completions 格式,关闭完整 URL;Claude 与 DeepSeek V4 的 ID 也可用 Anthropic Messages 格式填主机根地址,见指南)
    应填写的值
    https://api.router.one/v1
    使用的 API
    Chat CompletionsPOST /v1/chat/completions
  • Qoder设置 → 模型 → + 添加 → 供应商 → 自定义 → OpenAI Compatible → 接口地址(Base URL)(Chat Completions API;GPT、DeepSeek V4 与 Grok 对话模型也可选 Responses API)
    应填写的值
    https://api.router.one/v1
    使用的 API
    Chat CompletionsPOST /v1/chat/completions
  • CodeBuddymodels.json → models[].url(完整接口路径;仅支持 OpenAI 格式)
    应填写的值
    https://api.router.one/v1/chat/completions
    使用的 API
    Chat CompletionsPOST /v1/chat/completions
  • Hermes Agenthermes model → Custom endpoint → API base URL(或 config.yaml 中的 providers.<名称>.api;transport 为 chat_completions)
    应填写的值
    https://api.router.one/v1
    使用的 API
    Chat CompletionsPOST /v1/chat/completions
  • GitHub Copilot CLICOPILOT_PROVIDER_BASE_URL(COPILOT_PROVIDER_TYPE=openai,COPILOT_PROVIDER_WIRE_API=completions)
    应填写的值
    https://api.router.one/v1
    使用的 API
    Chat CompletionsPOST /v1/chat/completions
  • Cherry Studio设置 → 模型服务 → 添加服务商 → 端点设置 → OpenAI(Cherry 自行拼接 /v1/chat/completions;Anthropic 与 OpenAI Responses 填同一个主机根地址)
    应填写的值
    https://api.router.one
    使用的 API
    Chat CompletionsPOST /v1/chat/completions
  • Chatbox设置 → 模型提供方 → 添加 → 添加自定义提供商 → OpenAI API 兼容 → API 主机(Claude API 兼容模式同样要带 /v1)
    应填写的值
    https://api.router.one/v1
    使用的 API
    Chat CompletionsPOST /v1/chat/completions
  • DeepSeek Harness设置 → 模型 → 添加模型提供商 → 自定义模型 API → API 地址(API 协议选 OpenAI Chat Completions;OpenAI Responses 同样填 /v1,Anthropic Messages 填主机根地址)
    应填写的值
    https://api.router.one/v1
    使用的 API
    Chat CompletionsPOST /v1/chat/completions
  • WorkBuddy设置 → 模型 → 添加模型 → 提供商:自定义 / Custom → 接口地址(完整的 /chat/completions 路径,「自定义协议」保持关闭;仅支持 OpenAI 兼容协议)
    应填写的值
    https://api.router.one/v1/chat/completions
    使用的 API
    Chat CompletionsPOST /v1/chat/completions

下表对应各链接指南中的配置。客户端可能还支持其他模型供应商或 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 版本