Erfasst:264 News/100 KI-Tools/374 Open-Source-Projekte/64 Lernressourcen
StartNewsOpen SourceModelleKI-ToolsLernen
Start / Open Source / sub2api

sub2api

Open-Source Go-Gateway, das Claude-, OpenAI-, Gemini- und Grok-Abonnements zu einheitlichen, API-kompatiblen Endpunkten zusammenführt.

GoLGPL-3.0Deploy & Inference
⭐ GitHubhttps://github.com/Wei-Shaw/sub2api
34,925
Stars
+0
Star-Wachstum
29. Juli 2026
Zuletzt aktualisiert
4
Klicks

1. Projektübersicht

Sub2API ist ein quelloffener, auf Go basierender API-Gateway, der Claude-, OpenAI-, Gemini-, Grok- und Antigravity-Abonnements zu einheitlichen, OpenAI/Anthropic-kompatiblen API-Endpunkten konsolidiert. Dies ermöglicht es Teams, gemeinsam genutzte Abonnement-Kontingente über einen einzigen, selbst gehosteten Dienst zu bündeln und zu verwalten.

2. Hintergrund & Positionierung

Individuelle KI-Abonnements (Claude Pro/Max, ChatGPT Plus, Gemini Advanced und ähnliche Pläne) sind für die einzelne Nutzung im Browser ausgelegt, doch Entwickler wünschen zunehmend programmatischen Zugriff über native CLI-Tools und SDKs. Sub2API wurde entwickelt, um diese Lücke zu schließen: Es verwandelt ein oder mehrere Abonnementkonten in ein API-kompatibles Gateway, sodass ein Team oder eine Community Kontingente teilen, die Nutzung pro Token verfolgen und Anfragen intelligent zwischen Konten und Anbietern routen kann.

Im Gegensatz zu allgemeinen LLM-Proxy- oder Router-Projekten, die hauptsächlich API-Schlüssel-Traffic weiterleiten, konzentriert sich Sub2API speziell auf abonnementbasierte Konten (OAuth-authentifizierte Consumer-Pläne). Es fügt Funktionen wie Account-Pooling, Sticky-Session-Scheduling und integrierte Abrechnungs-/Zahlungsmodi hinzu, damit der gemeinsame Zugang als kleiner gehosteter Dienst und nicht nur als persönliches Skript betrieben werden kann.

3. Feature-Kategorien

🔑 Konto- & Zugriffsverwaltung — 4 Kernfunktionen, z. B. OAuth-Kontobindung, API-Schlüssel-Kontobindung, dynamische Ausstellung von API-Schlüsseln, Lebenszyklussteuerung pro Schlüssel. Zweck: Onboarding und Verwaltung vieler Upstream-Abonnementkonten sowie Downstream-Nutzerschlüssel über ein einziges Dashboard.

⚖️ Scheduling & Traffic-Steuerung — 4 Kernfunktionen, z. B. intelligente Kontoauswahl, Sticky Sessions, nutzerspezifischeConcurrency-Limits, kontospezifische Concurrency-Limits, konfigurierbare Request-/Token-Ratenlimits. Zweck: Last gleichmäßig auf gepoolte Konten verteilen und jedes Konto davor schützen, upstream gedrosselt oder flaggt zu werden.

💳 Abrechnung & Monetarisierung — 4 Kernfunktionen, z. B. Token-genaue Nutzungsabrechnung, integrierte Zahlungsanbindungen (EasyPay, Alipay, WeChat Pay, Stripe), Self-Service-Aufladung, Billing-Circuit-Breaker. Zweck: Betreibern ermöglichen, Kosten-Sharing-Gruppen oder bezahlte Zugriffsgruppen mit genauer, prüfbarer Nutzungsabrechnung zu betreiben.

🧩 Multi-Provider-Routing — 5 unterstützte Anbieter: Claude (Anthropic), OpenAI (inklusive Codex), Gemini (Google), Grok/xAI und Antigravity (hybrides Scheduling). Zweck: Heterogene Upstream-Anbieter hinter konsistenten, vertrauten API-Strukturen verfügbar machen.

