# Chatbox 接入指南

https://omnimodel.me/apps/chatbox?lang=zh

> 跨平台桌面与移动客户端，装好就能用，适合日常问答。

## 适用场景

适合日常问答和写作：桌面端和手机端都能用，装好后填入 API 地址、密钥和模型就能开始对话，不需要额外部署。

## 使用建议

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

## 连不通时检查

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

## 配置步骤

1. 打开「设置 → 模型提供方」，选择 OpenAI API 兼容。
2. 填入下面的 API 地址与密钥。
3. 在模型一栏填写模型 ID 后保存。

## 配置参数

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

## 常见问题

### 手机端和电脑端要分别配置吗？

每个设备上的 Chatbox 都需要各自填写 API 地址和密钥，可以共用一把密钥，也可以分开创建以便区分用量。

### 模型一栏填什么？

填模型目录详情页上的模型 ID。