justlovemaki/AIClient2API

해결하는 문제

AIClient2API는 클라이언트 전용 사용으로 제한된 무료 대규모 모델(Gemini CLI, Grok, Codex, Kiro 등)을 표준 OpenAI 호환 인터페이스로 변환하는 API 프록시 서비스입니다. 이를 통해 사용자는 클라이언트 제한을 우회하여 Cherry-Studio, NextChat, Cline과 같이 OpenAI API 사양을 지원하는 모든 애플리케이션에서 이러한 고급 모델을 사용할 수 있습니다.

작동 방식

Node.js 기반으로 구축된 이 프로젝트는 전략 및 어댑터 패턴을 사용하는 모듈형 아키텍처를 사용하여 클라이언트 요청을 시뮬레이션하고 이를 로컬 API로 캡슐화합니다. Cloudflare 403 차단을 우회하기 위한 내장 TLS Sidecar(Go uTLS)를 특징으로 하며, OpenAI, Claude, Gemini 프로토콜 간의 지능형 변환을 지원합니다. 높은 가용성을 보장하기 위해 멀티 계정 폴링, 자동 장애 조치 및 상태 확인을 위한 계정 풀 관리자가 포함되어 있습니다.

대상 사용자

클라이언트 전용 인터페이스를 활용하여 고급 모델(Claude Opus 또는 Gemini Pro 등)에 무료 또는 저렴한 비용으로 액세스하려는 개발자 및 AI 애호가, 그리고 여러 AI 제공업체를 한 곳에서 관리할 수 있는 통합 API 게이트웨이가 필요한 사용자를 위해 설계되었습니다.

주요 특징

• 통합 인터페이스: Gemini, Claude, Grok, Codex 등의 모델에 대해 단일 OpenAI 호환 엔드포인트를 제공합니다.
• 클라이언트 우회: OAuth 인증 및 TLS 핑거프린트 시뮬레이션을 사용하여 속도 제한 및 공식 제한을 돌파합니다.
• 계정 풀 관리: 멀티 계정 폴링 및 자동 성능 저하(degradation)를 지원하여 99.9%의 서비스 가용성을 유지합니다。
• Web UI 콘솔: 실시간 구성, 상태 모니터링 및 API 테스트를 위한 관리 인터페이스를 포함합니다。
• 에이전트 준비 완료: 특화된 스킬 가이드를 통해 OpenClaw 및 Claude Code와 같은 AI 에이전트와의 상호 작용을 기본적으로 지원합니다.