# LobeChat 接入指南

https://omnimodel.me/apps/lobe-chat?lang=zh

> 可自部署的网页客户端，支持插件、多会话与移动端 PWA。

## 适用场景

适合团队或个人自部署一个网页聊天界面：支持插件和多会话，还能作为 PWA 装到手机上使用。

## 使用建议

建议给这个客户端单独创建一把密钥，并在密钥设置里限制可用模型，方便单独查看用量。

## 连不通时检查

1. API 地址填 `https://omnimodel.me/v1`，不要多写 `/chat/completions`。
2. 密钥以 `key_` 开头且没有被暂停或撤销，错误码 `auth.invalid_key` 表示密钥不可用。
3. 模型 ID 与[模型目录](/catalog)一致，并且在这把密钥的可用模型里。
4. 余额不足会返回 `billing.insufficient_credit`，更多错误见[常见错误](/docs/errors)。

## 配置步骤

1. 自部署时把 API 地址与密钥写进部署环境变量。
2. 已部署实例可在「设置 → 语言模型 → OpenAI」里直接填写。
3. 在模型列表中添加模型 ID 后即可对话。

## 配置参数

- API 地址：`https://omnimodel.me/v1`
- API 密钥：`YOUR_API_KEY`
- 模型：`MODEL_ID`

## 常见问题

### 自部署时密钥应该放在哪里？

放在服务端环境变量里，而不是让每个访问者在浏览器里填写，这样密钥不会暴露给访问者。

### 插件调用会额外计费吗？

插件本身不收费，但插件触发的每次模型调用都按对应模型的价格计费。