> ## Documentation Index
> Fetch the complete documentation index at: https://doc.geekapis.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 在 Cherry Studio 中接入 即刻API使用 AI 模型

> Cherry Studio 配置 即刻API 指南，5 步完成：填写 API 密钥与地址，添加模型 ID，即可使用 Claude、GPT-5、Gemini 等 AI 模型。

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

## 准备工作

在开始之前，请确保：

1. **已安装 Cherry Studio** — 从 [Cherry Studio 官网](https://cherry-ai.com) 下载并安装适合您操作系统的版本
2. **已获取 即刻API API 密钥** — 登录 [即刻API 控制台](https://geekapis.com/dashboard/overview) 获取您的 API 密钥（以 `sk-` 开头）

<Tip>
  如果还没有 即刻API 账户，请先在 [即刻API](https://geekapis.com) 注册并获取 API 密钥。
</Tip>

## 配置步骤

<Steps>
  <Step title="打开模型提供商设置">
    1. 启动 Cherry Studio
    2. 点击左下角的 **设置** 图标（齿轮图标）
    3. 在设置页面中选择 **模型服务** 或 **提供商**
  </Step>

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

  <Step title="填写 API 密钥和 API 地址">
    在 即刻API 提供商的配置页面中，填写以下信息：

    | 配置项        | 填写内容                               |
    | ---------- | ---------------------------------- |
    | **API 密钥** | 您的 即刻API API 密钥（`sk-xxxxxxxxxxxx`） |
    | **API 地址** | `https://geekapis.com/v1/`         |

    <Note>
      API 地址末尾需要保留斜杠 `/`。
    </Note>
  </Step>

  <Step title="添加模型（手动输入模型 ID）">
    1. 在提供商配置页面，点击 **添加模型** 按钮
    2. 填写模型信息：
       * **模型 ID**：输入您想使用的模型 ID（见下方推荐模型列表）
       * **端点类型**：选择 **OpenAI**
    3. 点击保存

    您可以重复上述步骤，按需添加多个模型。
  </Step>

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

## 推荐模型

| 模型名称              | 模型 ID                       | 特点             |
| ----------------- | --------------------------- | -------------- |
| Claude Opus 4.6   | `claude-opus-4-6`           | 最强大，适合复杂任务     |
| Claude Sonnet 4.6 | `claude-sonnet-4-6`         | 性能与速度平衡，推荐日常使用 |
| Claude Haiku 4.5  | `claude-haiku-4-5-20251001` | 快速响应，适合简单任务    |
| GPT-5             | `gpt-5`                     | 最新 OpenAI 旗舰模型 |
| GPT-4o            | `gpt-4o`                    | 高质量对话与多模态      |
| GPT-4o Mini       | `gpt-4o-mini`               | 快速且经济          |
| Gemini 2.5 Pro    | `gemini-2.5-pro`            | Google 多模态旗舰   |

您可以在 [即刻API 模型列表](https://geekapis.com/pricing) 查看所有可用模型 ID。

## 常见问题

<AccordionGroup>
  <Accordion title="连接测试失败怎么办？">
    **解决方案：**

    1. 检查 **API 密钥** 是否正确，确认以 `sk-` 开头
    2. 确认 **API 地址** 填写为 `https://geekapis.com/v1/`（注意末尾的斜杠）
    3. 在 [即刻API 控制台](https://geekapis.com/console/token) 确认密钥未过期且账户余额充足
    4. 检查网络连接，确保能访问 [https://geekapis.com](https://geekapis.com)
  </Accordion>

  <Accordion title="模型找不到怎么办？">
    Cherry Studio 使用手动添加模型的方式，直接在添加模型时输入模型 ID 即可。可在 [即刻API 模型列表](https://geekapis.com/console/models) 查看所有可用模型 ID。
  </Accordion>

  <Accordion title="错误码说明">
    | 错误信息                        | 原因            | 解决方法         |
    | --------------------------- | ------------- | ------------ |
    | `401 Unauthorized`          | API Key 无效或过期 | 重新获取 API Key |
    | `429 Too Many Requests`     | 请求频率超限        | 稍等片刻后重试      |
    | `500 Internal Server Error` | 服务器临时故障       | 等待几分钟后重试     |
    | `insufficient_quota`        | 账户余额不足        | 前往控制台充值      |
  </Accordion>
</AccordionGroup>

## 支持与帮助

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

* 📚 [Cherry Studio 官方文档](https://docs.cherry-ai.com)