# Open WebUI 接入指南

https://omnimodel.me/apps/open-webui?lang=zh

> 自部署网页界面，可把本地推理和中转端点放在同一个界面里。

## 适用场景

适合已经在用本地推理的场景：在同一个网页界面里同时使用本地模型和平台上的模型，按需切换。

## 使用建议

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

## 连不通时检查

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

## 配置步骤

1. 进入「Settings → Connections」，新增一个 OpenAI API 连接。
2. 填入下面的 API 地址与密钥后保存。
3. 刷新模型列表，选中模型开始对话。

## 配置参数

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

## 常见问题

### 为什么模型列表里没有想要的模型？

Open WebUI 通过 GET /v1/models 拉取列表，只会显示这把密钥可以调用的模型。检查密钥的可用模型设置后刷新列表。

### 可以和本地模型一起用吗？

可以，把平台作为一个 OpenAI 兼容连接添加即可，本地连接不受影响。