自定义 API 地址(中转站 / 代理 / 网关):怎么接入 OpenAI 兼容 API
自定义 API 端点和 Base URL 是什么,怎么只用一个地址加一把 Key,接入 OpenAI 兼容 API、中转站、代理或网关。
- 自定义 API 端点,就是应用里没有内置的 AI 服务(比如 OpenAI 兼容 API、中转站、代理或网关)的网址,也叫 Base URL(接口地址)。在 Oriveo 里接入一个,通常只要两样东西:这个地址,加一把 API Key。
- Oriveo 会替你识别协议(OpenAI Chat Completions、OpenAI Responses、Anthropic Messages 或 Gemini);你只填根地址时,它会自动补上 /v1 这类版本路径。
- 公网地址必须用 HTTPS。第三方服务能看到你经它发送的所有内容,所以要单独给它一把设了消费上限的 Key,永远别把官方供应商的 Key 交给它。

Base URL 或 API 端点是什么?
每个 AI 服务都有一个网址,应用把请求发到这里。开发者管它叫 Base URL、API 端点(endpoint)或请求地址,在这里说的都是同一个东西。它看上去就是个普通网址,比如 OpenAI 的是 https://api.openai.com/v1。
在 Oriveo 里,15 家内置供应商的地址都已经填好,你只要粘贴 Key。自定义端点用来接其他服务:提供 OpenAI 兼容 API 的服务、公司运营的中转站或网关,或者你在自己服务器上搭的网关。
「OpenAI 兼容」是说这项服务接受和 OpenAI API 相同格式的请求,所以给 OpenAI 做的应用也能直接和它对接。很多供应商和网关都提供这种格式。
中转站、代理、网关有什么区别?
这几个词大家用得比较随意,对接入应用来说作用一样:一项服务站在你的应用和模型供应商之间,接收你的请求再转发出去。有的把几家供应商归到同一把 Key、同一份账单下;有的给团队加上用量管控;有的是你在自己服务器上运行的软件。
Oriveo 不推荐、也不给其中任何一家排名。不管你用哪个,下面的步骤都一样。
接入自定义端点需要准备什么?
通常两样东西,都在这项服务自己的后台或文档里:
- 请求地址(Base URL),例如 https://api.example.com/v1。服务在公网上的话,必须以 https:// 开头。
- 这项服务发给你的 API Key。想加更多 Key,可以点「再加一把密钥」。
- 可选:给这条连接起个名字,方便和其他连接区分。
怎么在 Oriveo 里添加自定义端点?
iPhone、Android 和网页上步骤一样。
- 打开「供应商」,点「+」按钮(添加供应商)。
- 选「自定义」分类,再选「自定义中转站」(「接入你自己的模型服务」)。
- 在「连接自定义中转站」页粘贴请求地址和 API Key。「将请求 …」这一行会显示 Oriveo 实际要用的完整地址。点「下一步」。
- Oriveo 会检查连接、读取模型列表,并判断每个模型的协议。这一步只读列表,不会发聊天消息。
- 勾选你要的模型,点「保存(已选 N)」。如果服务不提供模型列表,就用「手动添加模型 ID」。
- 保存前,Oriveo 会给第一个选中的模型发一个很小的请求。测试通过才会保存连接;没通过的话,你会停在这一步,改好再试。

