UniRouteUniRoute

线路选择

UniRoute API 地址、协议路径与连接问题排查。

线路选择

UniRoute 的 API 根地址是 https://api.uniroute.app。配置客户端时，请使用这个地址，并按对应协议保留路径后缀。

按协议填写地址

使用方式地址或路径
Claude Code 的 ANTHROPIC_BASE_URLhttps://api.uniroute.app
Codex / OpenAI SDK 的 API Base URLhttps://api.uniroute.app/v1
Gemini CLI 的 GOOGLE_GEMINI_BASE_URLhttps://api.uniroute.app
Anthropic Messages 请求路径/v1/messages
OpenAI Responses 请求路径/v1/responses
OpenAI Chat Completions 请求路径/v1/chat/completions
Gemini 原生 API 路径前缀/v1beta
当前 API Key 的模型目录/v1/models

SDK 和客户端通常会自行补全请求路径，不能在 Base URL 中重复添加完整接口路径。OpenCode 等客户端的供应商适配器有各自的 Base URL 要求，请按对应教程填写。

API Key 应通过认证请求头或客户端的 Key 配置项传递，不要添加到 URL 路径或查询参数中，也不要将含 Key 的配置截图或粘贴到 AI 对话。

使用配置工具

UniRoute 配置工具与 Skill会根据客户端和模型协议填写地址，查询当前 Key 的模型目录，并在修改前备份配置。

也可以直接参照Codex、Gemini CLI、OpenCode、OpenClaw或Hermes教程配置。

连接问题排查

  • 确认域名、协议和路径正确，避免重复的 /v1 或 /v1beta。
  • 如果连接超时，检查本地网络、DNS 和已有代理设置。可以换一个网络，或对比启用与停用已有代理后的连接情况。
  • 如果返回 401，检查 API Key 是否完整、是否已失效；返回 403 时检查 Key 权限和账户状态。
  • 获取到模型目录仅说明目录请求成功。需要确认模型实际使用情况时，再自行发起简短请求并检查控制台调用记录；模型请求按实际用量计费。

实际连通性取决于您当前的网络环境。遇到问题时请记录时间、客户端版本和错误信息，通过网站支持入口反馈，注意隐藏 API Key。