# 在 Cherry Studio 中使用 OAIRoute
> 桌面端的多模型客户端，支持自定义 API 端点
> 配置一次即可用 OAIRoute 的所有模型
> 支持多 Key 切换与对话历史本地保存
## 第一步：获取 API Key
在 [OAIRoute 控制台](https://api.oairoute.com/keys) 创建 Key，复制备用。
## 第二步：添加服务商
打开 Cherry Studio，进入 **设置 → 模型服务**，点底部的 **添加**，填写：
- `提供商名称` (string / 必填) — 自定义，建议填 `OAIRoute`，便于和其他服务商区分。
- `提供商类型` (string / 必填) — 选 `OpenAI`。OAIRoute 的文本接口与 OpenAI 结构完全兼容。
- `API 地址` (string / 必填) — 填 `https://api.oairoute.com/v1`。注意结尾的 `/v1` 不能省。
- `API 密钥` (string / 必填) — 填上一步复制的 Key。
## 第三步：添加模型
在同一页面点 **管理**，手动添加模型 ID。常用的几个：
| 模型 ID | 用途 |
|---|---|
| `gpt-4o-mini` | 日常对话，成本低 |
| `claude-sonnet-5-5` | 长文写作与代码 |
| `gemini-2.5-pro` | 超长上下文 |
| `deepseek-chat` | 中文场景 |
> **Note:** 
> 模型 ID 必须与 OAIRoute 返回的完全一致。可以调用 `GET /v1/models` 拿到完整清单，不要凭印象填。
## 第四步：验证
回到主界面，新建对话，在顶部的模型下拉里选中刚添加的模型，发一条消息。能正常回复即配置成功。
## 图像生成
图像接口走 `/v1/images/generations`，但**域名取决于模型**：
- GPT-Image 等非火山模型走 `https://api.oairoute.com/v1`，与文本共用同一个服务商条目即可
- Seedream 与 Seedance 系列走 `https://ark.oairoute.com/v1`，需要单独再建一个服务商条目，并到 [ark 站](https://ark.oairoute.com/) 获取 Key
> **Note:** 
> 两站的 Key 不通用。只用 GPT-Image 的话不必建第二个条目。
## 常见问题
**回复为空或一直转圈**
多数是 API 地址少了 `/v1`，或者多了结尾斜杠。正确写法是 `https://api.oairoute.com/v1`。
**提示 401**
Key 复制时带了空格，或者用了已经删除的 Key。重新生成一个再试。
**提示 404 model not found**
模型 ID 写错了。用模型列表接口核对，注意大小写和连字符。
**对话很慢**
换用更小的模型，或在设置里把「上下文消息数」调小。上下文越长，首 token 延迟越明显。
**文本配置{Text configuration}**
```
API 地址
https://api.oairoute.com/v1
API 密钥
sk-xxxxxxxxxxxxxxxx
模型 ID
gpt-4o-mini
claude-sonnet-5-5
gemini-2.5-pro
```
**图像配置（非火山模型）{Image configuration (non-Volcengine)}**
```
API 地址
https://api.oairoute.com/v1
模型 ID
gpt-image-1
```
**图像配置（火山模型）{Image configuration (Volcengine)}**
```
API 地址
https://ark.oairoute.com/v1
模型 ID
seedream-5-0-pro
```
**核对模型清单{Verify model list}**
```
curl https://api.oairoute.com/v1/models \
  -H "Authorization: Bearer YOUR_OAIRoute_KEY"
```