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만 지정하면 됩니다.
다중 모델 지원	하나의 구성으로 수십 개의 모델(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