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 啟發的介面。