Skip to main content
Cherry Studio 是一款功能强大的跨平台 AI 桌面客户端，支持多种模型提供商。通过配置 即刻API 作为自定义提供商，您可以在 Cherry Studio 中使用 Claude、GPT-5、Gemini 等顶级 AI 模型。

​
准备工作

在开始之前，请确保：
  1. 已安装 Cherry Studio — 从 Cherry Studio 官网 下载并安装适合您操作系统的版本
  2. 已获取 即刻API API 密钥 — 登录 即刻API 控制台 获取您的 API 密钥（以 sk- 开头）
如果还没有 即刻API 账户，请先在 即刻API 注册并获取 API 密钥。

​
配置步骤

1

打开模型提供商设置

  1. 启动 Cherry Studio
  2. 点击左下角的 设置 图标（齿轮图标）
  3. 在设置页面中选择 模型服务 或 提供商
2

添加 即刻API 提供商

  1. 点击提供商列表右上角的 + 按钮，添加新提供商
  2. 在弹出的对话框中填写：
    • 名称：填写 即刻API（或您喜欢的名称）
    • 提供商类型：选择 New API（兼容 OpenAI 格式）
  3. 点击 确认 完成创建
3

填写 API 密钥和 API 地址

在 即刻API 提供商的配置页面中，填写以下信息：
配置项填写内容
API 密钥您的 即刻API API 密钥（sk-xxxxxxxxxxxx）
API 地址https://geekapis.com/v1/
API 地址末尾需要保留斜杠 /。
4

添加模型（手动输入模型 ID）

  1. 在提供商配置页面，点击 添加模型 按钮
  2. 填写模型信息：
    • 模型 ID：输入您想使用的模型 ID（见下方推荐模型列表）
    • 端点类型：选择 OpenAI
  3. 点击保存
您可以重复上述步骤，按需添加多个模型。
5

启用并验证连接

  1. 确保提供商右侧的开关处于开启状态
  2. 点击 检查连接 或 测试 按钮，验证配置是否正确
  3. 如果提示连接成功，说明配置完成
  4. 返回 Cherry Studio 主界面，在对话框顶部的模型选择器中选择刚才添加的 即刻API 模型，开始对话

​
推荐模型

模型名称模型 ID特点
Claude Opus 4.6claude-opus-4-6最强大，适合复杂任务
Claude Sonnet 4.6claude-sonnet-4-6性能与速度平衡，推荐日常使用
Claude Haiku 4.5claude-haiku-4-5-20251001快速响应，适合简单任务
GPT-5gpt-5最新 OpenAI 旗舰模型
GPT-4ogpt-4o高质量对话与多模态
GPT-4o Minigpt-4o-mini快速且经济
Gemini 2.5 Progemini-2.5-proGoogle 多模态旗舰
您可以在 即刻API 模型列表 查看所有可用模型 ID。

​
常见问题

解决方案：
  1. 检查 API 密钥 是否正确，确认以 sk- 开头
  2. 确认 API 地址 填写为 https://geekapis.com/v1/（注意末尾的斜杠）
  3. 在 即刻API 控制台 确认密钥未过期且账户余额充足
  4. 检查网络连接，确保能访问 https://geekapis.com
Cherry Studio 使用手动添加模型的方式，直接在添加模型时输入模型 ID 即可。可在 即刻API 模型列表 查看所有可用模型 ID。
错误信息原因解决方法
401 UnauthorizedAPI Key 无效或过期重新获取 API Key
429 Too Many Requests请求频率超限稍等片刻后重试
500 Internal Server Error服务器临时故障等待几分钟后重试
insufficient_quota账户余额不足前往控制台充值

​
支持与帮助

如果您在使用过程中遇到任何问题：