LobeHub 接入中转站：在 AI 服务商里填代理地址，自己部署的用环境变量

LobeHub 是一个 AI 对话和智能体应用，有云端版和桌面版，也可以自己部署。按官方文档，接中转站的办法是用内置的服务商，把它的地址换成中转站的：

应用设置 → AI 服务商，选 OpenAI（用 Claude 原生接口就选 Anthropic），打开右侧的开关；
填 API Key，在 代理地址 里填中转站的地址；
点检查测试连接；
在下面的模型列表里启用要用的模型。

官方文档对“代理地址”的说明是：需要连接代理或兼容接口时可以填写，填的是服务商 API 的 Base URL 或兼容接口的地址。

如果你还没弄清中转站是什么、有哪些风险，先读中转站是什么和用中转站有什么风险；选站可以看中转站排行榜。

开始之前：从中转站拿到三样东西

需要什么	说明
接口地址	OpenAI 兼容接口的地址；用 Claude 的话，再看它有没有单独的 Anthropic 接口地址
模型名	中转站模型页上写的名字，一字不差
API key	在中转站的控制台创建，多数站只显示一次

1选服务商

打开 应用设置 → AI 服务商，在列表里选一个服务商，打开它右侧的开关。选哪个，看你要用中转站的哪种接口：

中转站的接口	选哪个服务商
OpenAI 兼容接口（最常见）	OpenAI
Anthropic 原生接口，用 Claude	Anthropic

通过 OpenAI 兼容接口，中转站上的 Claude、Gemini 等模型也可以放在 OpenAI 这个服务商下面用，只要它是按 OpenAI 的格式提供的。

2填 key 和代理地址

项目	填什么
API Key	中转站的 key
代理地址	中转站的接口地址

官方文档说明，配置会自动保存，不用另外点保存。

代理地址要不要带 /v1

官方文档在讲环境变量 OPENAI_PROXY_URL 时专门解释过这个问题，界面里的代理地址是同一个东西：

默认值是 https://api.openai.com/v1，本身是带 /v1 的。
要不要加，看你的服务商怎么转发。它如果已经把 /v1 这一级转发了，直接填域名就行；它转发的是整个域名的话，就要自己加上 /v1。
官方给的判断办法：测试时发现 AI 返回的消息是空的，就加上 /v1 再试。

落到中转站上：它的文档里通常会写一个带 /v1 的地址，照着填。以酷站AI 为例，它的 OpenAI 兼容接口是 https://api.koozhan.com/v1，Anthropic 接口是 https://api.koozhan.com，不带 /v1。Anthropic 的默认地址 https://api.anthropic.com 也不带 /v1，所以 Anthropic 这一栏一般填到域名或中转站指定的前缀为止。

Chat 接口还是 Responses 接口

按中转站一方的接入文档，OpenAI 服务商的设置里有一个“使用 Responses API 规范”的开关：关着走 /v1/chat/completions，打开走 /v1/responses。两者用同一个代理地址。

兼容性最好的是关着的状态。只有模型要求走 Responses 接口、中转站也支持时才打开。

3检查，启用模型

点检查测试连接。中转站一方的文档里写的是在“连通性检查”处选一个模型再点检查，看到“检查通过”就算配好了。

然后在下方的模型列表里启用要用的模型。官方文档说明，除了启用已有的模型，也可以按页面上的选项获取或添加模型：

点“获取模型列表”，从中转站拉取；
中转站的模型名和内置列表里的不一样时，手动添加自定义模型，模型 ID 照中转站的模型页写。

之后在助理的设置里选这个服务商和模型。

自己部署的：用环境变量

自己部署 LobeHub 时，可以在部署环境里用环境变量把中转站配好，打开就能用。官方文档列出的几个：

环境变量	说明
`OPENAI_API_KEY`	填中转站的 key
`OPENAI_PROXY_URL`	覆盖默认的 OpenAI 请求地址。默认 `https://api.openai.com/v1`
`OPENAI_MODEL_LIST`	控制模型列表，见下文
`ANTHROPIC_API_KEY`	用 Anthropic 原生接口时填
`ANTHROPIC_PROXY_URL`	覆盖默认的 Anthropic 请求地址。默认 `https://api.anthropic.com`

OPENAI_MODEL_LIST 的写法：用 + 增加一个模型，用 - 隐藏一个模型，用 模型名=展示名 改显示的名字，之间用英文逗号隔开。想先禁用全部再启用指定的，用 -all 开头：

OPENAI_API_KEY=你的key
OPENAI_PROXY_URL=https://你的中转站地址/v1
OPENAI_MODEL_LIST=-all,+gpt-6.1-sol,+claude-sonnet-5-5

这样模型选择器里只剩下这两个。模型名换成你的中转站实际提供的。

自己部署并且让别人也能访问时，环境变量里的 key 是所有使用者共用的。 要配好登录验证，不然别人可以用你的额度。这一句是我们的提醒，不是官方文档的原话。

常见问题

现象	检查什么
检查失败，提示连接错误或 key 无效	官方的排查建议：key 里有没有多余的空格，key 的类型和这个服务商是否匹配
发消息后回复是空的	官方的办法：代理地址加上 `/v1` 再试
模型不可用	这个模型你的 key 能不能用；模型名是否和中转站的完全一致
速率限制错误	到了中转站的请求频率上限，等一会儿再试
模型列表里没有想用的模型	获取模型列表，或手动添加自定义模型
打开 Responses 开关后报错	中转站或这个模型不支持 Responses 接口，关掉
自己部署的版本改了环境变量没生效	环境变量要重新部署或重启服务才生效

最后一行不是官方文档的原话，是环境变量通用的规律。

接上之后

“检查通过”只说明接口能通，不说明模型是真的。用同一把 key 到 Veridrop 检测，背景见中转站怎么掺假。
别靠问模型“你是谁”来判断，见问“你是什么模型”为什么验证不了真假。
你发的内容会经过中转站。 官方文档也提醒，本地模型不代表整个流程完全私密，云端同步、搜索等连接器仍可能传输数据。接了第三方接口更是如此，见用中转站有什么风险。
其他客户端的接法：Cherry Studio 接入中转站、NextChat 接入中转站。