pingmike2/freebuff2api-wokers

해결하는 문제

이 프로젝트는 freebuff/codebuff의 무료 AI 모델을 사용할 때의 번거로움을 제거합니다. 일반적으로 로그인 토큰을 관리하고, 일일 사용 제한(Freebucks)을 추적하며, 한도가 소진되면 계정을 직접 전환해야 합니다. 이 서비스는 이러한 무료 모델을 표준 OpenAI 호환 API로 래핑하므로, 모든 OpenAI 또는 Anthropic 클라이언트를 연결하기만 하면 복잡한 계정, 할당량 및 세션 관리를 자동으로 처리할 수 있습니다.

작동 방식

이 서비스는 OpenAI 스타일의 요청을 수락하는 경량 서버(의존성이 없는 단일 파일)로 실행됩니다. 백그라운드에서 freebuff 계정 풀을 유지합니다. 채팅 요청을 보내면 크레딧이 남아 있는 계정을 선택하고, 세션(약 1시간 지속)을 사용하여 무료 모델을 호출한 뒤 표준 형식으로 결과를 반환합니다. 또한 웹 관리 패널(/admin)이 포함되어 있어 계정 토큰 추가/삭제, 계정별 프록시 설정, 각 계정의 남은 Freebucks 확인, API 설정 조정을 수행할 수 있습니다. 모든 변경 사항은 재시작 없이 즉시 적용됩니다. OpenAI 및 Anthropic API 형식을 모두 지원하며, 가동 시간 모니터링을 위한 상태 확인 엔드포인트도 제공합니다.

대상 사용자

DeepSeek, Kimi, GLM 등과 같은 무료 AI 모델을 선호하는 OpenAI 호환 도구를 통해 사용하려는 개발자, 개인 사용자 또는 소규모 팀을 위한 것입니다. 계정 로테이션, 할당량 추적 및 API 게이트웨이를 직접 구축하고 유지 관리할 필요가 없습니다. 여러 무료 계정을 관리하여 일일 사용량을 늘리거나, 기존 클라이언트에 이러한 모델을 간단하게 노출하려는 경우 특히 유용합니다.

주요 특징

• Docker 또는 VPS에서 실행할 수 있는 의존성 없는 단일 파일 코드.
• 계정, 프록시, API 키를 관리하고 Freebucks 잔액을 실시간으로 확인할 수 있는 웹 관리 패널.
• 다중 계정 자동 전환: 계정이 일일 제한에 도달하면 자동으로 쿨다운 상태가 되고 다른 계정으로 전환됩니다.
• 스마트 세션 재사용: 세션은 약 1시간 동안 지속되며 크레딧 사용을 극대화하기 위해 동일한 계정에 고정됩니다.
• OpenAI (/v1/chat/completions) 및 Anthropic (/v1/messages) API 모두와 호환.
• 가동 시간 모니터링을 위한 상태 확인 엔드포인트.
• Docker 배포를 권장합니다. Cloudflare Worker 배포는 계정 정지 위험이 있으므로 권장하지 않습니다.