su-kaka/agy2api

解決する問題

このプロジェクトは、標準的な API クライアントツールで Google の Antigravity プラットフォーム（Claude や Gemini などのモデルへのアクセスを提供）を使用する際の問題を解決します。多くの開発者は OpenAI、Gemini、Claude API に精通していますが、Antigravity はこれらの形式をネイティブに提供していません。AGY2API は Antigravity をこれら 3 つの API スタイルのドロップイン代替品に変換するため、既存のコードやクライアントを書き直すことなく使用できます。

仕組み

AGY2API はローカルサーバー（デフォルトポート 7861）として実行され、OpenAI、Gemini、または Claude 形式のリクエストを受け付け、Antigravity API 呼び出しに変換し、レスポンスをストリーミングで返します。複数の Google OAuth 認証情報を管理し、負荷分散のために自動的にローテーションします。システムは HTTP 429（レート制限）などのエラーを監視し、問題のある認証情報を一時的に無効にします。また、自動モデル名マッピング、機密ワードフィルタリング、リクエストロギング、IP ホワイトリストなどの機能も提供します。Web コントロールパネルでは、Antigravity での認証、認証情報のアップロード/エクスポート、設定の構成が可能です。認証情報はデフォルトで SQLite に保存され、設定されている場合は PostgreSQL に保存されます。

対象者

使い慣れた API インターフェースを通じて Antigravity のモデル選択（Claude、Gemini など）を活用したい開発者とユーザー。Windows、Linux、macOS、Termux、または Docker でセルフホストサービスを実行している人に適しており、特に複数の認証情報のローテーションと管理をサポートする統合ゲートウェイを希望する場合に適しています。

ハイライト

• マルチフォーマットエンドポイント – 1 つのサービスで OpenAI /v1/chat/completions、Gemini ネイティブ generateContent、Claude /v1/messages をサポート。
• インテリジェント認証情報プール – Google OAuth 認証情報を自動ローテーションし、レート制限のクールダウンを処理し、失敗したものを無効にします。
• ストリーミングと切断防止 – リアルタイム SSE ストリーミングに加え、オプションの「切断防止」モード（モデル名の前に 抗截断- を付ける）で、合成ツール呼び出しを使用して応答の切断を回避します。
• Web 管理コンソール – OAuth ログイン、認証情報のアップロード/エクスポート、バッチ操作、システム設定のための React ベースの UI。
• 柔軟なデプロイ – Termux、Windows、Linux、macOS、Docker 向けのワンクリックインストーラー。マルチインスタンス設定用に PostgreSQL と Redis をオプションでサポート。