自定义端点与 Base URL

自定义 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 交给它。
iPhone 上的 Oriveo 供应商页面,列出你已接入的供应商和本月花费。

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 会给第一个选中的模型发一个很小的请求。测试通过才会保存连接;没通过的话,你会停在这一步,改好再试。
iPhone 上 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。」,就拿你的地址和服务文档对一对。

地址后面要加 /v1 吗?
你填的Oriveo 实际请求(OpenAI 格式)
https://api.example.comhttps://api.example.com/v1
https://api.example.com/v1https://api.example.com/v1
https://api.example.com/v1/chat/completionshttps://api.example.com/v1,使用 Chat Completions
https://api.example.com/api/paas/v4https://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。这两家请直接作为内置供应商添加。
内置供应商的 Base URL
供应商OpenAI 兼容 Base URL
OpenAIhttps://api.openai.com/v1
Google Geminihttps://generativelanguage.googleapis.com/v1beta/openai/
OpenRouterhttps://openrouter.ai/api/v1
DeepSeekhttps://api.deepseek.com
xAI(Grok)https://api.x.ai/v1
Groqhttps://api.groq.com/openai/v1
Together AIhttps://api.together.ai/v1
Fireworks AIhttps://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
连不上,检查网络或代理。检查网络连接,以及这个地址能否访问
这个地址上的服务正在限流。稍等一下再试
这条连接连不上它的上游供应商。它背后在供应商那边的账号可能失效、欠费或被限流;联系这项服务的运营方

应用常见问题

自定义 API 端点是什么?
就是应用里没有内置的 AI 服务的网址,比如 OpenAI 兼容 API、中转站或网关。填上这个地址(Base URL)和这项服务给你的 API Key,就能接入。
OpenAI 兼容 API 是什么?
一种接受与 OpenAI 相同请求格式的 API,所以给 OpenAI 做的应用也能用它。很多供应商和网关都提供,地址通常以 /v1 结尾。
Base URL 该填什么?
填服务文档里给的那个。如果文档只给了域名,就填域名,Oriveo 会补上 /v1(Gemini 格式补 /v1beta)。继续之前,看一眼「将请求 …」那一行。
iPhone 和 Android 上能用自定义端点吗?
能。iPhone、Android 版 Oriveo 和网页版都有「自定义中转站」。在 iPhone 和 Android 上,应用直接连接这个地址。
Oriveo 为什么要求 HTTPS?
HTTPS 会加密连接,你的 Key 和消息不会以明文在网上传输。家里局域网上的模型服务,请用「本地算力」入口。
用 API 中转站或代理安全吗?
它能看到你经它发送的所有内容,所以可不可信很关键。用这项服务给你的 Key,永远别用官方供应商的 Key;设好消费上限,敏感信息别经它发。

延伸阅读

来自博客

接入你自己的模型服务

打开网页版,或下载 iPhone、Android 版 Oriveo,选择「自定义中转站」,粘贴服务给你的地址和 Key。

还没有 API Key?可以先用 Oriveo Free 开始。