Gemini-API

环境要求

• Python 3.11 或更高版本
• 可访问 gemini.google.com 的 Google 账号
• 已从浏览器导出 Gemini 站点 Cookie 并保存为 JSON 文件
• 可选：需要自动导入浏览器 Cookie 时使用 Firefox 浏览器

安装与启动步骤

1. 1确认 Python 版本

   Gemini-API 明确要求 Python 3.11 及以上，版本过低会安装或运行失败。

   python --version

   复制

2. 2安装 gemini_webapi

   用 pip 安装或更新主包，这是使用本库的最基本一步。

   pip install -U gemini_webapi

   复制

3. 3可选装浏览器支持

   如需从本地浏览器自动导入 Cookie，安装带 browser 额外依赖的版本，目前仅支持 Firefox。

   pip install -U gemini_webapi[browser]

   复制

4. 4导出并保存 Cookie

   从 gemini.google.com 导出 Cookie，保存为 JSON 文件，键名与值需对应，也支持浏览器插件导出的数组格式。

5. 5配置日志等级

   通过 set_log_level 调整日志级别，可选 DEBUG、INFO、WARNING、ERROR、CRITICAL，默认 INFO。

   from gemini_webapi import set_log_level
   
   set_log_level("DEBUG")

   复制

6. 6运行账户诊断

   用 CLI 指定 Cookie 文件执行 inspect，可查看账户状态、配额、用量限制和可用模型。

   python cli.py --cookies-json cookies.json inspect

   复制

关键配置

如何确认成功

执行 python cli.py --cookies-json cookies.json inspect 后能正常输出账户状态、配额与可用模型列表，说明安装与登录配置成功。

常见问题

注意事项

• 本项目是逆向工程实现的非官方封装，接口可能随 Google 页面变动而失效。
• 需要自备有效 Gemini 账号 Cookie，Cookie 等同登录凭证，请勿泄露或提交到公开仓库。
• 首次调用 set_log_level 会全局移除已有的 loguru handler，如需更精细控制可直接配置 loguru。