Gemini-API

项目简介

Gemini-API 是面向 Google Gemini 网页版（原 Bard）的逆向工程异步 Python 封装。它提供灵感来自 Google Generative AI 官方 API 的简洁接口，并支持异步生成、流式输出、多轮对话、媒体输出、Gemini Gems、扩展和深度研究。

核心功能

• 后台自动刷新持久化 Cookie，适合常驻服务。
• 原生支持用自然语言生成和编辑图像，并支持视频与音频/音乐生成。
• 提供完整深度研究工作流，包括创建计划、轮询状态和获取结果。
• 通过 Gemini Gems 支持自定义系统提示词，并支持 YouTube、Gmail 等 Gemini 扩展。
• 对文本、思考过程、图像、视频和音频进行分类输出，并支持流式返回部分结果。
• 提供异步客户端和独立 CLI，便于快速交互。

适用场景

• 构建需要自动刷新 Cookie 的常驻服务和聊天机器人。
• 开发具备历史记录处理和流式响应的多轮对话应用。
• 通过自然语言提示生成并保存图像、视频和音频。
• 运行深度研究工作流并获取结构化结果。

快速开始

• 使用 pip 安装或更新软件包：pip install -U gemini_webapi
• 如需从本地 Firefox 浏览器导入 Cookie，可安装浏览器支持：pip install -U gemini_webapi[browser]
• 登录 Gemini，复制 __Secure-1PSID 和 __Secure-1PSIDTS 的 Cookie 值，初始化 GeminiClient，并按所需超时与刷新设置调用 init。

部署与要求

• 需要 Python 3.11 或更高版本。
• 需要有效的 Gemini 网页 Cookie（__Secure-1PSID 和 __Secure-1PSIDTS），除非使用 browser-cookie3 导入 Cookie。
• 可选的 browser-cookie3 依赖用于自动导入 Cookie；目前仅支持 Firefox。
• 在容器化部署中，将 GEMINI_COOKIE_PATH 设置为可写路径，以持久化自动刷新的 Cookie。

采用前须知

• 许可证：AGPL-3.0。在使用、修改或分发项目前，请确认其具体条款。