Claude, OpenAI, Gemini, Grok의 구독(Subscription)을 하나의 API 키로 통합해 버리는 오픈소스 프로젝트가 GitHub에서 존재감을 드러내고 있다.

월 정액 결제 방식의 AI 서비스를 여러 개 계약하고 있는 개발자는 적지 않다. 그 '구독'을 'API'로 변환하여, 여러 명이 함께 이용함으로써 비용을 분담하는 메커니즘을 내세우는 Sub2API는 편리함과 동시에 취급에 주의가 필요한 성격을 가진 프로젝트이기도 하다.

TL;DR

• 개발자는 Wei-Shaw 씨(GitHub 계정명)
• 만든 것은 Claude, OpenAI, Gemini, Grok 등 여러 AI 서비스의 구독/API 접속을 하나의 게이트웨이(Gateway)로 통합하여 API 키로 발급하는 중계 서비스
• 본질은 '구독 권한을 API 쿼터(Quota)로 취급하여, 여러 사용자가 분배 및 사용량 기반 과금을 하는' 발상의 전환에 있음
• GitHub상에서 3만~3.4만 스타 규모까지 성장하였으며, 여러 포크(Fork) 및 파생 프로젝트가 생겨나고 있음
• 주의사항으로, 각 AI 서비스의 이용 약관(개인용 구독의 공유·전매 금지 조항 등)과의 정합성에는 의문이 있으며, 이용은 자기 책임의 판단이 강력하게 요구됨

계기는 무엇인가

Sub2API의 배경에 있는 것은 특정 발언이라기보다, AI 서비스의 '구독 과금'과 '종량제 과금 API'라는 두 가지 요금 체계 사이에 존재하는 격차이다. 많은 개발자는 Claude Pro나 Max와 같은 월 정액 고정 플랜으로 인간용 채팅 이용 비용을 억제하면서, Claude Code나 Cursor와 같은 도구로부터는 API 키를 통해 종량제 과금을 지불하는 이중 구조에 직면해 있다.

Sub2API는 플랫폼이 발행하는 API 키를 통해 상류(Upstream)의 AI 서비스에 액세스할 수 있도록 하며, 인증·과금·부하 분산·요청 전송을 플랫폼 측에서 처리하는 AI API 게이트웨이이다. 이를 통해 구독 계약 하나를 여러 명·여러 도구에서 공유할 수 있도록 한다는 착상으로 만들어졌다.

개념 해설

한마디로 말하면, Sub2API는 '개인용 구독을 여러 명이 사용할 수 있는 API 엔드포인트(Endpoint)로 변환하는 중계 레이어(Layer)'이다.

Before/After로 정리하면 다음과 같다.

Before: Sub2API 없음

After: Sub2API 있음

구성 요소·요소 분해

멀티 계정 관리— OAuth·API 키 등 여러 종류의 상류 계정을 통합 관리하는 계층 -
API 키 발급— 이용자별로 플랫폼이 발행하는 API 키를 생성·관리하는 메커니즘 -
정밀 과금— 토큰 단위의 이용량 트래킹과 비용 계산 -
스마트 스케줄링— 스티키 세션(Sticky Session)을 고려한 지능적인 계정 선택 로직 -
동시 실행 제어— 사용자 단위·계정 단위의 동시 요청 수 제한 -
관리 대시보드— 모니터링·관리를 위한 Web 인터페이스

실전 도구·구현 예시 소개

도입은 Docker Hub(docker pull weishaw/sub2api)
)
또는 GitHub Container Registry를 통한 Docker 이미지, 혹은 GitHub Releases로부터의 바이너리 다운로드로 수행할 수 있다. Claude, OpenAI, Gemini, Grok, 나아가 Google의 Antigravity 계정에도 대응하고 있으며, Claude Code·Codex CLI와 같은 네이티브 도구에서 그대로 접속할 수 있다는 점을 특징으로 내세우고 있다. README 자체도 일본어판(README_JA.md)이 준비되어 있어, 국제적인 이용을 상정한 구조로 되어 있다.

주의사항

• 각 AI 서비스의 이용 약관상, 개인용 구독(Subscription) 계정의 공유·재배포·전매가 어디까지 허용되는지는 서비스 제공 기업마다 규정이 다르며, 본 기사 작성 시점에서 Anthropic이나 OpenAI 등이 이러한 종류의 도구를 명시적으로 허가 또는 금지했다는 1차 정보는 확인되지 않았다. 이용을 검토할 경우, 각 서비스의 이용 약관을 반드시 스스로 확인할 필요가 있다.
• OAuth 토큰이나 인증 정보를 제3자의 중계 서버에 맡기게 되므로, 보안 및 프라이버시상의 리스크는 이용자 본인이 부담해야 한다.
• 공식 도메인 이외에 「Sub2API」를 자처하는 사이트 및 파생 프로젝트가 복수 존재하며, 본가와의 관계성은 이용자 측에서 확인할 필요가 있다.
• 스타(Star) 수나 개발 상태는 급격히 변화하고 있으며, 본 기사의 수치는 작성 시점의 스냅샷에 불과하다

요약

• Sub2API는 여러 AI 서비스의 구독(Subscription)을 API 게이트웨이(API Gateway)로서 통합하여, 여러 명이 함께 이용할 수 있도록 하는 오픈 소스(Open Source) 프로젝트이다.
• 본질은 「구독 권한을 API 쿼터(Quota)로서 분배 및 정밀 과금한다」는 발상의 전환이다.
• 멀티 계정 관리·API 키 발행·정밀 과금·스마트 스케줄링(Smart Scheduling) 등이 주요 구성 요소이다.
• 공식 도메인은 한정되어 있으며, 난립하는 비공식 포크(Fork)와는 구별하여 다룰 필요가 있다.
• 각 서비스의 이용 약관과의 정합성에 대해서는 1차 정보로 명확한 확인이 이루어지지 않았으므로, 이용 시에는 자기 책임 하의 판단이 요구된다.

참고 링크

Discussion