HanaokaYuzu/Gemini-API

✨ Reverse-engineered Python API for Google Gemini web app

解決的問題

本專案提供一個針對 Google Gemini 網頁應用的逆向工程非同步 Python 封裝，讓開發者無需使用官方 API，即可程式化地與 Gemini 的網頁功能互動。

作法原理

使用 asyncio 進行高效任務處理，並需透過瀏覽器 Cookie（__Secure-1PSID 與 __Secure-1PSIDTS）進行驗證。該套件會在背景自動更新這些 Cookie，以維持持續會話，適用於永續運作的服務。亦可透過 browser-cookie3 依賴自動從 Firefox 導入 Cookie。

適用對象

希望將 Gemini 的網頁應用功能（如 Gemini Gems、擴充功能、多模態生成等）整合至自身應用程式或 CLI 工具中的 Python 開發者。

主要特色

  • 多模態功能：支援圖像生成與編輯，以及影片與音訊/音樂內容的生成。
  • 深度研究：實作完整的流程，包含計畫建立、狀態輪詢與結果取得。
  • Gemini Gems：支援應用、建立、更新與刪除自訂系統提示（Gems）。
  • 擴充功能支援：可與 YouTube 及 Gmail 等 Gemini 擴充功能整合。
  • 進階會話管理：支援即時回應的串流模式、暫時聊天模式，以及取得模型思考過程的能力。
  • 持久化驗證：自動更新 Cookie，避免頻繁重新驗證。

相關

  • 專案
    zexadev/gemini-web2api-go

    一個 Go 伺服器，反向代理 Google Gemini 的網頁 UI 協定，並以 OpenAI 相容 API（聊天、模型、串流、影片、影像、音樂、網頁搜尋）形式公開。支援匿名或使用 Google Cookie，包含速率限制、代理與 Cookie 池、SQLite/MySQL 持久化，以及輕量級管理 UI。

  • 專案
    Sophomoresty/gemini-web2api

    gemini‑web2api 是一個 Python 伺服器，代理 Google Gemini 的私有網頁 API，並以 OpenAI 相容端點（`/v1/chat/completions`、`/v1/models` 等）呈現。它支援可選 API 金鑰驗證、串流、函數呼叫、影像輸入、多個 Gemini 模型別名、可調推理深度，並可直接執行或在 Docker 內執行。

  • 專案
    Nativu5/Gemini-FastAPI

    一個無需 API 金鑰、僅使用會話 Cookie 即可免費存取網頁版 Gemini 模型的 OpenAI 相容 API 封裝。

  • 專案
    zhiyu1998/Gemi2Api-Server

    Gemi2Api‑Server 是一個基於 FastAPI 的橋接工具，可讓您透過 OpenAI 兼容的 REST API 呼叫 Google Gemini。它使用您的瀏覽器 Cookie 進行認證，轉發聊天補全請求，可選地代理生成的圖片，並提供一個簡單的管理 UI。可本地部署、透過 Docker 或在 Render/HuggingFace 上部署，對希望在沒有正式公開 API 的情況下存取 Gemini 的開發者非常有用。

  • 專案
    googleapis/python-genai

    Google Gemini 生成式 AI 模型的 Python SDK，提供同步/非同步客戶端、類型安全的提示、函式呼叫、安全設定與企業功能。