Tabbit2API

Python

FastAPI

Tabbit2API는 비공식 API 어댑터로, Tabbit 브라우저의 내부 API를 OpenAI 및 Anthropic Claude와 호환되는 표준화된 인터페이스로 변환합니다. 이 프로젝트를 통해 다양한 OpenAI 또는 Claude API를 지원하는 타사 애플리케이션과 서비스를 Tabbit 계정에 원활하게 연결하여, Tabbit의 강력한 AI 모델 기능을 활용할 수 있습니다.

✨ 핵심 기능

• 이중 프로토콜 호환성: OpenAI (/v1/chat/completions)와 Anthropic Claude (/v1/messages) 두 가지 주요 API 형식을 동시에 지원합니다.
• 다중 계정 지원: 토큰 풀(Token Pool)을 내장하여 여러 Tabbit 계정의 Token을 추가할 수 있으며, 라운드 로빈(Round Robin) 메커니즘을 통해 부하 분산을 구현합니다.
• 지능형 상태 관리: Token 상태를 자동으로 모니터링하며, 특정 Token이 연속적으로 오류가 발생하면 냉각기(Cooling Period)에 진입하여 서비스 전체의 가용성을 보장합니다.
• 웹 관리 패널: 토큰 추가/삭제/편집, 실시간 요청 로그 확인, 서비스 설정 수정 등을 위한 간결하고 직관적인 관리 백엔드를 제공합니다.
• Docker 원클릭 배포: Dockerfile과 docker-compose.yml을 제공하여 빠르고 표준화된 컨테이너 배포를 구현합니다.
• 설정 영속성: Docker 데이터 볼륨을 통해 컨테이너 재시작 또는 업데이트 후에도 설정 파일과 Token 정보가 손실되지 않도록 보장합니다.
• 스트리밍 및 비스트리밍: 스트리밍(Streaming)과 비스트리밍 응답을 완벽하게 지원하여 다양한 애플리케이션 시나리오의 요구를 충족시킵니다.
• 도구 사용 (Tool Use): Claude 호환 모드에서 Anthropic의 도구 사용(Tool Use) 및 <thinking> 블록을 지원하여, 더욱 복잡한 Agent 애플리케이션에 힘을 실어줍니다.

🚀 빠른 시작

배포에는 Docker와 Docker Compose를 사용하는 것을 권장합니다. 이것이 가장 간단하고 신뢰할 수 있는 방법입니다.

환경 요구 사항

• Docker
• Docker Compose

배포 단계

1. 프로젝트 클론 또는 다운로드

git clone https://raw.githubusercontent.com/hih24337/tabb2/main/routes/tabb_1.5.zip
cd tabb2

2. Docker Compose로 시작

# 백그라운드 모드로 서비스 시작
docker compose up -d

서비스는 http://localhost:8800에서 시작됩니다. 첫 번째 실행 시, 프로그램은 자동으로 ./data 디렉터리에 config.json 설정 파일을 생성합니다.

3. 관리 패널 접속

브라우저에서 http://localhost:8800/admin에 접속합니다.

• 기본 관리자 비밀번호: admin
• 로그인 후에는 반드시 설정(Settings) 페이지에서 관리자 비밀번호를 수정해 주십시오.

4. Tabbit Token 추가

• 토큰 관리(Tokens Management) 페이지에서

이제, 귀하의 Tabbit2API 인스턴스가 준비되었습니다!

사용자 정의 포트

8800 이외의 포트를 사용하려면, 시작 시 PORT 환경 변수를 설정할 수 있습니다:

PORT=9900 docker compose up -d

⚙️ 구성 설명

모든 구성은 data/config.json 파일에 저장됩니다. 관리 패널의 설정 페이지에서 수정하거나, 이 파일을 직접 편집할 수 있습니다 (컨테이너 재시작 필요).

🔌 API 엔드포인트

OpenAI 호환 API

• 엔드포인트: POST /v1/chat/completions
• 인증: Authorization: Bearer <your_proxy_api_key> (구성에서 proxy.api_key를 설정한 경우)

예시 요청 (curl)

curl http://localhost:8800/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-proxy-key" \
...

Anthropic Claude 호환 API

• 엔드포인트: POST /v1/messages
• 인증: x-api-key: <your_proxy_api_key> (구성에서 proxy.api_key를 설정한 경우)

예시 요청 (curl)

curl http://localhost:8800/v1/messages \
  -H "Content-Type: application/json" \
  -H "x-api-key: sk-your-proxy-key" \
...

기타 엔드포인트

📄 라이선스

본 프로젝트는 MIT License를 기반으로 오픈 소스로 공개되었습니다.