Cherry Studio 配置

Cherry Studio 是图形化桌面客户端，适合把 pragma 配成 OpenAI-compatible 提供商。

第一次配置前，先完成：

• 注册与登录
• 创建 API Key

如果你还不确定该选哪个客户端，先看 客户端配置总览。

开始前准备

你需要准备：

• 一个可用的 pragma 账号。
• 一个你自己创建的 API Key。
• Cherry Studio 已安装并能正常打开。

建议先在 创建 API Key 页面完成 /v1/models 最小验证。验证成功后再配置 Cherry Studio，可以更快区分是 Key 问题还是客户端配置问题。

Base URL 应该填哪个

Cherry Studio 文本模型走 OpenAI-compatible 协议：

Cherry Studio 文本提供商

选择 OpenAI-compatible provider，文本和图像入口分开配置。

名称pragma 文本

类型OpenAI / OpenAI Compatible

API 地址https://pragma.academic-ruc.cc/v1

API Keysk-...

模型以模型列表实际可见为准

https://pragma.academic-ruc.cc/v1

不要漏掉末尾的 /v1。这是 Cherry Studio、Codex CLI、OpenAI SDK 这类客户端和 Claude Code 直连最大的区别。

文本模型提供商

在 Cherry Studio 中添加 OpenAI-compatible 提供商：

配置项	值
名称	pragma 文本
类型	OpenAI / OpenAI Compatible
API 地址	https://pragma.academic-ruc.cc/v1
API Key	你在 pragma 创建的 sk-...
模型	gpt-5.5、gpt-5.4、gpt-5.4-mini 等

添加后按这个顺序验收：

1. 点击模型列表或连接测试。
2. 确认能看到可用模型。
3. 新建一个聊天，发送短消息。
4. 短消息可用后，再尝试长上下文或复杂任务。

图像模型提供商

如果你需要在 Cherry Studio 里直接画图，可以添加图像提供商：

配置项	值
名称	pragma 图像
类型	OpenAI / OpenAI Compatible
API 地址	https://image.academic-ruc.cc/v1
API Key	管理员分配给你的图像 Key
模型	gpt-image-2、codex-gpt-image-2

如果没有图像 Key，先使用站内画图：

https://pragma.academic-ruc.cc/apps/images

图像 API 和文本 API 是两条不同入口。文本模型不要填 image.academic-ruc.cc，图像模型也不要填 pragma.academic-ruc.cc/v1。

配置后验证

配置后验收先短测，再长任务

1. 模型列表

   Cherry Studio 能加载文本模型。

2. 短消息

   新会话短消息能返回。

3. 图像分离

   图像 API 使用 image.academic-ruc.cc/v1。

验证项	成功信号
文本提供商	模型列表能加载
文本聊天	短消息能返回
图像提供商	能提交图像生成请求
站内画图	登录后能进入 /apps/images

如果 Cherry Studio 测试失败，但 创建 API Key 里的 /v1/models 成功，优先检查 Cherry Studio 里的 Base URL、API Key 是否多了空格，以及提供商类型是否选成 OpenAI-compatible。

常见问题

文本能用，图像不能用

先确认你在图像提供商里填的是 https://image.academic-ruc.cc/v1，不是文本 API 地址。

生图等待很久

图像生成不是流式接口，等待 1-2 分钟仍可能正常。不要频繁重复点击生成，否则可能造成排队。

502 或 edits 报错

某些客户端可能把普通文生图请求变成图片编辑请求。遇到持续失败时，先改用站内画图或联系管理员确认当前推荐客户端版本。

下一步

我想做什么	下一页
确认其他客户端怎么填	客户端配置总览
配 Codex CLI	Codex CLI
配 Claude Code	Claude Code
配 RTK 省 token	RTK 省 token 配置
在 OAuth、API、RTK 之间选择	省 token 决策中心
排查 401 / 403 / 404	故障排查
判断是不是服务故障	服务状态
只想网页聊天或画图	在线聊天与画图