HanaokaYuzu/Gemini-API

✨ Reverse-engineered Python API for Google Gemini web app

何を解決するか

このプロジェクトは、Google Gemini Webアプリ用の逆エンジニアリングされた非同期Pythonラッパーを提供し、公式APIを使用せずに、GeminiのWebベースの機能をプログラムで操作できるようにします。

動作方法

asyncio を使用して効率的なタスク処理を行い、ブラウザのクッキー（__Secure-1PSID および __Secure-1PSIDTS）による認証を必要とします。ライブラリはバックグラウンドでこれらのクッキーを自動的に更新し、常に稼働するサービスの永続セッションを維持します。また、browser-cookie3 依存関係を介してFirefoxからクッキーを自動的にインポートすることもできます。

対象ユーザー

GeminiのWebアプリ機能（Gemini Gems、拡張機能、マルチモーダル生成など）を自作アプリやCLIツールに統合したいPython開発者。

主な特徴

  • マルチモーダル機能: 画像の生成・編集、および動画・音声/音楽コンテンツの生成をサポート。
  • 詳細なリサーチ: プラン作成、ステータスポーリング、結果取得の完全なワークフローを実装。
  • Gemini Gems: カスタムシステムプロンプト（Gems）の適用、作成、更新、削除を可能に。
  • 拡張機能サポート: YouTubeやGmailなどのGemini拡張機能と統合。
  • 高度なセッション管理: 実時間応答用のストリーミングモード、一時的なチャットモード、モデルの思考プロセスの取得をサポート。
  • 永続的認証: クッキーを自動的に更新し、頻繁な再認証を回避。

関連

  • プロジェクト
    zexadev/gemini-web2api-go

    Google GeminiのWeb UIプロトコルを逆プロキシするGoサーバーで、OpenAI互換API（チャット、モデル、ストリーミング、動画、画像、音楽、Web検索）として公開。匿名またはGoogle Cookie付きで動作可能。レート制限、プロキシおよびCookieプール、SQLite/MySQL永続化、軽量な管理UIを備える。

  • プロジェクト
    Sophomoresty/gemini-web2api

    gemini‑web2api は、Google Gemini のプライベート Web API をプロキシし、OpenAI 互換エンドポイント（`/v1/chat/completions`、`/v1/models` など）として提供する Python サーバーです。オプションの API キー認証、ストリーミング、関数呼び出し、画像入力、複数の Gemini モデルエイリアス、調整可能な思考深度をサポートし、直接実行または Docker 内で実行可能です。

  • プロジェクト
    Nativu5/Gemini-FastAPI

    API キーではなくセッションクッキーを使用して、無料でウェブベースの Gemini モデルにアクセスできる、OpenAI 互換の API ラッパー。

  • プロジェクト
    zhiyu1998/Gemi2Api-Server

    Gemi2Api‑Serverは、FastAPIベースのブリッジで、OpenAI互換のREST APIを介してGoogle Geminiを呼び出すことができます。ブラウザのクッキーを使ってGeminiに認証し、チャットコンプリーションリクエストを転送し、オプションで生成された画像をプロキシし、シンプルな管理UIを提供します。ローカル、Docker、またはRender/HuggingFaceでデプロイ可能で、公式な公開APIがなくてもGeminiにアクセスしたい開発者に有用です。

  • プロジェクト
    googleapis/python-genai

    Google Gemini生成AIモデル用のPython SDK。同期/非同期クライアント、型安全なプロンプト、関数呼び出し、セーフティ設定、エンタープライズ機能を提供します。