Gemini API 密钥申请与配置教程

Gemini 是最常被首先接入的服务——Google AI Studio 提供免费额度，申请门槛低，也是免费档限流提示面板里官方推荐的自助渠道之一。

申请密钥

1. 打开 Google AI Studio 的密钥管理页（设置页里点 Gemini 服务卡片上的密钥页链接可直接跳转）
2. 登录 Google 账号，创建一个 API 密钥
3. 复制生成的密钥字符串

填入应用

1. 设置 → 服务 → 添加服务 → 选 Gemini
2. 在「API 密钥」输入框粘贴刚才复制的字符串
3. 约 0.8 秒后自动校验：状态变为「已连接」即成功，同时自动拉取模型列表
4. 从模型下拉框选一个（新版本会按各家默认策略自动预选）

Gemini 走的是 Google 原生接口格式（不是 OpenAI 兼容格式），这是应用替你处理好的细节，不用关心。它也是少数原生支持 PDF 文档附件的服务之一，见文件附件。

常见问题速查

• 校验显示密钥无效：检查是否复制完整、有无多余空格；确认密钥没有被删除或停用
• 校验显示额度耗尽：免费额度用完，等次日刷新或绑定结算账号
• 连接失败：多为网络环境问题，Gemini 服务在部分地区不可直连，需自行解决网络可达性
• 模型列表拉不下来：连接状态不通过时列表不会刷新，先解决密钥与网络

接入后建议顺手把免费档保持为回退（默认开启），Gemini 偶发限流时聊天不断线。下一个想接聚合网关的，看接入 OpenRouter。