HanaokaYuzu/Gemini-API

✨ Reverse-engineered Python API for Google Gemini web app

What it solves

它提供了一种以程序方式与 Google Gemini 网页应用（前身为 Bard）互动的方式，通过逆向工程的异步 Python 包装器，使开发者能够在不依赖官方 API 的情况下使用 Gemini 的网页功能。

How it works

该库作为 Gemini 网页界面的包装层。它使用会话 Cookie（__Secure-1PSID 与 __Secure-1PSIDTS）进行身份验证，并利用 asyncio 实现异步客户端以发送请求和接收响应。它还包含后台机制，自动刷新 Cookie，以保持持久会话，适用于长期运行的服务。

Who it’s for

想将 Gemini 网页应用功能（如图像/视频/音频生成、深度研究和 Gemini Gems）整合到自己的应用或脚本中的 Python 开发者。

Highlights

  • Multimodal Capabilities: 支持生成和编辑图像，同时还能生成视频和音频/音乐内容。
  • Deep Research: 实现完整的工作流，包括计划创建、状态轮询和结果获取。
  • Gemini Gems Support: 允许应用、创建、更新和删除自定义系统提示（Gems）。
  • Extension Integration: 支持使用 Gemini 扩展，如 YouTube 和 Gmail。
  • Advanced Session Management: 具备持久 Cookie 并自动刷新，以及不将对话保存到历史记录的临时模式。
  • Developer‑Friendly: 包含 CLI 工具、实时响应的流式模式，以及受官方 Google Generative AI API 启发的接口。