aimod-cc/Agent2API

解決する課題

Agent2APIは、複数のAIデスクトップクライアントのログインセッションを、ローカルのOpenAI互換APIゲートウェイに変換します。個別のAPIキーに料金を支払う代わりに、AIデスクトップアプリ（WorkBuddy, Trae, Qoderなど）で既に利用可能なモデルのクォータを、単一の標準エンドポイントを通じて再利用できます。カスタムの base_url をサポートするクライアントであれば、http://127.0.0.1:3065/v1 に向けるだけで、上流のAPIキーやクライアントの修正なしに、これらのアカウントのモデルを呼び出すことができます。

仕組み

Agent2APIをインストール（デスクトップトレイアプリまたはDocker経由）します。初回起動時にポート3065でローカルゲートウェイが立ち上がり、管理パネルが開きます。パネルからAIデスクトップアカウントを追加します（プロバイダーに応じて、Webログイン、電話認証、資格情報の貼り付け、またはローカルセッションデータのインポートを行います）。ゲートウェイはそれらのアカウントとして認証を行い、リクエストを公式の上流サービスに転送し、すべてを単一のOpenAI互換API（/v1/chat/completions, /v1/responses, /v1/messages, /v1/models）として公開します。自動トークン更新、レート制限 (429) 時の複数アカウント間ローテーション、アカウントごとのプロキシ設定、リクエスト統計のレポート機能を提供します。セキュリティはオプションのゲートウェイキー（デフォルトでフェイルクローズ）とログイン時の人間による検証によって強化されています。Docker版はWebパネル経由で同じ機能を提供し、純粋なヘッドレスモードでも実行可能です。

対象ユーザー

既にAIデスクトップクライアントをサブスクライブしており、個別にAPIクレジットを購入することなく、プログラムによるAPI呼び出しでそれらのサブスクリプションを利用したい方。また、多くのプロバイダー間で統一されたインターフェースを求める開発者や、リバースプロキシおよびマルチプロバイダーのプロトコル適応について学びたい方に適しています。READMEに明記されている通り、本プロジェクトは個人的な学習および研究目的専用であり、商用利用、再販、または課金の回避を目的としたものではありません。

主な特徴

• すぐに使えるOpenAI互換性 — Chat, Responses, Messagesエンドポイントをサポート。base_urlとダミーのAPIキーを設定するだけです。
• 17種類の組み込みプロバイダー — WorkBuddy, 小浣熊 (Raccoon), CatPaw, Qoder, Traeなどを含み、カスタムプロバイダーもサポートしています。
• 自動資格情報更新 — トークンは自動的に更新され、期限切れの資格情報の一括更新も可能です。
• マルチアカウントローテーション — リクエストは優先順位に従ってキューに入れられ、429エラー時にアカウントを切り替え、クールダウン期間を遵守します。
• アカウントごとのアウトバウンドプロキシ — 各アカウントに個別の出口IPを設定でき、ゲートウェイは公式クライアントを模倣するためにアウトバウンドトラフィックのフィンガープリントを調整します。
• 包括的なレポート — リクエスト数、成功率、トークン消費量、キャッシュヒット率、365日間のヒートマップを表示します。
• スケジュールタスク — 自動チェックイン、資格情報のメンテナンス、モデルリストの更新を1つのページから管理できます。
• 残高と使用量の追跡 — 各アカウントの残高と使用量をインラインで確認でき、複数アカウントにわたる同時クエリも可能です。
• 2つのデプロイモード — デスクトップトレイアプリ（Node不要）と、パネルとゲートウェイで同じポートを使用するDockerコンテナを提供。UIは6言語に対応しています。