🖥️ Admin-Dashboard & Betrieb — 4 Kernfunktionen, z. B. Vue 3 Web-Konsole, Echtzeit-Monitoring, WebSocket-Ingress-Management für Codex CLI, asynchrones Polling von Bildaufträgen. Zweck: Operatoren Sichtbarkeit und Kontrolle geben, ohne täglich die Kommandozeile nutzen zu müssen.

4. Key Highlights

  • Subscription Pooling („Carpooling“) — Kombinieren mehrerer Claude/OpenAI/Gemini/Grok-Konten zu einem Gateway, sodass die Kontingentkosten über ein Team oder eine Nutzerbasis geteilt werden können.
  • Native Tool-Kompatibilität — Entwickelt, damit bestehende CLI-Tools und SDKs, die auf Anthropic/OpenAI-ähnliche APIs ausgelegt sind, mit minimalen oder keinen Änderungen funktionieren.
  • Token-genaue Abrechnung — Jede Anfrage wird auf Token-Ebene gemessen, was eine faire Kostenverteilung und Pay-as-you-go-Aufladungen ermöglicht.
  • Sticky-Session Smart Scheduling — Hält eine Konversation bei Bedarf an dasselbe Upstream-Konto gebunden, um Kontextverluste über Multi-Turn-Tool-Sessions hinweg zu vermeiden.
  • Composite Provider Groups — Routen eines einzelnen logischen Modellendpunkts über mehrere Anbieter oder Konten hinweg für Redundanz und Lastausgleich.
  • Mehrere Deployment-Pfade — One-Line-Installations-Skript, Docker Compose, Apple Container (macOS/Apple Silicon) oder Build-from-Source, deckt sowohl schnelle Tests als auch Produktionsrollouts ab.

5. Use Cases nach Rolle

  • Allgemeine Entwickler: Zugriff auf Claude, OpenAI, Gemini und Grok über einen konsistenten API-Endpunkt und API-Schlüssel, ohne separate SDKs oder Anmeldeinformationen für jeden Anbieter verwalten zu müssen.
  • DevOps/SRE: Deployment via Docker Compose mit PostgreSQL und Redis, Konfiguration von Ratenlimits, vertrauenswürdigen Proxies und Circuit Breakern, um ein gemeinsames Gateway unter Last stabil zu halten.
  • Community-/Team-Betreiber: Bündelung von Abonnementkosten in einer Gruppe, Ausgabe individueller API-Schlüssel und Nutzung der integrierten Zahlungsanbindungen zur Verwaltung von gemeinsamem oder bezahltem Zugang.
  • Projektmanager: Nutzung des Admin-Dashboards zur Überwachung von Nutzung, Ausgaben und Kontogundheit innerhalb einer Organisation, ohne für routinemäßige Kontrollen Engineering-Unterstützung zu benötigen.

6. Erste Schritte

Finden Sie, was Sie brauchen — Beginnen Sie mit dem Repository README (Englisch und 中文) sowie der deploy/README.md für deployment-spezifische Anleitungen:

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

Installation / Integration — Der schnellste Weg ist das One-Line-Installations-Skript für Linux:

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

