# 在 ChatBox 中使用 OAIRoute
> 跨平台客户端，支持 Windows、macOS、Linux、iOS 与 Android
> 通过自定义 OpenAI 兼容端点接入
> 移动端也能用同一套 Key
## 第一步：获取 API Key
在 [OAIRoute 控制台](https://api.oairoute.com/keys) 创建。
## 第二步：配置
打开 ChatBox，进入 **设置 → 模型**。
- `模型提供方` (string / 必填) — 选 `OpenAI API`。
- `API 域名` (string / 必填) — 填 `https://api.oairoute.com`。 注意：ChatBox 会自己在后面拼 `/v1/chat/completions`，所以这里**不要**带 `/v1`。这与 Cherry Studio 的写法相反，是最容易出错的地方。
- `API 密钥` (string / 必填) — 填你的 Key。
- `模型` (string / 必填) — 从下拉里选，或者点「自定义模型」手动输入模型 ID。
## 第三步：验证
新建对话，发一条消息。如果报 404，先检查 API 域名是不是多写了 `/v1`。
## 各客户端地址写法对照
| 客户端 | 填写的地址 | 是否带 /v1 |
|---|---|---|
| ChatBox | `https://api.oairoute.com` | 否 |
| Cherry Studio | `https://api.oairoute.com/v1` | 是 |
| LobeChat | `https://api.oairoute.com/v1` | 是 |
| NextChat | `https://api.oairoute.com` | 否 |
| 直接用 curl | `https://api.oairoute.com/v1/chat/completions` | 完整路径 |
> **Note:** 
> 判断标准是看客户端说明里写的是「API 域名」还是「完整端点」。写「域名」的通常不带 `/v1`，写「端点」的要带。
## 常见问题
**填了地址后提示 Connection failed**
先确认网络能访问 OAIRoute。可以用系统自带的 curl 或 curl 网页版试一次，排除客户端问题。
**模型列表是空的**
ChatBox 依赖 `/v1/models` 拉取列表。如果该请求失败，列表就为空。改为手动输入模型 ID 即可绕过。
**手机端连不上**
手机与电脑用的 Key 可以相同，但要注意手机网络是否能直连。部分地区的移动网络需要配置代理。
**配置项{Configuration}**
```
模型提供方
OpenAI API
API 域名
https://api.oairoute.com
API 密钥
sk-xxxxxxxxxxxxxxxx
模型
gpt-4o-mini
```
**验证连通性{Verify connectivity}**
```
curl https://api.oairoute.com/v1/models \
  -H "Authorization: Bearer YOUR_OAIRoute_KEY"
```
**发一条消息{Send a message}**
```
curl https://api.oairoute.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_OAIRoute_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-4o-mini","messages":[{"role":"user","content":"你好"}]}'
```