Business Gemini Pool — Gemini Enterprise アカウント輪替プール
概要
Business Gemini Pool は、Google Gemini Enterprise(Business)アカウントを複数運用し、API プロキシ経由で外部クライアントに OpenAI 互換インターフェースを提供する管理システムです。Flask を用いた軽量なサーバ(gemini.py)と、ブラウザベースの管理コンソール(index.html)、およびアカウント設定を保存する business_gemini_session.json で構成されます。主な目的は、複数アカウントの輪替(順番に使う)や障害時のリトライ、ログや設定の管理を容易にし、既存の OpenAI API クライアントをほぼ変更せずに Gemini を利用できるようにすることです。開発用途や小規模運用のプロトタイプに向きます。
リポジトリの統計情報
- スター数: 5
- フォーク数: 4
- ウォッチャー数: 5
- コミット数: 2
- ファイル数: 5
- メインの言語: HTML
主な特徴
- Flask ベースのシンプルなプロキシサーバで Gemini Enterprise API を中継
- 複数アカウントの輪替(プール)機能によりリクエスト分散と冗長化を実現
- OpenAI 互換のエンドポイントを提供し、既存クライアントとの互換性を確保
- ブラウザで操作できる管理コンソール(index.html)で設定・状態を確認可能
技術的なポイント
本プロジェクトはシンプルさを重視した設計で、gemini.py がバックエンドの中核を担い、Flask を用いて HTTP API を公開します。最も注目すべき点は「複数アカウントの輪替ロジック」と「OpenAI 互換レイヤー」です。輪替ロジックは、リクエストごとに business_gemini_session.json に定義されたアカウントリストから順次アカウントを選択し、一定の条件(レート制限、エラー発生など)で次のアカウントへ切り替える実装を想定しています。これにより単一キーの過負荷や利用停止に対するフェイルオーバーを実現できます。
OpenAI 互換エンドポイントは、クライアント側が既に OpenAI の API 呼び出し(/v1/chat/completions など)を行っているケースを想定し、受け取ったリクエストを Gemini Enterprise の API 仕様にマッピングして転送する機能を提供します。リクエスト/レスポンスの変換、ヘッダ管理、認証トークンの差し替えなどを行い、クライアントはほとんど変更不要で Gemini を利用できます。
管理コンソール(index.html)はフロントエンドとして、現在のアカウントプールの状態、各アカウントの利用状況、エラーログや簡易設定の編集を行うための UI を備えます。設定は business_gemini_session.json に保存され、サーバ起動時に読み込まれます。構成ファイルを変更することでアカウントの追加・削除、優先度設定、最大同時接続数などを調整できます。
セキュリティ面ではローカルあるいは閉域での運用を想定しているためシンプルなパターンだが、本番に移す場合は HTTPS、アクセス制御、認証、ログ保護、トークン暗号化(環境変数やシークレットマネージャーの利用)が必要です。スケーリングは単一プロセスでは限界があるため、コンテナ化してリバースプロキシ(NGINX)やロードバランサーと組み合わせる、あるいはプロセスごとにアカウントプールを分割することが考えられます。なお、Gemini 側の利用規約やビジネス契約に沿った運用を行う点も重要です。
(ここまでで技術的な説明は 700字程度を想定しています)
プロジェクトの構成
主要なファイルとディレクトリ:
- .DS_Store: file
- README.md: file
- business_gemini_session.json: file
- gemini.py: file
- index.html: file
使い方(概要)
- business_gemini_session.json に Gemini Enterprise アカウント情報やプール設定を記述する。
- gemini.py を実行して Flask サーバを起動する(デフォルトはローカルホストの指定ポート)。
- クライアントからは OpenAI 互換エンドポイント(例:/v1/chat/completions)へリクエストを送るだけで、サーバ側が適切な Gemini アカウントに中継する。
- index.html の管理画面でプール状態やログを確認、必要に応じ設定を更新する。
サンプルの curl コマンド(README 抜粋)に従えば、既存の ChatGPT 互換クライアントからの呼び出しで動作確認が可能です。
運用上の注意点
- セキュリティ:API トークンの保護、TLS 経由での通信、管理画面への認証を推奨
- レート制限:Gemini 側のレート制限や料金体系の把握が必要
- ロギング:エラーと利用統計を記録し、輪替ポリシーの調整に利用する
- 合規性:商用利用の場合は Gemini Enterprise の利用規約を確認
まとめ
シンプルで実用的な Gemini Enterprise 用のアカウントプールと OpenAI 互換プロキシ。小規模運用や検証環境に最適。
リポジトリ情報:
- 名前: business-gemini-pool
- 説明: Gemini Enterprise Business 版 账号轮训池(提供OpenAPI接口服务)
- スター数: 5
- 言語: HTML
- URL: https://github.com/ddcat666/business-gemini-pool
- オーナー: ddcat666
- アバター: https://avatars.githubusercontent.com/u/26564566?v=4
READMEの抜粋:
Business Gemini Pool 管理系统
一个基于 Flask 的 Google Gemini Enterprise API 代理服务,支持多账号轮训、OpenAI 兼容接口和 Web 管理控制台。
项目结构
/
├── gemini.py # 后端服务主程序
├── index.html # Web 管理控制台前端
├── business_gemini_session.json # 配置文件
└── README.md # 项目文档
快速请求
发送聊天请求
curl --location --request POST 'http://127.0.0.1:8000/v1/chat/completions' \
--header 'Content-Type: application/json' \
--data-raw '{
"model": "gemini-enterpri...