客户端接入 · LobeChat

LobeChat 接入 HardysAPI:改一个代理地址

LobeChat 内置 OpenAI 提供商,只要把「接口代理地址」指向中转站,再补上模型名即可。自部署版本还要注意浏览器直连的跨域问题。

先准备两样东西:在 控制台 创建 API 密钥(复制 sk- 开头的完整字符串), 以及要用的模型名(从 模型价格 里挑,名字要一字不差)。

配置步骤(网页版 / 桌面版)

  1. 打开 设置 → AI 服务商,找到 OpenAI 并启用;
  2. API Key 粘贴 sk-...;
  3. 接口代理地址 填 https://hardysapi.com/v1;
  4. 在该服务商下点「获取模型列表」,或手动添加模型名;
  5. 新建对话,在顶部模型选择器里选中刚加的模型。

自部署(Docker)额外注意

自部署时请求从浏览器直连中转站,如果页面是 http 而 API 是 https,或者反过来, 浏览器会拦截混合内容。另外 OAI_PROXY_URL 这类环境变量只影响服务端请求,用户自定义的代理地址优先生效。

docker-compose 片段yaml
environment:
  # 只改默认值,用户在设置里填的地址仍会覆盖它
  OPENAI_PROXY_URL: https://hardysapi.com/v1

常见坑

  • 模型列表拉不到:拉取走的是 /v1/models,如果密钥所属分组没有模型会返回空列表,手动添加即可。
  • 提示 model not found:LobeChat 的模型名区分大小写,且必须是该分组里存在的名字。
  • 助手市场里的模型用不了:那些是预设模型名,要在助手设置里改成你分组里的模型。

常见问题

LobeChat 的接口代理地址填什么?

https://hardysapi.com/v1。填好后在 OpenAI 提供商下刷新模型列表即可。

LobeChat 自部署后浏览器报 CORS 错误怎么办?

确认页面协议与 API 一致(都用 https),并检查反向代理是否透传了 Origin 头;中转站的接口本身允许跨域。