已收錄264 則資訊/100 款 AI 工具/374 個開源專案/64 個學習資源
首頁資訊開源排行榜模型排行AI 工具學習資源
首頁 / 開源排行榜 / sub2api

sub2api

開源 Go 網關，將 Claude、OpenAI、Gemini 和 Grok 訂閱整合為統一且與 API 相容的端點。

GoLGPL-3.0Deploy & Inference
⭐ GitHubhttps://github.com/Wei-Shaw/sub2api
34,925
Star 數
+0
Star 增速
2026年7月29日
最後更新
4
點擊數

1. 專案概述

Sub2API 是一個基於 Go 語言的開源 API 網關，它將 Claude、OpenAI、Gemini、Grok 和 Antigravity 的訂閱服務整合為統一且與 OpenAI/Anthropic 相容的 API 端點，讓團隊能夠透過單一自託管服務來池化並管理共享的訂閱配額。

2. 背景與定位

個人 AI 訂閱方案（如 Claude Pro/Max、ChatGPT Plus、Gemini Advanced 等類似計劃）主要針對單用戶的瀏覽器使用進行定價，然而開發者越來越希望透過原生 CLI 工具和 SDK 獲得程式化存取權限。Sub2API 旨在彌合這一差距：它將一個或多個訂閱帳戶轉換為與 API 相容的網關，使團隊或社群能夠共享配額、追蹤每個 token 的使用情況，並在多個帳戶和供應商之間智慧地路由請求。

與主要轉發 API 金鑰流量的通用 LLM 代理或路由器專案相比，Sub2API 專注於基於訂閱的帳戶（經 OAuth 認證的消費者計劃），增加了帳戶池化、粘性會話排程以及內建的計費/支付基礎設施，使得共享存取可以作為小型託管服務運營，而非僅是個腳本。

3. 功能類別

🔑 帳戶與存取管理 — 4 項核心功能，例如 OAuth 帳戶綁定、API Key 帳戶綁定、動態 API key 發放、按 key 的生命週期控制。目的：從單一儀表板接入和管理多個上游訂閱帳戶及下游使用者金鑰。

⚖️ 排程與流量控制 — 4 項核心功能，例如智慧帳戶選擇、粘性會話、按使用者並行限制、按帳戶並行限制、可配置的請求/token 速率限制。目的：在池化帳戶間均勻分擔負載，同時保護每個帳戶免受上游節流或標記。

💳 計費與變現 — 4 項核心功能，例如 token 級別用量計量、內建支付整合（EasyPay、Alipay、WeChat Pay、Stripe）、自助充值、計費電路斷路器。目的：讓運營者能夠運行成本分摊或付費存取群組，並具備準確、可審計的用量核算。

🧩 多供應商路由 — 支援 5 個供應商：Claude (Anthropic)、OpenAI (包括 Codex)、Gemini (Google)、Grok/xAI 和 Antigravity (混合排程)。目的：在一致且熟悉的 API 形狀背後暴露異質的上游供應商。

🖥️ 管理儀表板與運維 — 4 項核心功能，例如 Vue 3 Web 控制台、即時監控、Codex CLI 的 WebSocket 入口管理、非同步圖像任務輪詢。目的：讓運營者無需日常接觸命令列即可擁有可見性和控制權。

4. 關鍵亮點

  • 訂閱池化（「拼車」） — 將多個 Claude/OpenAI/Gemini/Grok 帳戶合併到一個網關中，以便在團隊或使用者群體中共享配額成本。
  • 原生工具相容性 — 設計初衷是讓現有基於 Anthropic/OpenAI 風格 API 構建的 CLI 工具和 SDK 幾乎不需要更改即可運作。
  • 精確至 token 的計費 — 每個請求都以 token 級別進行計量，實現公平的成本分配和隨用隨付的充值。
  • 粘性會話智慧排程 — 在需要時將對話固定在同一個上游帳戶上，避免在多輪工具會話中丟失上下文。
  • 組合供應商群組 — 將單一邏輯模型端點路由到多個供應商或帳戶，以實現冗餘和負載平衡。
  • 多種部署路徑 — 一行安裝腳本、Docker Compose、Apple Container (macOS/Apple Silicon) 或從原始碼構建，涵蓋快速試用和生產環境部署。

5. 角色用例

  • 一般開發者：透過一個一致的 API 端點和 API key 存取 Claude、OpenAI、Gemini 和 Grok，無需為每個供應商切換不同的 SDK 或憑證。
  • DevOps/SRE：透過 Docker Compose 部署 PostgreSQL 和 Redis，配置速率限制、受信任的代理和電路斷路器，以確保共享網關在高負載下保持穩定。
  • 社群/團隊運營者：在群組內攤分訂閱成本，發行個別 API key，並使用內建的支付整合來管理共享或付費存取。
  • 專案經理：使用管理儀表板監控組織內的用量、支出和帳戶健康狀況，無需工程支援即可進行常規監督。

