Sub2API

Sub2API 是什麼？

Sub2API 是開源 AI API 網關平台，協助分配並管理 AI 產品訂閱的 API 配額。使用者無需直接整合上游 AI 服務，Sub2API 提供平台產生的 API 金鑰，並處理驗證、計費相關帳務、負載平衡與請求轉發。

此專案適用於需將多個上游帳戶彙整並透過單一一致網關提供的環境，包含多帳戶支援、配額感知排程，以及併發與速率限制控制等功能。

主要功能

• 上游連線的多帳戶管理（支援多種上游帳戶類型，如 OAuth 和 API Key），讓單一網關可服務多個上游帳戶。
• API 金鑰分發（為使用者產生並管理 API 金鑰），使用者向 Sub2API 驗證，而非管理多個上游憑證。
• Token 等級用量追蹤與成本計算，用於計費相關帳務的 token 等級追蹤與計算。
• 智慧排程與黏性會話，在多帳戶環境中智慧選擇上游帳戶，並維持會話路由穩定。
• 併發控制與可設定速率限制（每使用者與每帳戶併發限制；請求與 token 速率限制），防止過載並管理吞吐量。
• 管理後台儀表板，透過網頁介面進行監控與管理。
• 外部系統整合，使用 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 集中配額使用，透過單一網關服務使用者，並將請求分散至上游帳戶。
• 團隊配額分配：發給團隊成員個別 Sub2API API 金鑰，Sub2API 追蹤 token 等級用量、管理排程與限制。
• 限制管理吞吐量：設定每使用者與每帳戶併發限制，加上請求/token 速率限制，塑造負載並降低上游飽和風險。
• 運營可見性與管理：使用內建管理後台監控與管理網關，而非僅依賴上游供應商後台。
• 擴充內部工作流程：使用 iframe 將外部系統（例如付款或票務）嵌入管理後台，支援運營流程。

常見問題

• Sub2API 是否綁定特定網域？ 儲存庫指出 Sub2API 僅官方使用 sub2api.org 和 pincc.ai。其他使用 Sub2API 名稱的網站可能是第三方部署，與官方無關；使用者應自行驗證。

• 如何部署 Sub2API？ 專案文件記載兩種部署方式：透過腳本從 GitHub Releases 下載預建二進位檔安裝，或使用 Docker Compose 部署（包含 PostgreSQL 與 Redis 容器）。

• Sub2API 支援哪些上游帳戶？ 支援多種上游帳戶類型，包括 OAuth 和 API Key（如同功能清單所述）。

• 使用 Nginx 作為反向代理時該怎麼做？ README 指出，若搭配 Nginx 使用 Sub2API（或 CRS）與 Codex CLI，應在 http 區塊內加入 underscores_in_headers on;，因為 Nginx 預設捨棄含底線的標頭，這可能破壞多帳戶環境中的黏性會話路由。

替代方案

• 使用官方中繼服務 (PinCC)：如果不想自行託管 Sub2API，儲存庫指向基於 Sub2API 的官方中繼 PinCC，適合想立即使用而無需部署/維護的使用者。
• 使用自管 API 網關處理配額與路由：如果已有基礎設施，可尋找支援 API 金鑰、驗證、速率限制與請求轉發的網關/路由管理方案；不同於 Sub2API，它們可能不包含 token 等級用量追蹤與 AI 訂閱導向的配額分配。
• 建置自訂代理服務：可實作應用層代理，將請求路由至上游 AI 提供者並強制限制；相較 Sub2API，這通常需要更多工程工作來實現如 sticky sessions 與 token 等級計費等功能。
• 使用多租戶 API 管理方式：通用 API 管理平台可集中驗證與限流，但可能需額外自訂以匹配 Sub2API 的配額分配與基於 token 的用量計費流程。