开通并配置 Google Gemini API
最后核对：2026-09-21。 Google 的 Gemini CLI 服务范围已在 2026 年发生重要调整，请先阅读下方提示。
对 EasyAI 用户来说，最明确的现行路径是在 Google AI Studio 创建 Gemini Developer API Key。
1. 确认地区可用
Section titled “1. 确认地区可用”先查看 Gemini API 可用地区。如果所在地区不在官方列表中，请等待官方开放，不要使用虚假账号资料或规避地区限制的方法。
2. 创建 API Key
Section titled “2. 创建 API Key”- 使用 Google 账号打开 Google AI Studio API Keys。
- 按页面提示接受服务条款。
- 选择已有 Google Cloud Project，或创建一个新项目。
- 选择 Create API key。
- 保存生成的 Key，不要通过聊天、截图或公开仓库分享。
3. 了解免费与付费层级
Section titled “3. 了解免费与付费层级”Gemini 网页会员、Gemini Code Assist 席位和 Gemini Developer API 是不同产品。购买 Google AI Pro 或 Ultra 不代表 API 自动获得相同额度。
免费层和付费层支持的模型、速率及数据条款可能不同。需要稳定使用时，在对应 Cloud Project 中按官方页面启用 Billing。实时信息见：
4. 在 EasyAI 中怎么填
Section titled “4. 在 EasyAI 中怎么填”打开 AI Agents → Gemini CLI → 配置 API → 添加服务商：
| 字段 | 填写内容 |
|---|---|
| 服务商名称 | Google Gemini 官方 |
| API 类型 | Gemini GenerateContent |
| Base URL | https://generativelanguage.googleapis.com/v1beta |
| API Key | Google AI Studio 创建的 Key |
| 默认模型 | gemini-2.5-flash，或你的项目有权使用的官方模型 ID |
| 启用此服务商 | 开启 |
保存并选择 配置生效，然后执行 重新检测。看到“可访问”后再新建会话。
gemini-2.5-flash：稳定、速度快，适合日常任务，可作为默认起点。gemini-2.5-pro：适合更复杂、对能力要求更高的任务。
Preview 模型可能更新或停止，不建议把预览名称写成长期默认值。每次配置前可查看 Gemini API 官方模型列表。
企业用户登录 Gemini CLI
Section titled “企业用户登录 Gemini CLI”拥有 Gemini Code Assist Standard 或 Enterprise 许可的组织用户，可以按 Gemini CLI 官方认证页 选择 Sign in with Google。公司或学校账号可能还需要：
- 管理员分配企业许可；
- 设置 Google Cloud Project；
- 启用 Gemini for Google Cloud API；
- 配置相应 IAM 权限。
第三方工具不应提取或复用 Gemini CLI 的 OAuth 凭据。Google 官方要求第三方工具使用 Vertex AI 或 Google AI Studio API Key，参见 Gemini CLI FAQ。
API_KEY_INVALID / API key not valid
Key 复制错误、属于错误项目或已失效。回到 AI Studio 核对，必要时创建新 Key。
429 Resource exhausted
当前项目达到速率或用量限制。查看项目用量，等待限制恢复、降低请求频率，或按官方说明升级付费层。
current account is not eligible / location
账号或地区不符合当前服务条件。查看官方地区页；组织账号请联系管理员。
You must be a named user
通常是组织账号缺少 Gemini Code Assist 席位，或个人账号错误使用了组织项目设置。企业用户请管理员分配席位；API Key 路径应使用 AI Studio 项目。
其他问题见 Gemini CLI Troubleshooting。