docs

Gemini 配置

在 Cherry Studio 中配置 Gemini 模型

ziyang

— 2 min read

Cherry Studio Gemini 配置

本教程将指导你在 Cherry Studio 中配置 Gemini 模型。

1. 打开设置

  1. 打开 Cherry Studio 应用
  2. 点击左下角的 齿轮 图标进入设置
  3. 在提供商列表中找到 Gemini 并点击

2. 配置 API 信息

在 Gemini 设置页面中：

  1. 开启服务 — 点击右上角的开关启用 Gemini
  2. 填写 API 密钥 — 输入你的 API Key（点击获取）
  3. 填写 API 地址 — 根据你的网络环境选择：

海外直连线路（推荐）

https://api.aicodewith.com/api

国内线路（备用）

https://api.jiuwanliguoxue.com/api

线路选择说明请参考 [线路选择指南](/docs/route-selection)。

  1. 点击 检测 按钮验证配置是否正确

配置完成后界面如下：

API 配置示例

3. 添加模型

配置完 API 后，你需要添加要使用的模型：

  1. 在页面底部找到 + 添加 按钮
  2. 点击添加按钮
添加模型
  1. 输入模型名称，例如：
    • gemini-2.5-pro
    • gemini-2.5-flash
    • gemini-3-pro-preview

完整的可用模型列表请查看 [Gemini API 模型列表](/docs/models/gemini#可用模型)。

4. 开始使用

配置完成后：

  1. 返回聊天界面
  2. 在模型选择器中选择刚添加的 Gemini 模型
  3. 开始对话

常见问题

Q: API 密钥验证失败？

检查以下几点：

  • API 密钥是否正确复制（无多余空格）
  • API 地址是否正确（注意末尾的 /api）
  • 账户余额是否充足

Q: 模型列表为空？

  1. 确保已正确配置 API 地址和密钥
  2. 点击检测按钮验证连接
  3. 如仍为空，尝试重启 Cherry Studio

Q: 连接超时？

尝试切换到另一个线路：

  • 如果使用海外直连，尝试国内线路
  • 或者检查你的网络代理设置

Read more