在 ChatBox 中使用 oairoute
- 跨平台客户端，支持 Windows、macOS、Linux、iOS 与 Android
- 通过自定义 OpenAI 兼容端点接入
- 移动端也能用同一套 Key
第一步：获取 API Key
在 OAIRoute 控制台 创建。
Create one in the OAIRoute console.
第二步：配置
打开 ChatBox，进入 设置 → 模型。
选 OpenAI API。
填 https://api.oairoute.com。
注意：ChatBox 会自己在后面拼 /v1/chat/completions，所以这里不要带 /v1。这与 Cherry Studio 的写法相反，是最容易出错的地方。
填你的 Key。
从下拉里选，或者点「自定义模型」手动输入模型 ID。
Open ChatBox and go to Settings → Model.
Choose OpenAI API.
Enter https://api.oairoute.com.
Note: ChatBox appends /v1/chat/completions itself, so don't include /v1 here. This is the opposite of Cherry Studio and is the easiest place to go wrong.
Enter your key.
Pick from the dropdown, or click "Custom model" and type the model ID.
第三步：验证
新建对话，发一条消息。如果报 404，先检查 API 域名是不是多写了 /v1。
Start a new conversation and send a message. If you get a 404, first check whether the API host has an extra /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 | 完整路径 |
判断标准是看客户端说明里写的是「API 域名」还是「完整端点」。写「域名」的通常不带 /v1，写「端点」的要带。
| Client | URL to enter | Includes /v1 |
|---|---|---|
| ChatBox | https://api.oairoute.com | No |
| Cherry Studio | https://api.oairoute.com/v1 | Yes |
| LobeChat | https://api.oairoute.com/v1 | Yes |
| NextChat | https://api.oairoute.com | No |
| curl directly | https://api.oairoute.com/v1/chat/completions | Full path |
The rule is whether the client's docs say "API domain" or "full endpoint". "Domain" usually means no /v1; "endpoint" means include it.
常见问题
填了地址后提示 Connection failed
先确认网络能访问 OAIRoute。可以用系统自带的 curl 或 curl 网页版试一次，排除客户端问题。
模型列表是空的
ChatBox 依赖 /v1/models 拉取列表。如果该请求失败，列表就为空。改为手动输入模型 ID 即可绕过。
手机端连不上
手机与电脑用的 Key 可以相同，但要注意手机网络是否能直连。部分地区的移动网络需要配置代理。
"Connection failed" after entering the URL
First confirm your network can reach OAIRoute. Try the built-in curl or a curl web service once to rule out the client.
The model list is empty
ChatBox pulls the list from /v1/models. If that request fails, the list is empty. Type the model ID manually to work around it.
Can't connect from a phone
The phone and the computer can use the same key, but check whether your mobile network can reach the API directly. Some carriers require a proxy.