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 데스크톱 계정을 추가합니다(제공업체에 따라 웹 로그인, 전화 인증, 자격 증명 붙여넣기 또는 로컬 세션 데이터 가져오기 수행). 게이트웨이는 해당 계정으로 인증하고, 요청을 공식 상위 서비스로 전달하며, 모든 것을 단일 OpenAI 호환 API(/v1/chat/completions, /v1/responses, /v1/messages, /v1/models)로 노출합니다. 자동 토큰 갱신, 속도 제한(429) 발생 시 다중 계정 간 로테이션, 계정별 프록시 설정 적용, 요청 통계 보고 기능을 처리합니다. 보안은 선택적 게이트웨이 키(기본적으로 차단)와 로그인 시 사람 확인을 통해 강화됩니다. Docker 버전은 웹 패널을 통해 동일한 기능을 제공하며 순수 헤드리스 모드에서도 실행할 수 있습니다.

대상 사용자

이미 AI 데스크톱 클라이언트를 구독 중이며, 별도의 API 크레딧을 구매하지 않고 프로그래밍 방식의 API 호출을 통해 해당 구독을 사용하려는 분들에게 적합합니다. 또한 여러 제공업체에 걸쳐 통합된 인터페이스를 원하거나 리버스 프록시 및 다중 제공업체 프로토콜 적응에 대해 배우고 싶은 개발자에게도 유용합니다. README에 명시된 바와 같이, 이 프로젝트는 개인적인 학습 및 연구용으로만 제공되며 상업적 용도, 재판매 또는 결제 우회용이 아님을 유의하십시오.

주요 특징

• 즉시 사용 가능한 OpenAI 호환성 — Chat, Responses, Messages 엔드포인트를 지원하며, base_url과 더미 API 키만 설정하면 됩니다.
• 17개의 내장 제공업체 — WorkBuddy, 小浣熊 (Raccoon), CatPaw, Qoder, Trae 등을 포함하며, 사용자 정의 제공업체도 지원합니다.
• 자동 자격 증명 갱신 — 토큰이 자동으로 갱신되며 만료된 자격 증명에 대한 일괄 갱신이 가능합니다.
• 다중 계정 로테이션 — 요청은 우선순위에 따라 대기열에 추가되고, 429 오류 발생 시 계정을 전환하며, 쿨다운 기간을 준수합니다.
• 계정별 아웃바운드 프록시 — 각 계정은 고유한 출구 IP를 가질 수 있으며, 게이트웨이는 공식 클라이언트를 모방하기 위해 아웃바운드 트래픽의 핑거프린트를 조정합니다.
• 포괄적인 보고서 — 요청 수, 성공률, 토큰 소비량, 캐시 적중률 및 365일 히트맵을 제공합니다.
• 예약 작업 — 자동 출석 체크, 자격 증명 유지 관리, 모델 목록 새로 고침을 한 페이지에서 관리할 수 있습니다.
• 잔액 및 사용량 추적 — 각 계정의 잔액과 사용량을 인라인으로 확인하고 여러 계정에 걸쳐 동시 쿼리를 수행할 수 있습니다.
• 두 가지 배포 모드 — 데스크톱 트레이 앱(Node 불필요)과 패널 및 게이트웨이에 동일한 포트를 사용하는 Docker 컨테이너를 제공하며, UI는 6개 언어를 지원합니다.