od Docker Compose für eine vollständig containerisierte Einrichtung (inklusive PostgreSQL und 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

Mitwirken — Forken Sie das Repository, öffnen Sie einen Pull Request gegen main und nutzen Sie GitHub Issues, um Bugs zu melden oder Features vorzuschlagen:

gh repo fork Wei-Shaw/sub2api --clone

7. Projektstruktur

sub2api/
├── backend/     # Go-Service: Konfiguration, Modelle, Request-Handler, Provider-Gateway-Logik
├── frontend/    # Vue 3 + Vite + TailwindCSS Admin-Dashboard
├── deploy/      # Docker Compose-Dateien, Env-Vorlagen, Install-/Upgrade-Skripte
└── openspec/    # OpenAPI-Spezifikationen für die exponierten Gateway-Endpunkte
  • backend/cmd/server — Haupteinstiegspunkt für die Go-Binärdatei.
  • deploy/install.sh / deploy/docker-deploy.sh — One-Line-Installer für skriptbasiertes und Docker-basiertes Deployment.
  • frontend/ — Die Webkonsole zur Verwaltung von Konten, Schlüsseln, Abrechnung und Monitoring.

8. Verwandtes Ökosystem

  • Upstream-Abhängigkeiten: Go 1.25.7 mit dem Gin-Webframework und Ent ORM im Backend; Vue 3.4+, Vite 5+ und TailwindCSS im Frontend; PostgreSQL 15+ für Speicherung und Redis 7+ für Caching und Warteschlangen.
  • Upstream-Abonnementanbieter: Anthropic (Claude), OpenAI (inklusive Codex), Google (Gemini) und xAI (Grok) — Sub2API fungiert als Gateway vor diesen Diensten, anstatt sie zu ersetzen.
  • Begleitprojekte: sub2api-mobile, eine plattformübergreifende mobile Admin-Konsole zum Verwalten einer bereitgestellten Instanz unterwegs.

9. Lizenz

Sub2API wird unter der GNU Lesser General Public License v3.0 (LGPL-3.0) veröffentlicht.

  • ✅ Kostenlos zur Nutzung, zum Studium und zur Modifikation des Quellcodes, einschließlich interner oder Bildungszwecke.
  • ✅ Kostenlos zum Selbsthosting für persönliche oder Team-Nutzung, einschließlich der Kostenteilung innerhalb einer privaten Gruppe.
  • ❌ Das Projekt stellt ausdrücklich klar, dass es keine Einzelperson oder Organisation autorisiert hat, es als kommerziellen Dienst zu betreiben.
  • ℹ️ Die Nutzung von Sub2API zum Zugriff auf Upstream-Anbieter kann im Widerspruch zu den eigenen Nutzungsbedingungen dieser Anbieter stehen; die Maintainer beschreiben das Projekt als für technisches Lernen und Forschungszwecke gedacht, und Betreiber sind für ihre eigene Compliance und ihr Kontorisiko verantwortlich.

10. FAQ

F: Welche KI-Anbieter unterstützt Sub2API?
A: Claude (Anthropic), OpenAI (inklusive Codex), Gemini (Google), Grok/xAI und Antigravity, vereinheitlicht hinter kompatiblen API-Endpunkten. Siehe README für die aktuelle Liste.

F: Was ist der schnellste Weg, es auszuprobieren?
A: Nutzen Sie den Docker Compose Quickstart, der PostgreSQL und Redis automatisch neben dem Gateway bereitstellt:

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

F: Verstößt die Nutzung von Sub2API gegen meine Abonnementkonten gegen die Regeln des Anbieters?
A: Die Maintainer weisen darauf hin, dass dies im Widerspruch zu den Nutzungsbedingungen der Upstream-Anbieter stehen könnte und übernehmen keine Haftung für Kontosperrungen; prüfen Sie die Lizenz und Haftungsbeschränkungen im README, bevor Sie es bereitstellen.

F: Kann ich Sub2API nutzen, um einen kostenpflichtigen Dienst für andere zu betreiben?
A: Das Projekt bietet integrierte Zahlungsanbindungen (EasyPay, Alipay, WeChat Pay, Stripe) für die Kostenteilung innerhalb einer Gruppe, aber die Maintainer haben den kommerziellen Betrieb des Projekts selbst nicht autorisiert – prüfen Sie zuerst die Lizenzbedingungen.

F: Wo melde ich Bugs oder fordere Features an?
A: Über GitHub Issues im Hauptrepository.

11. Schnelllinks

12. Zusammenfassung

Sub2API verwandelt verstreute KI-Abonnementkonten in ein einzelnes, verwaltbares, API-kompatibles Gateway mit token-genauer Abrechnung, intelligentem Scheduling und einem vollständigen Admin-Dashboard. Es eignet sich am besten für Entwickler und kleine Teams, die Abonnementkosten teilen und auf Claude, OpenAI, Gemini und Grok über eine konsistente Schnittstelle zugreifen möchten, vorausgesetzt, sie prüfen sorgfältig die Upstream-Nutzungsbedingungen und Lizenzimplikationen vor dem Deployment.