Cherry Studio 是一款桌面 AI 客户端,可以集中管理不同模型服务。本文按视频演示完成下载安装、接入 88API、填写 API Key、添加模型,并分别测试普通对话和图片生成。
gpt-image-2 时应选择支持生图模型的 Key。第一步:下载安装Cherry Studio
进入 Cherry Studio 官方下载页,按自己的系统选择 Windows、macOS 或 Linux 版本。安装完成后打开客户端;如果只使用自定义 API 服务,可以直接进入设置,不必先绑定其他模型账号。
第二步:添加OpenAI兼容服务
https://88api.ai/v1,保存前确认末尾包含 /v1。第三步:添加需要使用的模型
进入模型管理,先尝试从服务端获取模型列表;如果没有自动显示,也可以手动添加准确的模型 ID。模型名称必须与 88API 控制台当前开放名称一致,不能只填写自己随意起的显示名。
| 使用场景 | 配置重点 |
|---|---|
| 文字对话 | 选择当前 Key 分组允许调用的聊天模型 |
| 图片生成 | 添加 gpt-image-2 等控制台实际开放的图片模型,并使用生图分组 Key |
| 模型不可用 | 核对模型 ID、Key 分组、余额和服务地址 |
第四步:测试对话和图片生成
返回 Cherry Studio 首页,新建助手或会话,在顶部选择刚添加的模型。先发送一句简短文字测试连接;使用图片模型时,再提交一条清晰的图片描述。视频中最终成功生成图片,说明 API 地址、Key 和模型配置都已生效。
常见问题
提示API Key无效或401怎么办?
重新复制 Key,检查前后空格、Key 是否启用、额度是否充足,以及当前 Key 是否属于目标模型分组。
为什么模型列表为空?
部分兼容服务不一定能被客户端自动识别,可以手动添加 88API 控制台中显示的准确模型 ID。
文字模型能用但图片模型不能用怎么办?
图片模型需要对应的生图模型权限。检查当前 Key 分组是否支持 gpt-image-2,不要用只开放文字模型的 Key 调用图片接口。
API地址应该填到哪里?
在模型服务的 Base URL 或 API Host 输入框填写 https://88api.ai/v1,不要填写控制台网页地址。
需要继续了解 Codex、VS Code 或其他客户端的 API 配置,可以查看本站 Codex API登录配置教程。