Cherry Studio使用教程:配置88API、自定义模型与图片生成

视频演示Cherry Studio下载安装、配置88API地址和API Key、添加OpenAI兼容模型,并测试文字对话与gpt-image-2图片生成。

Cherry Studio 是一款桌面 AI 客户端,可以集中管理不同模型服务。本文按视频演示完成下载安装、接入 88API、填写 API Key、添加模型,并分别测试普通对话和图片生成。

准备事项:先在 88api.ai 创建可用的 API Key。文字模型和图片模型可能属于不同分组;使用 gpt-image-2 时应选择支持生图模型的 Key。

第一步:下载安装Cherry Studio

进入 Cherry Studio 官方下载页,按自己的系统选择 Windows、macOS 或 Linux 版本。安装完成后打开客户端;如果只使用自定义 API 服务,可以直接进入设置,不必先绑定其他模型账号。

第二步:添加OpenAI兼容服务

1. 打开模型服务设置点击 Cherry Studio 设置,进入“模型服务”或 API 服务商管理。
2. 选择OpenAI兼容类型可以使用 OpenAI 服务项,也可以新建一个自定义 OpenAI Compatible 服务,名称可填写 88API。
3. 填写API Key粘贴从 88API 控制台创建的 Key,注意不要带空格或换行。
4. 填写API地址Base URL 使用 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登录配置教程