Sub2API: Nền tảng trung chuyển API cho Claude, OpenAI, Gemini

• Thông tin tổng quan
• sub2api là gì?
• Tính năng chính
• Yêu cầu phần cứng & hệ thống
• Cách cài đặt và sử dụng
• Phù hợp với ai?
• Ứng dụng thực tế
• Đánh giá của danhbaai.com
• Câu hỏi thường gặp

Chi phí subscription các dịch vụ AI hàng đầu như Claude Pro, ChatGPT Plus hay Gemini Advanced không hề rẻ — đặc biệt khi bạn cần nhiều tài khoản cho cả team. Sub2API ra đời để giải quyết bài toán này: biến mỗi subscription thành một API endpoint chuẩn, từ đó nhiều người có thể cùng sử dụng, phân bổ quota hợp lý và tiết kiệm chi phí đáng kể.

Với hơn 37.000 star và gần 7.700 fork, Sub2API đang là một trong những dự án “2API” (subscription-to-API) được cộng đồng developer quan tâm nhất. Bài viết này sẽ phân tích chi tiết Sub2API làm gì, phù hợp với ai, và những điều bạn cần cân nhắc trước khi triển khai.

Thông tin tổng quan

sub2api là gì?

Sub2API (viết tắt của Subscription to API) là một nền tảng gateway mã nguồn mở, cho phép bạn lấy quota từ các subscription trả phí của Claude, OpenAI, Gemini, Grok rồi phân phối lại dưới dạng API tương thích chuẩn OpenAI. Nói đơn giản: bạn có một tài khoản Claude Pro, thay vì chỉ một người dùng qua giao diện web, Sub2API giúp nhiều người cùng gọi API từ tài khoản đó — mỗi người được phân bổ một phần quota nhất định.

Dự án ra đời trong bối cảnh cộng đồng developer Trung Quốc và châu Á rất phổ biến mô hình “拼车” (ghép xe/chia sẻ subscription). Thay vì mỗi người trả $20/tháng cho Claude Pro, một nhóm 5 người có thể chia nhau chi phí thông qua Sub2API. Backend viết bằng Go đảm bảo hiệu năng cao, frontend Vue 3 cung cấp giao diện quản trị trực quan, kết hợp PostgreSQL và Redis cho lưu trữ và caching.

Lưu ý quan trọng: Chính README của dự án cảnh báo rằng việc sử dụng có thể vi phạm điều khoản dịch vụ (ToS) của Anthropic và các provider khác. Người dùng cần tự chịu rủi ro bị khóa tài khoản.

Tính năng chính

• Đa provider, một API — Hỗ trợ Claude, OpenAI, Gemini, Grok cùng lúc. Tất cả đều được chuẩn hóa về format API tương thích OpenAI, giúp các tool như Claude Code, Codex, Gemini CLI kết nối trực tiếp.
• Phân bổ quota (拼车/Carpooling) — Tính năng cốt lõi: chia subscription cho nhiều người dùng, mỗi người có giới hạn riêng. Quản trị viên kiểm soát được ai dùng bao nhiêu token.
• Giao diện quản trị web — Dashboard Vue 3 cho phép quản lý tài khoản upstream, người dùng, API key, theo dõi usage realtime mà không cần thao tác command line.
• Smart routing & load balancing — Tự động phân luồng request đến các tài khoản upstream khác nhau, hỗ trợ failover khi một tài khoản bị rate limit hoặc lỗi.
• Docker-ready — Triển khai nhanh bằng Docker Compose với PostgreSQL và Redis đi kèm, phù hợp cả VPS nhỏ lẫn hạ tầng production.
• Tương thích native tool — Hoạt động liền mạch với Claude Code, OpenAI Codex CLI, Gemini CLI và các client tương thích OpenAI API format.
• Cập nhật liên tục — Đã ra tới v0.1.176 với tần suất release rất cao, cho thấy dự án được maintain tích cực bởi cộng đồng 337 contributor.
• Đa ngôn ngữ — README có tiếng Anh, tiếng Trung, tiếng Nhật. Giao diện hỗ trợ i18n.

