连接桌面客户端。
Cherry Studio 当前官方文档提供了内置 New API 服务商的配置方式。将它连接到 PrismRoute，再选择所用模型支持的协议。
本页目录
配置服务商
- 打开设置 → 模型服务，选择内置的 New API 服务商。不同语言与版本的界面名称可能略有不同。
- 填写你的 PrismRoute API 密钥，以及下方的根地址。如果当前版本允许重命名，可以将展示名称设为 PrismRoute。
- 本文的 Chat Completions 示例选择 OpenAI Chat 协议；其他协议需要所选模型与账户提供对应支持。
| 字段 | 填写内容 |
|---|---|
| 服务商 | New API；可以重命名时，展示名称用 PrismRoute |
| API 密钥 | 你的 PrismRoute API 密钥 |
| API 地址 / 主机地址 | https://codex.aicpr.icu |
| 本文使用的协议 | OpenAI Chat / Chat Completions |
| 模型 ID | 从目录复制准确的 Chat Completions 模型 ID |
在 Cherry Studio 中填写根地址
这个服务商会自行追加协议的版本路径。请填写 https://codex.aicpr.icu，不附加 /v1 或 /chat/completions。Python 与 JavaScript 指南中的 /v1 地址用于 SDK 配置；这里的客户端字段填写域名根地址。
https://codex.aicpr.icuhttps://codex.aicpr.icu/v1/chat/completions如果安装的版本没有 New API 选项，请按该版本的自定义 OpenAI 兼容服务商设置和下方官方指南配置，并在发送消息前核对最终请求地址。仅按 SDK 指南接入，无需为此升级已有的桌面客户端。
添加并选择模型
- 登录 PrismRoute 模型目录，复制一个密钥有权使用、且支持 Chat Completions 的模型 ID。
- 在 Cherry Studio 中获取模型列表并添加模型，或手动填写准确 ID。展示名称可以自定义，模型 ID 必须完全一致。
- 准备好发送真实模型请求后，可使用服务商的检测按钮。打开右上角启用开关，再到聊天中选择对应服务商和模型。
检测按钮会发送模型请求。获取模型列表与生成消息是两个操作；出现在列表中，并不代表支持工具、视觉、Responses 或其他协议。请先用简短文字验证，再按模型能力增加可选功能。
连接失败时先检查什么
| 现象 | 下一项检查 |
|---|---|
| 401 或密钥无效 | 检查 API 密钥字段，去掉误加的空格。 |
| 404 或接口不存在 | 检查最终请求 URL 与所选协议。 |
| 模型不存在或无权使用 | 检查准确模型 ID、密钥限制与账户分组。 |
| 请求发往旧地址 | 检查服务商设置中是否残留其他协议的单独地址。 |
| 文字正常但工具调用失败 | 确认所选模型与接口是否支持该功能。 |