Self-hosted multi-protocol AI API proxy for Antigravity, Codex, Grok, Kiro, OpenAI, Claude, and custom providers. Supports OpenAI-compatible API, Claude API, Gemini protocol conversion, GPT, Grok Build, Claude Opus, Gemini Pro, Kimi, MiniMax, provider pools, smart routing, and automatic failover.

AIClient2API (A2) – クライアント専用LLM APIの統合プロキシ

概要 – Node.jsベースのサーバーで、アプリケーションと様々な「クライアント専用」大規模モデルサービス（Google Gemini、Antigravity、Codex、xAI Grok、Kiro、Claudeなど）の間に位置します。これらのサービスの独自のリクエスト/レスポンス形式を標準のOpenAI REST APIに変換し、OpenAI互換のツール（Cherry-Studio、NextChat、Clineなど）が通常のOpenAIエンドポイントと同じように呼び出せるようにします。

コアコンセプト

機能	重要性
OpenAI互換インターフェース	既存ツールのコード変更は不要で、プロキシURLを指定するだけです。
マルチモデル対応	1つの設定で多数のモデル（Gemini、Claude、Grok、Codex、Kiro、MiniMaxなど）にアクセスできます。
戦略/アダプターアーキテクチャ	各プロバイダーには、プロバイダーのネイティブプロトコルとOpenAIスキーマ間の変換方法を知る専用のアダプターがあります。
アカウントプールとフェイルオーバー	複数の資格情報をロードでき、プロキシがローテーション、失敗時の再試行、段階的な劣化を行い、約99.9%の稼働率を達成します。
TLSフィンガープリント偽装	組み込みのGo uTLSサイドカーが実際のブラウザを模倣し、自動呼び出しを妨げるCloudflare/403ブロックを回避します。
エージェントファースト設計	AIエージェント（OpenClaw、Hermes、Claude Code）が「スキル」ファイルを介してサービスを自動検出するためのフックを提供します。
全チェーンロギング	すべてのリクエストとレスポンスが記録され、監査、デバッグ、プライベートデータセットの作成が可能です。

仕組み（高レベルフロー）

クライアントリクエスト – アプリは通常のOpenAIスタイルのHTTPリクエスト（例：POST /v1/chat/completions）を送信します。
ルーター – プロキシはパスとmodelフィールドを調べ、使用するプロバイダーアダプターを決定します。
アダプター – 選択されたアダプターは：
- ターゲットサービスに認証（OAuth、クッキー、APIキー）します。
- OpenAI JSONペイロードをプロバイダーのネイティブ形式に変換します。
- リクエストを送信します（多くの場合、TLS偽装接続を介して）。
レスポンス処理 – プロバイダーの応答はOpenAI JSONに変換されます（サポートされている場合はストリーミングdataイベントを含む）。
ロギングとヘルスチェック – すべてのトラフィックが記録され、ヘルスチェックエンドポイントがプロバイダーの可用性を監視し、必要に応じてアカウントをローテーションします。

始め方

ステップ	コマンド/アクション
Dockerで実行	`docker run -d -p 8080:8080 -v /my/configs:/app/configs justlikemaki/aiclient-2-api`
プロバイダーの設定	`configs/provider_pools.json`（サンプルファイル提供）を編集して、公開したい各モデルの資格情報をリストします。
ツールをポイント	APIベースURLを`http://localhost:8080/v1`（またはサーバーのアドレス）に設定します。
オプションのUI	ウェブコンソール（2025年11月追加）で、ヘルスステータス、ログ、モデルのリアルタイム切り替えを表示できます。

注目の最近のアップデート（2026年）

Grok Buildサポート – xAI GrokのOAuthフロー、マルチモーダル生成、組み込みツール（ウェブ検索、コードインタープリター、ファイル添付）を含む。
Deep AI統合 – 自動生成された/api/helpおよび/api/exampleエンドポイントにより、AIエージェントが50以上のAPIルートの全セットを発見できます。
画像生成 – 完全なOpenAI /v1/images/generationsおよび/v1/images/editsの各プロバイダーのネイティブ画像APIへの変換。
プロバイダープールマネージャー – 非同期リフレッシュキュー、重複排除、グローバル同時実行制限、自動トークン有効期限処理。

誰が使うのか？

開発者 – OpenAI APIを中心にツールを構築しているが、ブラウザ専用クライアントに制限されている、より安価または無料のモデルを利用したい開発者。
チーム – 多くのLLMベンダーに単一のエンドポイントが必要なチーム（例：顧客が統合コードを書き直さずにClaude、Gemini、Grokを選択できるようにしたいSaaS）。
AIエージェント – 提供された「スキル」ファイルをロードしてプロキシを自動的に呼び出す方法を学習できるAIエージェント。

ライセンスとコミュニティ

GPL-v3 – ソースコードはオープンで、貢献を歓迎します。
Docker Hub – 100k以上のプルがある事前構築イメージ。
ドキュメント – 多言語（EN、ZH、JA）で、https://aiproxy.justlikemaki.vip/en/に完全なオンラインガイドがあります。
サポート – このプロキシのユーザーに割引コードを提供するいくつかのAPIリレーサービス（PackyCode、RunningHub、AxisNowなど）が後援しています。

TL;DR

AIClient2APIは、認証、プロトコル変換、アカウントプーリング、TLSフィンガープリント偽装まで処理し、「クライアント専用」のLLMサービスを標準のOpenAI互換APIに変換するNode.jsプロキシです。OpenAI対応アプリケーションは、コード変更なしでGemini、Claude、Grok、Codexなどのモデルを使用でき、ログ、ヘルスモニタリング、エージェント向けスキルファイルを提供します。

justlovemaki/AIClient2API