---
# Google AI Studio Gemini Key 脚本合集 🚀
**English Version:** [README.en.md](README.en.md)
**默认语言:中文**
本仓库现包含 **2 个 Tampermonkey/Greasemonkey 用户脚本 + 3 个浏览器控制台脚本** ,帮助你**批量创建 Google Cloud 项目**并**获取或管理 Google AI Studio(Gemini)API Key**。
适用于需要大规模管理 Key 或频繁创建新项目的场景。
> ⚠️ **重要提示 / 免责声明**
> - **本项目仅供学习和参考使用,任何由此脚本引发的风险由使用者自行承担。**
> - **由于 Google 限制原因,每个项目的 API Key 共享同一资源,默认每个项目只创建 1 个 Key,且建议单账号不超过 5 个项目。**
> - 代码可直接复制粘贴执行(脚本内注释已说明可调整参数),若需修改,可根据注释进行微调。
> - Google 可能随时更新界面或接口,如脚本失效,请自行调试或提交 Issue。
> - **请遵守 Google Cloud 与 Google AI Studio 的服务条款,避免恶意或高频操作导致账号受限。**
> - **如果你觉得本项目有帮助,欢迎点个 Star ⭐️ 支持!**
---
## ✨ 本仓库脚本一览
| 名称 | 文件 | 形态 | 主要功能 | 备注 |
|------|------|------|----------|------|
| **AI Studio API Key Clipboard Automator** | `AI_Studio_API_Key_Clipboard_Automator.user.js` | Tampermonkey | ① 批量创建项目<br>② 生成 Key **并自动复制到剪贴板**<br>③ 提取现有 Key 并复制到剪贴板 | **推荐(手机用户)** — 全流程无需打开控制台 |
| **Google AI Studio Gemini Automation Suite** | `Google_AI_Studio_Gemini_Automation_Suite.user.js` | Tampermonkey | ① 批量创建项目<br>② 生成 Key 并 **输出到浏览器控制台**<br>③ 提取现有 Key 至控制台 | **推荐(电脑用户)** |
| Create-Projects | `CreateProjects.js` | 控制台脚本 | 仅批量创建项目 | 需手动粘贴到 Cloud Console |
| Fetch-Api-Keys | `FetchApiKeys.js` | 控制台脚本 | 为每个项目生成 Key | 需手动粘贴到 AI Studio |
| Fetch-All-Existing-Keys | `FetchAllExistingKeys.js` | 控制台脚本 | 提取账号下全部现有 Key | 需手动粘贴到 AI Studio |
---
## 目录
1. [功能概览](#功能概览)
2. [环境准备](#环境准备)
3. [流程总览](#流程总览)
4. [用户自定义配置](#用户自定义配置)
5. [油猴脚本与控制台脚本使用方式](#油猴脚本与控制台脚本使用方式)
- [方式一:油猴脚本](#方式一油猴脚本)
- [方式二:控制台脚本](#方式二控制台脚本)
6. [仓库结构](#仓库结构)
7. [常见问题 (FAQ)](#常见问题-faq)
8. [可选操作:申请更多项目配额](#可选操作申请更多项目配额)
9. [贡献与反馈](#贡献与反馈)
---
## 功能概览
本仓库的脚本可为你提供以下便利:
- **自动化项目创建**
无需手动点击多次,即可在 Google Cloud Console 中批量创建若干项目。
- **自动化 API Key 生成**
在 Google AI Studio 中为每个新项目自动生成 Gemini API Key,并将结果在浏览器控制台输出,方便统一管理与复制。
- **自动提取已有 API Key**
扫描当前账号下已有的 API Key 并列表输出,让你不会遗失已有的 Key。
---
## 环境准备
1. **Google 账号**
- 需登录 [Google Cloud Console](https://console.cloud.google.com/) 与 [Google AI Studio](https://aistudio.google.com/)。
- 若设置了双因素认证(2FA)或使用企业/学校账号,请先完成解锁。
2. **浏览器和网络**
- 建议使用最新版 Chrome、Edge 或 Firefox。
- 确保网络畅通且可访问 Google 服务,否则脚本可能报错或卡住。
3. **项目配额**
- 免费账号默认可创建 **12 个项目**。若不够,可参考下文[可选操作:申请更多项目配额](#可选操作申请更多项目配额)。
---
## 流程总览
下图简要说明了从登录到创建项目、生成 Key 的完整操作顺序:
```
┌────────────────────────────┐
│ 1. 登录 Google Cloud │
│ (若需 2FA 先解锁) │
└──────────────┬─────────────┘
│
▼
┌────────────────────────────┐
│ 2. (可选) 申请更多配额 │
└──────────────┬─────────────┘
│
▼
┌────────────────────────────┐
│ 3. 运行创建项目脚本 │
│ (批量创建新项目) │
└──────────────┬─────────────┘
│
▼
┌────────────────────────────┐
│ 4. 登录 AI Studio │
│ 打开 /apikey 页面 │
└──────────────┬─────────────┘
│
▼
┌────────────────────────────┐
│ 5. 运行生成 Key 脚本 │
│ (批量生成 API Key) │
└──────────────┬─────────────┘
│
▼
(可选) 如果已有 Key
┌────────────────────────────┐
│ 6. 运行提取 Key 脚本 │
│ (扫描已存在的所有Key) │
└────────────────────────────┘
```
---
## 用户自定义配置
两份 Tampermonkey 脚本顶部均有 **`CONFIG`** 常量(或直接在代码中有同名变量)可自定义参数:
| 参数 | 说明 | 默认值 |
|------|------|-------|
| `TARGET` / `PROJECT_CREATION_COUNT` | 本轮创建的项目数量 | 5 |
| `API_KEYS_PER_PROJECT` | 每个项目要生成的 Key 数 | 1 |
| `BETWEEN` / `PROJECT_CREATION_DELAY` | 连续创建项目的间隔 (ms) | 5000 |
| `API_KEY_CREATION_DELAY` | 连续生成 Key 的间隔 (ms) | 2500 |
| `SELECT_CHANGE_DELAY` | 选择下拉框后额外等待 (ms) | 1000 |
| `MAXR` | 创建异常时最多自动刷新次数 | 5 |
> 建议先按默认配置试运行;如出现超时/配额问题,再适当调大间隔或调低数量。
---
## 油猴脚本与控制台脚本使用方式
### 方式一:油猴脚本
脚本文件:
- `Google_AI_Studio_Gemini_Automation_Suite.user.js`
- `AI_Studio_API_Key_Clipboard_Automator.user.js`
此油猴脚本将项目创建、API Key 生成与 Key 提取三大功能集成在一起,并在页面中插入浮动按钮,让操作更直观。
第一个脚本将 `API KEY` 输出在控制台,而后者自动复制到剪贴板,电脑端用户默认前者方便,手机端用户只能用后者。
#### 使用步骤
1. **安装 Tampermonkey**
- 在浏览器插件商店搜索并安装 “Tampermonkey”(或其他用户脚本管理器)。
- 懒得搜索,也可以点[这里](https://www.tampermonkey.net/)直达
2. **导入油猴脚本**
- 将本仓库中的 `Google_AI_Studio_Gemini_Automation_Suite.user.js` (`AI_Studio_API_Key_Clipboard_Automator.user.js`)文件保存后,添加到 Tampermonkey。
- 若需自定义项目数、等待时间等配置,可在脚本开头的 `CONFIG` 对象中进行修改。
3. **操作说明**
- **在 Google Cloud Console**:
进入 [Google Cloud Console](https://console.cloud.google.com/),页面右上角出现名为 “创建项目并获取APIKEY” 的按钮:
1. 若当前页面不在 `console.cloud.google.com` 域下,脚本会自动跳转到此域。