Sub2API

Sub2API란?

Sub2API는 AI 제품 구독의 API 쿼터를 분배·관리하는 오픈소스 AI API 게이트웨이 플랫폼입니다. 각 사용자가 업스트림 AI 서비스에 직접 통합하는 대신, Sub2API가 인증, 청구 관련 회계, 로드 밸런싱, 요청 전달을 처리하며 플랫폼 생성 API 키를 제공합니다.

이 프로젝트는 여러 업스트림 계정을 하나의 일관된 게이트웨이를 통해 풀링·서비스하는 설정을 위해 설계되었으며, 다중 계정 지원, 쿼터 인식 스케줄링, 동시성 및 속도 제한 제어 등의 기능을 포함합니다.

주요 기능

• 업스트림 연결을 위한 다중 계정 관리 (OAuth 및 API 키 등 여러 업스트림 계정 유형 지원), 하나의 게이트웨이가 여러 업스트림 계정을 서비스할 수 있게 합니다.
• API 키 분배 (사용자를 위한 API 키 생성·관리), 사용자가 여러 업스트림 자격 증명을 관리하는 대신 Sub2API에 인증합니다.
• 토큰 수준 사용량 추적 및 비용 계산, 청구 관련 회계를 위해 토큰 수준에서 사용량을 추적·계산합니다.
• 스티키 세션과 함께하는 스마트 스케줄링, 다중 계정 환경에서 세션 라우팅을 안정적으로 유지하며 업스트림 계정을 지능적으로 선택합니다.
• 동시성 제어 및 구성 가능한 속도 제한 (사용자별·계정별 동시성 제한; 요청 및 토큰 속도 제한), 과부하 방지와 처리량 관리를 위해 사용합니다.
• 웹 인터페이스를 통한 모니터링 및 관리용 관리자 대시보드.
• iframe을 사용한 관리자 대시보드 확장용 외부 시스템 통합 (예: 결제 또는 티켓팅 시스템 임베드).

Sub2API 사용 방법

1. 셀프 호스팅할지 공식 릴레이 서비스를 사용할지 결정하세요. 리포지토리에서 셀프 호스팅을 원하지 않는 사용자용 공식 릴레이인 PinCC를 언급합니다.
2. 셀프 호스팅 시 PostgreSQL 15+와 Redis 7+가 있는 Linux 서버 (amd64 또는 arm64)에 Sub2API를 설치합니다.
3. 리포지토리의 원클릭 스크립트를 사용해 설치한 후 서비스를 시작하고 부팅 시 활성화합니다.
4. 브라우저에서 설정 마법사를 열어 (README에서 http://YOUR_SERVER_IP:8080 참조) 데이터베이스/Redis 설정을 구성하고 관리자 계정을 생성합니다.
5. 관리자 대시보드에서 설정 및 사용자 API 키를 관리합니다; 사용자는 Sub2API에서 발급된 API 키를 사용해 플랫폼을 통해 업스트림 AI 서비스를 호출합니다.

사용 사례

• 여러 업스트림 구독 계정 풀링: 쿼터 사용을 중앙화하고 요청을 업스트림 계정에 분배하면서 단일 게이트웨이를 통해 사용자에게 서비스합니다.
• 팀을 위한 쿼터 분배: 팀원에게 개별 Sub2API API 키를 제공하며 Sub2API가 토큰 수준 사용량 추적, 스케줄링 및 제한을 관리합니다.
• 제한을 통한 처리량 관리: 사용자별·계정별 동시성 제한과 요청/토큰 속도 제한을 구성해 로드를 조정하고 업스트림 포화 가능성을 줄입니다.
• 운영 가시성 및 관리: 업스트림 제공자 대시보드에만 의존하지 않고 내장 관리자 대시보드를 사용해 게이트웨이를 모니터링·관리합니다.
• 내부 워크플로 확장: iframe을 사용해 외부 시스템 (결제 또는 티켓팅 등)을 관리자 대시보드에 임베드하여 운영 프로세스를 지원합니다.

자주 묻는 질문

• Sub2API는 특정 도메인에 묶여 있나요? 리포지토리에서 Sub2API는 공식적으로 sub2api.org와 pincc.ai만 사용한다고 명시합니다. Sub2API 이름을 사용하는 다른 사이트는 제3자 배포일 수 있으며 비공식입니다; 사용자는 독립적으로 확인하세요.

• Sub2API를 어떻게 배포하나요? 프로젝트 문서에서 두 가지 배포 방법을 설명합니다: GitHub Releases에서 사전 빌드 바이너리를 다운로드하는 스크립트 설치, 또는 Docker Compose를 사용한 배포 (PostgreSQL 및 Redis 컨테이너 포함).

• Sub2API가 지원하는 업스트림 계정은? 기능 목록에 명시된 대로 OAuth 및 API 키를 포함한 여러 업스트림 계정 유형을 지원합니다.

• Nginx를 리버스 프록시로 사용할 때 어떻게 하나요? README에서 Nginx를 Sub2API (또는 CRS) 및 Codex CLI와 함께 사용할 경우 http 블록 안에 underscores_in_headers on;을 추가하라고 안내합니다. Nginx가 기본적으로 언더스코어를 포함한 헤더를 삭제하기 때문에 다중 계정 설정에서 스티키 세션 라우팅이 깨질 수 있습니다.

대안

• 공식 릴레이 서비스 사용 (PinCC): Sub2API를 직접 호스팅하고 싶지 않다면, 저장소에서 Sub2API 기반의 공식 릴레이인 PinCC를 가리키며, 배포/유지보수 없이 즉시 사용할 수 있는 사용자용입니다.
• 쿼터 및 라우팅용 자체 관리 API 게이트웨이 사용: 이미 인프라를 운영 중이라면 API 키, 인증, 속도 제한, 요청 전달을 지원하는 게이트웨이/라우트 관리 솔루션을 찾을 수 있습니다. Sub2API와 달리 토큰 수준 사용량 추적과 AI 구독 지향 쿼터 분배가 없을 수 있습니다.
• 맞춤 프록시 서비스 구축: 업스트림 AI 제공자에 요청을 라우팅하고 제한을 적용하는 애플리케이션 계층 프록시를 구현할 수 있습니다. Sub2API에 비해 스티키 세션과 토큰 수준 회계 같은 기능에 더 많은 엔지니어링 작업이 필요합니다.
• 멀티 테넌트 API 관리 접근 방식 사용: 범용 API 관리 플랫폼은 인증과 스로틀링을 중앙화할 수 있지만, Sub2API의 쿼터 분배와 토큰 기반 사용량 회계 워크플로우에 맞추려면 추가 맞춤화가 필요할 수 있습니다.