ntthanh2603/gemini-web-to-api

解決する問題

通常、Google Gemini のモデルをプログラムで使用するには、公式の API キーと割り当てが必要です。このプロジェクトは、Gemini のウェブインターフェース（ブラウザで使用するチャットボット）をローカル API サーバーに変換することで、その障壁を取り除きます。ブラウザの Cookie を設定に貼り付けるだけで、サーバーが認証とセッション管理を処理するため、API キーなしで自分のコードから Gemini を呼び出すことができます。

仕組み

サーバーはローカルで実行され（デフォルトポート 4981）、ブラウザがすでに送信している batchexecute リクエストを使用して Gemini のウェブバックエンドと通信します。ログインしたブラウザセッションから Cookie ヘッダーを抽出し、リクエストの認証に使用します。サーバーは Cookie を定期的にローテーションしてセッションを維持し、ブロックを回避します。OpenAI 互換（/openai/v1）、Claude 互換（/claude）、Gemini ネイティブ（/gemini）の 3 つの API スタイルを公開します。モデル名はアカウントの Gemini Web モデルレジストリから動的に検出されるため、コードを変更せずに新しいモデルが利用可能になります。また、同じインターフェースを通じて、画像生成、画像入力、動画生成、Canvas ドキュメント、音楽生成もサポートしています。

対象者

API キーなしで Gemini の最新モデル上にアプリケーションを構築したい開発者、またはローカルで Gemini 統合をテストしたい開発者向けです。Cookie ベースの認証を使用したプロトタイピングにも役立ちます。複数の API 形式を提供するため、既存の OpenAI、Claude、Gemini SDK のドロップイン代替として機能します。

ハイライト

• API キー不要 — ブラウザの Cookie のみ
• 単一のサーバーで OpenAI、Claude、Gemini API プロトコルをサポート
• Gemini Web のレジストリからの動的モデル検出（例: gemini-auto、gemini-3.6-flash）
• チャットを超えて: 画像生成、画像入力、動画生成、Canvas ファイル、音楽生成
• Go と Fiber で構築され、高性能で、Docker と Docker Compose をサポート
• レート制限、Cookie ローテーション、セッション管理を含み、ブロックを回避
• Scalar UI による /docs のインタラクティブな API ドキュメント