Cherry Studio 支持配置 OpenAI 兼容服务。不同版本的按钮名称可能稍有变化，但核心始终是服务类型、API 地址、密钥和模型 ID 四项。

配置前准备

打开 GBAPI 控制台创建一个专用于 Cherry Studio 的密钥。再打开模型广场，复制准备使用的真实 model ID。不要直接输入“GPT‑5.6”这样的教程专题名称。

添加服务提供商

进入 Cherry Studio 设置，找到模型服务或提供商管理，选择 OpenAI 兼容类型。填写：

  • API Key：在 GBAPI 创建的密钥；
  • API Host/Base URL：GBAPI 文档提供的兼容地址；
  • 模型：从模型广场复制的 ID；
  • 名称：建议写“GBAPI - 工作”以便区分。

地址字段是否需要包含 /v1，以当前客户端字段提示和 GBAPI 文档为准。最常见错误是重复填写，最终请求变成 /v1/v1/...。

做一次最小测试

新建对话，只发送“请只回复连接成功”。如果成功，再测试长文本和常用系统提示词。先不要同时开启联网、插件和知识库，这些功能会增加排查变量。

配置失败怎么定位

401 通常检查密钥；404 检查接口地址；模型不存在检查 model ID；额度或渠道错误则回到 GBAPI 控制台查看余额和模型状态。

配置完成后不要截图分享包含完整密钥的页面。需要给另一台设备使用时，新建单独密钥，后续可以独立撤销。

常见问题

配置成功但模型列表为空怎么办？

先确认客户端是否支持自动拉取模型；不支持时，需要从 GBAPI 模型广场复制 model ID 并手动添加。