6. 快速開始

尋找所需內容 — 從儲存庫 README（英文和中文）以及 deploy/README.md 開始，獲取特定於部署的指導：

git clone https://github.com/Wei-Shaw/sub2api.git

安裝/整合 — 最快的路徑是使用 Linux 的一行安裝腳本：

curl -sSL https://raw.githubusercontent.com/Wei-Shaw/sub2api/main/deploy/install.sh | sudo bash

或使用 Docker Compose 進行完全容器化的設置（包含 PostgreSQL 和 Redis）：

mkdir -p sub2api-deploy && cd sub2api-deploy
curl -sSL https://raw.githubusercontent.com/Wei-Shaw/sub2api/main/deploy/docker-deploy.sh | bash
docker compose up -d

貢獻 — fork 儲存庫，向 main 分支開啟 pull request，並使用 GitHub Issues 報告錯誤或提出功能建議：

gh repo fork Wei-Shaw/sub2api --clone

7. 專案結構

sub2api/
├── backend/     # Go 服務：配置、模型、請求處理程序、供應商網關邏輯
├── frontend/    # Vue 3 + Vite + TailwindCSS 管理儀表板
├── deploy/      # Docker Compose 文件、env 模板、安裝/升級腳本
└── openspec/    # 暴露的網關端點的 OpenAPI 規範
  • backend/cmd/server — Go 二進位檔案的主要入口點。
  • deploy/install.sh / deploy/docker-deploy.sh — 用於基於腳本和 Docker 部署的一行安裝程式。
  • frontend/ — 用於帳戶、key、計費和監控管理的 Web 控制台。

8. 相關生態系統

  • 上游依賴項：後端使用 Go 1.25.7 搭配 Gin Web 框架和 Ent ORM；前端使用 Vue 3.4+、Vite 5+ 和 TailwindCSS；後端使用 PostgreSQL 15+ 進行存儲，Redis 7+ 進行快取和隊列。
  • 上游訂閱供應商：Anthropic (Claude)、OpenAI (包括 Codex)、Google (Gemini) 和 xAI (Grok) — Sub2API 位於這些供應商之前作為網關，而非取代它們。
  • 配套專案：sub2api-mobile，一個跨平台的手機管理控制台，用於隨時管理已部署的實例。

9. 許可證

Sub2API 根據 GNU 寬通用公共許可證 v3.0 (LGPL-3.0) 發布。

  • ✅ 免費使用、學習和修改原始碼，包括用於內部或教育目的。
  • ✅ 免費自託管用於個人或團隊使用，包括在私人群組內共享訂閱成本。
  • ❌ 專案明確聲明未授權任何個人或組織將其作為商業服務運營。
  • ℹ️ 使用 Sub2API 存取上游供應商可能與這些供應商自身的服務條款衝突；維護者描述該專案旨在用於技術學習和研究目的，運營者需自行負責合規性和帳戶風險。

10. 常見問題

問：Sub2API 支援哪些 AI 供應商？
答：Claude (Anthropic)、OpenAI (包括 Codex)、Gemini (Google)、Grok/xAI 和 Antigravity，統一在相容的 API 端點之後。請參閱 README 獲取最新列表。

問：嘗試它的最佳方式是什麼？
答：使用 Docker Compose 快速入門，它會自動配置 PostgreSQL 和 Redis 以及網關：

curl -sSL https://raw.githubusercontent.com/Wei-Shaw/sub2api/main/deploy/docker-deploy.sh | bash

問：在我的訂閱帳戶上運行 Sub2API 是否違反供應商的規則？
答：維護者指出這可能與上游供應商的服務條款衝突，並對帳戶封禁免責；部署前請查閱 README 中的許可證和免責聲明。

問：我可以使用 Sub2API 為他人運行付費服務嗎？
答：該專案內建了支付整合（EasyPay、Alipay、WeChat Pay、Stripe）以用於群組內部的成本分摊，但維護者尚未授權該專案本身的商業運營 — 請先檢查許可證條款。

問：我在哪裡報告錯誤或請求功能？
答：通過主儲存庫上的 GitHub Issues。

11. 快速連結

12. 總結

Sub2API 將分散的 AI 訂閱帳戶轉變為單一、可管理、與 API 相容的網關，具備 token 級別計費、智慧排程和完整的管理儀表板。它最適合那些希望共享訂閱成本並透過一致介面存取 Claude、OpenAI、Gemini 和 Grok 的開發者和小型團隊，前提是他們在部署前仔細審查上游服務條款和許可證影響。