Yêu cầu phần cứng & hệ thống

Cách cài đặt và sử dụng

Cách nhanh nhất là dùng Docker Compose. Dựa trên stack công nghệ của dự án, các bước triển khai cơ bản như sau:

Bước 1: Clone repo về máy:
git clone https://github.com/Wei-Shaw/sub2api.git
cd sub2api

Bước 2: Cấu hình file environment (thường là .env hoặc config.yaml) — thiết lập thông tin PostgreSQL, Redis, port, và các tài khoản upstream.

Bước 3: Khởi chạy bằng Docker Compose:
docker compose up -d

Bước 4: Truy cập giao diện quản trị web qua trình duyệt (mặc định thường là port 3000 hoặc 8080), thêm tài khoản subscription upstream và tạo API key cho người dùng.

Lưu ý: README chính không cung cấp hướng dẫn cài đặt chi tiết từng bước. Người dùng nên tham khảo thêm Wiki hoặc issues trên GitHub để biết cấu hình cụ thể.

Phù hợp với ai?

Ứng dụng thực tế

• Team dev chia sẻ Claude Pro: Nhóm 5 developer ghép chung 1-2 subscription Claude Pro, mỗi người nhận API key riêng với quota được phân bổ, tiết kiệm tới 60-80% chi phí.
• Tích hợp Claude Code / Codex CLI: Dùng Sub2API làm endpoint trung gian cho Claude Code hoặc OpenAI Codex, giúp các tool coding AI hoạt động ổn định với load balancing giữa nhiều tài khoản.
• Startup nhỏ quản lý chi phí AI: Thay vì mua nhiều subscription riêng lẻ, startup dùng Sub2API để tập trung quản lý, theo dõi usage và kiểm soát ngân sách AI.
• Xây dựng dịch vụ API relay: Một số người dùng Sub2API để xây dựng dịch vụ bán lại API với giá rẻ hơn official — tuy nhiên cần lưu ý rủi ro pháp lý và ToS.
• Nghiên cứu và học tập: Tìm hiểu cách xây dựng API gateway, reverse proxy cho AI service, load balancing và quota management.

Đánh giá của danhbaai.com

Sub2API giải quyết một nhu cầu rất thực tế: chi phí subscription AI quá cao cho cá nhân và team nhỏ. Với hơn 37.000 star, 337 contributor và tần suất release cực kỳ dày (176 phiên bản trong chưa đầy 8 tháng), đây rõ ràng là dự án được cộng đồng đón nhận mạnh mẽ. Kiến trúc Go + Vue + PostgreSQL + Redis cho thấy đây là một sản phẩm được thiết kế nghiêm túc, không phải script tạm bợ.

Tuy nhiên, điểm yếu lớn nhất nằm ở rủi ro ToS — chính dự án cũng thừa nhận điều này ngay đầu README. Anthropic và OpenAI có thể khóa tài khoản bất cứ lúc nào nếu phát hiện sử dụng không đúng quy định. Ngoài ra, tài liệu hướng dẫn cài đặt và sử dụng trong README khá sơ sài — phần lớn nội dung README dành cho disclaimer và sponsor, khiến người mới khó tiếp cận.

So với các giải pháp tương tự như One API hay New API, Sub2API nổi bật ở khả năng tập trung vào mô hình “carpooling” subscription và tích hợp native với các coding tool. Nếu bạn chấp nhận rủi ro ToS và có kiến thức kỹ thuật để tự triển khai, Sub2API là lựa chọn mạnh mẽ và tiết kiệm đáng kể.

Câu hỏi thường gặp

Nguồn: github.com/Wei-Shaw/sub2api — Bài phân tích bởi danhbaai.com.