想全部自己设置?用「手动设置」
「手动设置」把所有选项放在一页:地址、Key、模型 ID、可选的连接名称,以及默认协议(初始为自动)。点「验证并保存」。检查没通过时,什么都还没保存;失败卡片上会出现「仍然保存(未验证)」,想先留下连接、以后再测,可以点它。
Oriveo 会自动识别协议吗?
大多数情况下会。AI 服务的请求格式(也就是协议)就那么几种,Oriveo 支持四种:OpenAI Chat Completions、OpenAI Responses、Anthropic Messages 和 Gemini generateContent。
它按模型逐个判断:服务提供了某个模型的相关信息就照着用,没有的话就按模型所属的系列挑出可能的候选。保存时,第一个选中的模型会用真实请求测一次;其他模型在你开始使用时再检查。
所以多数情况下,地址和 Key 就够了。如果服务文档指明了某种协议,或者某个模型没通过检查,就到「手动设置」里自己选协议。
地址后面要加 /v1 吗?
一般不用。如果你只填根地址,比如 https://api.example.com,Oriveo 会按协议补上标准版本路径:OpenAI 和 Anthropic 格式补 /v1,Gemini 补 /v1beta。
如果地址里已经有版本号,比如 /api/paas/v4,Oriveo 会保留。如果你粘贴的是以 /chat/completions、/responses、/messages 或 :generateContent 结尾的完整端点,Oriveo 会去掉这段结尾,并据此判断服务用的是哪种协议。
点「下一步」之前,看一眼「将请求 …」那一行。如果检查提示「地址可能填到了网页,检查是否少了 /v1。」,就拿你的地址和服务文档对一对。
| 你填的 | Oriveo 实际请求(OpenAI 格式) |
|---|---|
| https://api.example.com | https://api.example.com/v1 |
| https://api.example.com/v1 | https://api.example.com/v1 |
| https://api.example.com/v1/chat/completions | https://api.example.com/v1,使用 Chat Completions |
| https://api.example.com/api/paas/v4 | https://api.example.com/api/paas/v4 |
哪些地址可以用?
为了保护你的 Key,Oriveo 有几条规则:
- 公网地址必须以 https:// 开头。公网上的 http:// 地址无法测试,也无法保存。
- 地址里带用户名和密码,或者带查询参数(「?」后面的内容)的,一律不接受。Oriveo 从不尝试读取查询参数里的 API Key。
- 家里局域网或私人 VPN 上的普通 http:// 地址,比如你自己电脑上跑的模型服务,要走单独的「本地算力」入口(iPhone 上叫「本机与局域网算力」),不走「自定义中转站」。
- 在 iPhone 和 Android 上,应用直接连接这个地址。
- 在网页版里,公网请求地址经 Oriveo 服务器转发,以绕开浏览器 CORS 限制(浏览器的一条安全规则,会拦下很多直接请求)——API Key 仅在该次请求的内存中使用,不落盘、不记录。局域网请求地址由当前设备直接连接,两种情况都要求 HTTPS;家里局域网上的普通 http:// 地址,需要用 iPhone 或 Android 应用里的「本地算力」入口。
- 密钥只存本机,不随云同步上传。
内置供应商的 Base URL
在 Oriveo 里用不到这些:直接按名字选供应商就行。列出来是因为很多人在别的工具里要查。下面每个都是供应商文档里给出的官方 OpenAI 兼容地址,截至 2026 年 11 月 18 日。
- Anthropic 说它的 OpenAI 兼容层是用来测试和比较的,Mistral 的快速入门也没说它的 API 兼容 OpenAI。这两家请直接作为内置供应商添加。
| 供应商 | OpenAI 兼容 Base URL |
|---|---|
| OpenAI | https://api.openai.com/v1 |
| Google Gemini | https://generativelanguage.googleapis.com/v1beta/openai/ |
| OpenRouter | https://openrouter.ai/api/v1 |
| DeepSeek | https://api.deepseek.com |
| xAI(Grok) | https://api.x.ai/v1 |
| Groq | https://api.groq.com/openai/v1 |
| Together AI | https://api.together.ai/v1 |
| Fireworks AI | https://api.fireworks.ai/inference/v1 |
| MiniMax(国际版) | https://api.minimax.io/v1 |
| Z.ai(国际版) | https://api.z.ai/api/paas/v4/ |
| Qwen(新加坡区域) | https://dashscope-intl.aliyuncs.com/compatible-mode/v1 |
| Kimi(国际版) | https://api.moonshot.ai/v1 |
| SiliconFlow(国际版) | https://api.siliconflow.com/v1 |
用中转站或第三方 API 安全吗?
要小心。任何站在你和模型之间的服务,都能看到你的提示词、附带的文件和模型的回复,价格也由它自己定。Oriveo 看不到它内部的情况,也无法替它担保。
- 永远别把官方供应商账号里的 API Key 交给第三方服务。用这项服务发给你的 Key。
- 给 Oriveo 单独建一把 Key;如果服务支持,设个消费上限,或者只留少量余额。
- 不信任的服务,别经它发送密码、证件号码或工作机密。
- 到服务自己的后台查看用量。Oriveo 显示的费用是预估,以服务方的记录为准。
- Key 一旦泄露,到服务后台删掉,再建一个新的。
自定义端点为什么连不上?
Oriveo 会用一句话告诉你哪里出了问题。以下是简体中文界面的提示原文:
- 遇到 401、402、429 这类错误码,可以看我们的 API Key 报错指南,里面逐个解释了含义。
| Oriveo 的提示 | 要检查什么 |
|---|---|
| 地址可能填到了网页,检查是否少了 /v1。 | 拿地址和服务文档对一对;加上或去掉版本路径 |
| 密钥无效。 | 到服务后台重新复制 Key |
| 密钥没有访问模型列表的权限,可手动添加模型。 | 在下一步自己填模型 ID |
| 连不上,检查网络或代理。 | 检查网络连接,以及这个地址能否访问 |
| 这个地址上的服务正在限流。 | 稍等一下再试 |
| 这条连接连不上它的上游供应商。 | 它背后在供应商那边的账号可能失效、欠费或被限流;联系这项服务的运营方 |