Gemini API Key 开通（Journal）
这份流程针对 Google AI Studio 的 Gemini API key。
1. 前置条件
- 已登录 Google 账号。
- 账号满足 AI Studio 访问条件（地区可用、年龄要求）。
- 如地区不可用，可改用 Vertex AI 的 Gemini API 路径。
2. 创建 API key
- 打开 AI Studio API Keys。
- 选择已有项目，或按提示新建项目并生成 key。
- 保存 key（仅用于服务端，不放前端代码与仓库）。
备注：新用户通常会自动获得一个默认项目和 API key。
3. 开通付费层（按需）
- 打开 Gemini API Billing 文档 对照你的当前层级（Free Tier / Paid Tier）。
- 在 AI Studio 的 API keys 或 Projects 页面，找到项目后点击
Set up billing。 - 绑定 Cloud Billing 后，该项目下 key 按 Paid Tier 计费与配额执行。
4. 本地环境变量
export GEMINI_API_KEY="your_api_key_here"Gemini 官方 SDK 同时支持 GEMINI_API_KEY 与 GOOGLE_API_KEY，若两者同时存在，GOOGLE_API_KEY 优先。
5. 最小可用验证
curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-flash:generateContent?key=${GEMINI_API_KEY}" \
-H "Content-Type: application/json" \
-X POST \
-d '{
"contents": [{
"parts": [{
"text": "Return OK"
}]
}]
}'返回中出现模型内容即可视为 key 可用。
6. 常见问题（直接原因 -> 直接修复）
- 现象：进入 AI Studio 被重定向到可用地区页面
- 直接原因：当前账号地区或年龄条件不满足。
- 直接修复：使用满足条件的账号/地区，或改走 Vertex AI 方案。
- 现象：多把 key 仍然很快触发限流
- 直接原因：速率限制按项目统计，不是按 key 统计。
- 直接修复：检查项目级速率限制与模型配额，必要时升级层级或拆分项目。
- 现象：Free Tier 可用但生产流量不稳定
- 直接原因：Free Tier 有更低额度和限制。
- 直接修复：迁移到 Paid Tier，并按项目监控配额。