LobeChat API 配置:界面与环境变量两种接法

三步搞定:界面配置(客户端与网页版通用)

这套配置对桌面客户端、网页版和自部署实例的设置界面完全一致。中转的模型 ID 直接照抄即可:deepseek-v4-flash、deepseek-v4-pro、glm-5、kimi-k2.6、claude-sonnet-4-6、claude-opus-4-7、gpt-5.5、grok-4.5。 一个常见坑:LobeChat 网页版默认由服务端转发请求,如果你的部署环境访问外部 API 不通,可以在服务商设置里打开客户端请求模式,让浏览器直接请求 API 地址,连通性问题立刻好排查。

• 第一步:打开 LobeChat 设置,进入 AI 服务商(旧版本叫语言模型),选中 OpenAI。
• 第二步:API Key 填 kkaiapi 的 sk- 密钥,API 代理地址填 https://api.kkaiapi.com/v1,注意以 /v1 结尾,不要多加 /chat/completions。
• 第三步:在模型列表输入框手动输入模型 ID,比如 deepseek-v4-flash,回车添加,然后点连通性检查,通过即可开聊。

Docker 自部署:环境变量配法

自部署给团队或多人用时,推荐用环境变量把默认服务商写死在容器里,新用户打开页面即可用,不需要每个人手动填 Key。三个核心变量:OPENAI_API_KEY 放密钥,OPENAI_PROXY_URL 放代理地址,ACCESS_CODE 设访问密码防止实例被陌生人白嫖。

docker run -d --name lobe-chat -p 3210:3210 \
  -e OPENAI_API_KEY=sk-你的kkaiapi密钥 \
  -e OPENAI_PROXY_URL=https://api.kkaiapi.com/v1 \
  -e ACCESS_CODE=设一个访问密码 \
  lobehub/lobe-chat

自定义模型列表:OPENAI_MODEL_LIST 写法

默认情况下 LobeChat 会展示一大堆内置 OpenAI 模型名,中转接口未必都有,直接点会报错。用 OPENAI_MODEL_LIST 变量精确控制下拉列表:开头写 -all 隐藏全部内置模型,再用 +模型ID 逐个添加,等号后面是界面上的显示名。 改完重启容器生效。界面上手动添加过的模型不受这个变量影响,两边是叠加关系。

-e OPENAI_MODEL_LIST="-all,\
+deepseek-v4-flash=DeepSeek V4 Flash,\
+deepseek-v4-pro=DeepSeek V4 Pro,\
+glm-5=GLM-5,\
+kimi-k2.6=Kimi K2.6,\
+claude-sonnet-4-6=Claude Sonnet 4.6,\
+claude-opus-4-7=Claude Opus 4.7,\
+gpt-5.5=GPT-5.5"

多模型服务商并存:全挂 OpenAI 入口还是分开配

LobeChat 支持同时启用多个服务商,OpenAI、Anthropic、DeepSeek 各自独立填 Key。走中转时最省事的做法是只开 OpenAI 这一个入口,把 DeepSeek、Claude、GPT、Kimi 的模型 ID 全挂在它下面,会话里点模型名随时切换,计费也集中在一个账户里。 如果你既有官方直连 Key 又有中转 Key,可以官方的填各自服务商,中转的挂 OpenAI 入口,两边并存互不干扰。界面配置和环境变量的分工如下:

常见问题