Skip to content

GEMINI_API_SETUP.md

Latest commit

 

History

History
114 lines (81 loc) · 2.88 KB

GEMINI_API_SETUP.md

File metadata and controls

114 lines (81 loc) · 2.88 KB
Raw

Gemini API 配置指南

为什么更换为 Gemini API？

系统已从 OpenRouter 的 Llama 模型切换到 Google Gemini 2.0 Flash，原因如下：

  • ✅ 完全免费：Google AI Studio 提供免费的 API 额度
  • ✅ 高性能：Gemini 2.0 Flash 是最新最快的模型
  • ✅ 大额度：每分钟 15 次请求，每天 1500 次请求
  • ✅ 无需信用卡：只需 Google 账号即可使用

获取免费 Gemini API Key

步骤 1: 访问 Google AI Studio

打开浏览器，访问：

https://aistudio.google.com/apikey

步骤 2: 登录 Google 账号

  • 使用你的 Google 账号登录
  • 如果没有账号，免费注册一个

步骤 3: 创建 API Key

  1. 点击 "Create API Key" 按钮
  2. 选择一个 Google Cloud 项目（或创建新项目）
  3. 系统会生成一个 API Key，类似：AIzaSyA...
  4. 点击 复制 按钮保存你的 API Key

步骤 4: 配置到项目

打开文件：D:\py project\COC_Alter\coc_agent.py

找到第 22 行：

GEMINI_API_KEY = "AIzaSyDummyKeyPleaseReplaceWithYourOwnKey"

替换为你的真实 API Key：

GEMINI_API_KEY = "AIzaSyA你的真实Key..."  # 粘贴你复制的Key

保存文件。

配置完成！

重新启动你的 CoC 守秘人服务：

# 启动后端API服务
cd "D:\py project\COC_Alter"
python coc_apiagent.py

你应该会看到以下输出：

[AI] 正在预热Gemini API连接...
[AI] Gemini API连接预热成功
[SUCCESS] Agent logic core loaded successfully! (Using Gemini 2.0 Flash)

免费额度说明

Gemini 2.0 Flash 免费配额：

  • 每分钟：15 次请求
  • 每天：1500 次请求
  • 每次请求：最多 32,000 tokens

对于个人使用或测试，这个额度完全足够！

常见问题

Q1: API Key 不工作怎么办？

  • 确认 Key 复制完整，没有多余空格
  • 检查 Google AI Studio 中 API 是否启用
  • 确认没有超过免费额度限制

Q2: 需要绑定信用卡吗？

  • 不需要！Gemini API 的免费额度无需绑定支付方式

Q3: API Key 安全吗？

  • 不要将 API Key 提交到公开的 Git 仓库
  • 不要分享给他人
  • 如果泄露，立即在 Google AI Studio 中删除并重新创建

Q4: 如果超过免费额度怎么办？

  • 系统会返回 429 错误（请求过多）
  • 等待额度重置（每分钟或每天）
  • 或升级到付费计划（可选）

技术细节

使用的模型

  • 模型名称：gemini-2.0-flash-exp
  • API 格式：OpenAI 兼容格式
  • Base URL：https://generativelanguage.googleapis.com/v1beta/openai/

代码变更

修改了以下文件：

  • coc_agent.py - 核心 Agent 逻辑
  • coc_apiagent.py - API 服务器

获取帮助

如果遇到问题：

  1. 查看终端输出的错误信息
  2. 访问 Google AI Studio 文档：https://ai.google.dev/
  3. 检查 API Key 是否正确配置

祝你游戏愉快！🎲