在 LobeChat 里使用珂艾网关

能用。 网页版在设置里填，自部署版配环境变量，两条路都通。
整理日期：2026-10-19 ｜相关：配置三要素 · 按任务选模型

一、配置三要素

要素	填什么	位置
Base URL（接口代理地址）	`https://turbo.apimax.host/v1`	设置 → 语言模型 → OpenAI
API Key	`sk-` 开头的珂艾密钥	同上
模型	`claude-sonnet-5-5` 等网关 ID	模型列表手动添加

⚠️ LobeChat 走 OpenAI 兼容协议，接口代理地址要带 /v1。

二、网页版 / 桌面版配置

打开 LobeChat → 左下角设置（齿轮）。

进入 语言模型（Language Model）标签。

找到 OpenAI 分组，展开。

填两栏：

字段	填什么
API Key	你的 `sk-` 密钥
接口代理地址 / API 代理地址	`https://turbo.apimax.host/v1`

在同一页的 模型列表 里，添加你要用的模型 ID：

claude-sonnet-5-5

保存。回到对话页，顶部模型选择器里选中它。

LobeChat 默认只显示内置的几个 OpenAI 模型名。不手动添加的话，你在下拉里找不到网关的模型。

三、自部署版：用环境变量

如果你是自己部署的 LobeChat（Docker / Vercel），用环境变量更省事，所有用户共享配置：

想预置模型列表，再加一条：

Docker 示例：

改环境变量后要重启容器，不会热加载。

给模型打能力标记（可选但有用）

LobeChat 支持在模型名后加标记，让它知道模型支持什么：

标记	含义
`<fc>`	支持 function calling（工具调用）
`<vision>`	支持图片输入
`<reasoning>`	支持推理模式

加上标记后，LobeChat 才会在界面上显示对应的按钮（传图、插件调用等）。

四、验证是否真的通了

发送：

用一句话说明你现在用的模型

判定标准：

✅ 正常回复且模型名对 → 通了

❌ 404 → 接口代理地址漏了 /v1

❌ 401 → 密钥错或带空格

❌ 下拉里找不到模型 → 没在模型列表里添加

❌ 传图按钮不出现 → 模型没打 <vision> 标记

五、推荐模型搭配

用途	模型 ID	标记
日常对话、写作	`claude-sonnet-5-5`	`<fc><vision>`
便宜大批量	`deepseek-v4-flash`	`<fc>`
看截图 / 表格	`gemini-3.8-flash`	`<fc><vision>`
复杂推理	`claude-opus-5-5`	`<fc><vision><reasoning>`
代码	`gpt-5.3-codex`	`<fc>`

标记只是让界面显示对应功能，实际能不能用取决于模型本身。

六、常见报错

现象	原因	解决
`404`	代理地址漏 `/v1`	补上
`401`	密钥错 / 带空格	重新复制
模型列表是空的	没手动添加	在模型列表里填 ID
环境变量改了没生效	容器没重启	`docker restart lobechat`
传图报错	模型不支持视觉或没打标记	换 `gemini-3.8-flash`
插件 / 工具调用失败	模型不支持 fc 或没打标记	换 `claude-sonnet-5-5`

七、计费与分组

项目	信息
计费方式	按量计费（按输入 / 输出 token 结算）
特点	LobeChat 的「话题」会带完整历史，长话题用量大
建议	自部署供多人用时，建议各自配令牌，便于分摊

实际单价以价格页为准。

八、相关阅读

同类客户端：Cherry Studio · Chatbox · NextChat

搞不清填什么：配置三要素

选模型：按任务选模型

报错排查：配置报错对照表

九、更新记录

日期	改了什么
2026-10-19	重写。原篇仅 134 字（两张截图）。补自部署环境变量配法、模型能力标记 `<fc>` / `<vision>` / `<reasoning>` 的用法

在 LobeChat 里使用珂艾网关

一、配置三要素#

二、网页版 / 桌面版配置#

三、自部署版：用环境变量#

给模型打能力标记（可选但有用）#

四、验证是否真的通了#

五、推荐模型搭配#

六、常见报错#

七、计费与分组#

八、相关阅读#

九、更新记录#