API Base URL 对照表：各协议怎么填
HRouter 同时提供 OpenAI、Anthropic（Claude）和 Gemini 三种协议的入口。Base URL 填错是新手最常见的问题：有的工具要带 /v1，有的不能带。这一页列出各工具该填什么，以及为什么。
一张表看全
| 协议 / 工具 | Base URL | 客户端自动拼接的路径 |
|---|---|---|
| OpenAI Responses（Codex） | https://hrouter.net/v1 |
/responses |
| OpenAI Chat Completions（Cherry Studio、Cline、OpenAI SDK 等） | https://hrouter.net/v1 |
/chat/completions |
| Claude / Anthropic Messages（Claude Code、Anthropic SDK） | https://hrouter.net |
/v1/messages |
| Gemini CLI | https://hrouter.net |
Gemini 协议路径 |
| Grok（OpenAI 兼容调用） | https://hrouter.net/v1 |
/responses |
| 查询模型列表 | https://hrouter.net/v1/models |
直接请求 |
为什么有的带 /v1，有的不带
客户端只会在你填写的 Base URL 后面拼接自己的接口路径：
- OpenAI 系客户端拼接的是
/chat/completions、/responses这类路径，所以 Base URL 要自带/v1。 - Anthropic 的 SDK 和 Claude Code 拼接的是
/v1/messages，路径里已经含有/v1，所以 Base URL 只填站点根地址。 - 如果在 Anthropic 客户端里也填了
/v1，实际请求就变成/v1/v1/messages，会返回 404。
三条规则
- 不要在 Base URL 后面再加
/responses、/chat/completions或/messages。 - 不要填网页地址，例如
/home、/keys、/docs，也不要填本地预览地址。 - 地址末尾不要多写斜杠以外的内容；多一个或少一个
/v1是 404 的头号原因。
常用鉴权方式
| 协议 | 鉴权头 |
|---|---|
| OpenAI 兼容 | Authorization: Bearer sk-xxxxx |
| Anthropic Messages | x-api-key: sk-xxxxx，部分客户端使用 Authorization: Bearer |
| Gemini | x-goog-api-key: sk-xxxxx |
Key 只放在请求头里，不要拼进 URL 的查询参数，网关不接受这种用法。
模型范围
| 工具 | 可用模型 |
|---|---|
| Codex / OpenAI 兼容 | 当前 Key 返回的全部 OpenAI / Codex 模型 |
| Claude Code / Anthropic 协议 | 当前 Key 返回的全部 Claude 模型 |
| Grok | grok-4.5 |
| Gemini CLI | 当前 Key 返回的 Gemini 模型 |
模型权限与 Key 的分组相关，详见 如何选择 Key 分组；准确列表以 查询可用模型 的结果为准。
按工具查看详细教程
| 工具 | 教程 |
|---|---|
| Claude Code | 安装与配置、VSCode、JetBrains、KiloCode / RooCode |
| Codex | 安装与配置、VSCode、JetBrains |
| Gemini CLI / Grok Build | Gemini CLI、Grok Build |
| 图形客户端 | Cherry Studio、Cline |
| 代码调用 | OpenAI SDK、Anthropic SDK |
| 不想手动配置 | HRouter Desktop |
连接失败先检查这三项
- Key 是否完整、没有空格、状态可用：API 401 报错
- Base URL 是否符合上表：404 路径错误
- 模型名是否在当前 Key 的模型列表中：model_not_found