Sub2API

Qu'est-ce que Sub2API ?

Sub2API est une plateforme open source de passerelle d’API IA qui aide à distribuer et gérer les quotas d’API issus des abonnements à des produits IA. Au lieu que chaque utilisateur s’intègre directement aux services IA en amont, Sub2API fournit des clés API générées par la plateforme tout en gérant l’authentification, la comptabilité liée à la facturation, l’équilibrage de charge et le transfert des requêtes.

Le projet est conçu pour les configurations où plusieurs comptes en amont doivent être regroupés et servis via une passerelle unique et cohérente, avec des fonctionnalités comme le support multi-comptes, la planification quota-consciente, et les contrôles de concurrence et de limitation de débit.

Fonctionnalités principales

• Gestion multi-comptes pour les connexions en amont (supporte plusieurs types de comptes en amont comme OAuth et API Key), permettant à une passerelle unique de servir plusieurs comptes en amont.
• Distribution de clés API (génération et gestion de clés API pour les utilisateurs), pour que les utilisateurs s’authentifient auprès de Sub2API plutôt que de gérer plusieurs identifiants en amont.
• Suivi d’utilisation au niveau des tokens et calcul des coûts, pour tracker et calculer l’utilisation au niveau des tokens dans un contexte de comptabilité liée à la facturation.
• Planification intelligente avec sessions persistantes, qui sélectionne intelligemment les comptes en amont tout en maintenant un routage de session stable dans des environnements multi-comptes.
• Contrôle de concurrence et limitation de débit configurable (limites de concurrence par utilisateur et par compte ; limites de débit pour les requêtes et tokens), pour éviter les surcharges et gérer le débit.
• Tableau de bord admin pour la surveillance et la gestion via une interface web.
• Intégration de systèmes externes pour étendre le tableau de bord admin via des iframes (ex. : intégration de systèmes de paiement ou de ticketing).

Comment utiliser Sub2API

1. Décidez si vous voulez auto-héberger ou utiliser le service de relais officiel. Le dépôt mentionne un relais officiel, PinCC, pour les utilisateurs ne souhaitant pas auto-héberger.
2. Si auto-hébergement, installez Sub2API sur un serveur Linux (amd64 ou arm64) avec PostgreSQL 15+ et Redis 7+ disponibles.
3. Installez via le script one-click fourni dans le dépôt, puis démarrez le service et activez-le au boot.
4. Ouvrez l’assistant de configuration dans votre navigateur (le README référence http://YOUR_SERVER_IP:8080) pour configurer les paramètres base de données/Redis et créer un compte admin.
5. Depuis le tableau de bord admin, gérez les paramètres et les clés API des utilisateurs ; les utilisateurs appellent alors les services IA en amont via la plateforme en utilisant leurs clés API Sub2API.

Cas d’usage

• Regroupement de plusieurs comptes d’abonnement en amont : utilisez Sub2API pour centraliser l’utilisation des quotas et servir les utilisateurs via une passerelle unique tout en distribuant les requêtes sur les comptes en amont.
• Distribution de quotas pour les équipes : donnez à chaque membre d’équipe des clés API Sub2API individuelles tandis que Sub2API tracke l’utilisation au niveau des tokens et gère la planification et les limites.
• Gestion du débit avec limites : configurez des limites de concurrence par utilisateur et par compte, plus des limites de débit requêtes/tokens, pour modeler la charge et réduire les risques de saturation en amont.
• Visibilité opérationnelle et administration : utilisez le tableau de bord admin intégré pour surveiller et gérer la passerelle plutôt que de dépendre uniquement des tableaux de bord des fournisseurs en amont.
• Extension des workflows internes : intégrez des systèmes externes (comme paiement ou ticketing) dans le tableau de bord admin via des iframes pour supporter les processus opérationnels.

FAQ

• Sub2API est-il lié à un domaine spécifique ? Le dépôt indique que Sub2API utilise officiellement uniquement sub2api.org et pincc.ai. D’autres sites utilisant le nom Sub2API peuvent être des déploiements tiers non affiliés ; les utilisateurs doivent vérifier par eux-mêmes.

• Comment déployer Sub2API ? Le projet documente deux méthodes de déploiement : installation via un script qui télécharge des binaires pré-compilés depuis GitHub Releases, ou déploiement avec Docker Compose (incluant conteneurs PostgreSQL et Redis).

• Quels comptes en amont Sub2API supporte-t-il ? Il supporte plusieurs types de comptes en amont, y compris OAuth et API Key (comme indiqué dans la liste des fonctionnalités).

• Que faire en utilisant Nginx comme reverse proxy ? Le README note que si vous utilisez Nginx avec Sub2API (ou CRS) et Codex CLI, ajoutez underscores_in_headers on; dans le bloc http, car Nginx supprime par défaut les en-têtes contenant des underscores, ce qui peut casser le routage des sessions persistantes en setups multi-comptes.

Alternatives

• Utilisez le service de relais officiel (PinCC) : si vous ne voulez pas auto-héberger Sub2API, le dépôt pointe vers PinCC comme relais officiel basé sur Sub2API, destiné aux utilisateurs qui veulent un accès prêt à l’emploi sans déploiement/maintenance.
• Utilisez une passerelle d’API auto-gérée pour les quotas et le routage : si vous gérez déjà une infrastructure, vous pouvez chercher des solutions de passerelle/gestion de routage qui supportent les clés API, l’authentification, la limitation de débit et le transfert de requêtes ; contrairement à Sub2API, elles n’incluent peut-être pas le suivi d’utilisation au niveau des tokens et la distribution de quotas orientée abonnements IA.
• Construisez un service proxy personnalisé : vous pouvez implémenter un proxy applicatif qui route les requêtes vers les fournisseurs IA en amont et applique des limites ; comparé à Sub2API, cela demande généralement plus de travail d’ingénierie pour des fonctionnalités comme les sessions persistantes et la comptabilisation au niveau des tokens.
• Adoptez une approche de gestion d’API multi-tenant : les plateformes de gestion d’API généralistes peuvent centraliser l’authentification et le throttling, mais nécessitent souvent une personnalisation supplémentaire pour reproduire la distribution de quotas et le workflow de comptabilisation d’utilisation par token de Sub2API.