su-kaka/agy2api

해결하는 문제

이 프로젝트는 표준 API 클라이언트 도구와 함께 Google의 Antigravity 플랫폼(Claude 및 Gemini와 같은 모델에 대한 액세스 제공)을 사용하는 문제를 해결합니다. 많은 개발자가 OpenAI, Gemini, Claude API에 익숙하지만 Antigravity는 이러한 형식을 기본적으로 제공하지 않습니다. AGY2API는 Antigravity를 이 세 가지 API 스타일의 드롭인 대체품으로 변환하므로 기존 코드와 클라이언트를 다시 작성하지 않고도 사용할 수 있습니다.

작동 방식

AGY2API는 로컬 서버(기본 포트 7861)로 실행되며 OpenAI, Gemini 또는 Claude 형식의 요청을 수락하고 Antigravity API 호출로 변환한 후 응답을 스트리밍합니다. 여러 Google OAuth 자격 증명을 관리하고 부하 분산을 위해 자동으로 순환합니다. 시스템은 HTTP 429(속도 제한)와 같은 오류를 모니터링하고 문제가 있는 자격 증명을 일시적으로 비활성화합니다. 또한 자동 모델 이름 매핑, 민감한 단어 필터링, 요청 로깅, IP 화이트리스트와 같은 기능을 제공합니다. 웹 제어판을 사용하면 Antigravity로 인증하고, 자격 증명을 업로드하거나 내보내고, 설정을 구성할 수 있습니다. 자격 증명은 기본적으로 SQLite에 저장되며, 구성된 경우 PostgreSQL에 저장됩니다.

대상 사용자

익숙한 API 인터페이스를 통해 Antigravity의 모델 선택(Claude, Gemini 등)을 활용하려는 개발자와 사용자. Windows, Linux, macOS, Termux 또는 Docker에서 자체 호스팅 서비스를 실행하는 사용자에게 적합하며, 특히 여러 자격 증명 순환 및 관리를 지원하는 통합 게이트웨이를 원하는 경우에 적합합니다.

주요 기능

• 다중 형식 엔드포인트 – 하나의 서비스에서 OpenAI /v1/chat/completions, Gemini 네이티브 generateContent, Claude /v1/messages를 지원합니다.
• 지능형 자격 증명 풀 – Google OAuth 자격 증명을 자동으로 순환하고, 속도 제한 대기 시간을 처리하며, 실패한 자격 증명을 비활성화합니다.
• 스트리밍 및 잘림 방지 – 실시간 SSE 스트리밍과 선택적 "잘림 방지" 모드(모델 이름 앞에 抗截断- 접두사)를 통해 합성 도구 호출을 사용하여 응답 잘림을 방지합니다.
• 웹 관리 콘솔 – OAuth 로그인, 자격 증명 업로드/내보내기, 일괄 작업 및 시스템 구성을 위한 React 기반 UI.
• 유연한 배포 – Termux, Windows, Linux, macOS 및 Docker용 원클릭 설치 프로그램과 다중 인스턴스 설정을 위한 선택적 PostgreSQL 및 Redis 지원.