自定义端点：三种协议与 Base URL 写法
什么时候需要自定义端点
- 你用的是第三方中转/聚合服务，给了你一个专属接口地址；
- 你自建了模型网关（如 one-api 类项目、公司内网代理）；
- 提供商换了新地址，内置默认端点还没跟上。
三种情况都走同一条路：Providers 里新建自定义提供商，或编辑内置提供商的 Base URL。
三种协议怎么选
自定义端点支持三种协议，按你服务的实际接口对号入座：
| 协议 | 典型场景 | 模型同步行为 |
|---|---|---|
| OpenAI 兼容 | 绝大多数中转站与自建网关 | 按协议自动拉模型列表，拉不到可手动添加 |
| Gemini 系列兼容接口 | 同上 | |
| Anthropic | Claude 兼容接口（含各类 Claude 代理） | 同上 |
协议决定请求格式与模型同步方式，选错了会直接报错——最常见的症状是「能保存但同步模型失败」，换协议即可解决。
Base URL 填写规则
- 远程提供商不填：留空就用内置默认端点；填了空值也会回退默认；
- 自定义提供商：填到根路径即可，v1.3.7 起自定义 OpenAI 提供商会自动处理 /v1 后缀——地址里带不带 /v1 都能正确工作，这是该版本更新日志里明确的改进；
- 自动保存：停止输入约 500 毫秒后自动保存生效，找不到保存按钮不是 bug；
- Responses API：OpenAI 类提供商可切到 Responses 端点，仅在你明确需要时开启。
一个安全提醒
Base URL 决定请求最终发到哪台服务器，你的密钥与对话内容都会经过它。填第三方地址前确认你信任该服务；核地址时多看一位字符——多一个点、少一个 s（http 与 https）都是真实发生过的翻车现场。
相关页面
- 填完密钥同步模型失败，先看密钥连不上怎么办；
- 协议为 Anthropic 的端点多一组缓存选项，见Anthropic 缓存开关。