Présentation de la passerelle IA ServBay (AI Gateway)

La passerelle IA ServBay (AI Gateway) est une passerelle unifiée locale pour fournisseurs d'IA intégrée à ServBay. Elle exécute un point de terminaison proxy sur votre machine, regroupant les requêtes destinées à divers fournisseurs de grands modèles (OpenAI, Anthropic, DeepSeek, Qwen, etc., près de 20 au total) vers une seule entrée, vous aidant à centraliser la gestion des clés, à suivre l'utilisation et les coûts, et à rediriger en un clic des outils de programmation IA tels que Claude Code et Codex vers la passerelle locale.

Ce document présente ce qu'est la passerelle IA, les problèmes qu'elle résout et son architecture globale. Pour les opérations concrètes, consultez :

• Gestion des canaux — Ajouter et configurer les fournisseurs
• Clés virtuelles — Créer, restreindre, effectuer la rotation et révoquer des clés
• Prise de contrôle en un clic des outils de programmation IA — Rediriger des CLI comme Claude Code vers la passerelle
• Statistiques et surveillance — Utilisation, coûts et budget
• Points de terminaison et variables d'environnement — Appeler la passerelle dans votre propre code

Vue d'ensemble

Dans le développement IA au quotidien, vous détenez peut-être simultanément des clés API de plusieurs fournisseurs, dispersées dans différents projets et fichiers de configuration de différents outils ; il est alors difficile de suivre les dépenses ou de basculer de manière unifiée. La passerelle IA ServBay rassemble ces problèmes en un seul endroit :

• Une seule entrée, plusieurs fournisseurs — Une fois les canaux configurés, toutes les requêtes sont transférées via l'adresse locale http://127.0.0.1:11580 ; votre application n'a plus qu'une seule adresse à gérer.
• Des clés virtuelles à la place des clés réelles — La passerelle émet des « clés virtuelles » à destination des applications et des outils ; les véritables clés API des fournisseurs restent stockées uniquement côté passerelle et ne sont plus dispersées. Les clés virtuelles peuvent être restreintes, renouvelées ou révoquées à tout moment.
• Une vue unifiée de l'utilisation et des coûts — Toutes les requêtes passant par la passerelle sont enregistrées ; elle fournit des statistiques sur le nombre de requêtes, la consommation de tokens, les coûts, la latence, l'utilisation multimodale, et prend en charge la gestion du budget.
• Prise de contrôle en un clic des principaux outils de programmation IA — Sans modifier manuellement les fichiers de configuration, la passerelle peut rediriger en un clic vers la passerelle locale des outils tels que Claude Code, Codex, Qwen Code, Kimi CLI, CodeBuddy, opencode, Crush, etc.
• Comptes d'abonnement et suivi des quotas — Prise en charge de l'association de comptes fournisseurs par abonnement (comme l'autorisation OAuth de Claude Pro / Max), avec affichage visuel dans la passerelle des informations d'offre, des points de terminaison disponibles, des limites de longueur de sortie, et suivi en temps réel des quotas multi-fenêtres (pourcentage utilisé / restant, état d'épuisement du quota, heure de réinitialisation), pour que vous gardiez toujours le contrôle du solde de votre abonnement.
• Détection des capacités des canaux et routage intelligent — Lors de l'ajout d'un canal, la passerelle détecte automatiquement les capacités du fournisseur (type autorisation OAuth / type forfait de codage / type modèle à niveaux), puis, après confirmation, écrit automatiquement les trois niveaux de mappage de la passerelle selon les résultats de détection, sans avoir à deviner manuellement la compatibilité des modèles.

Architecture et ports

La passerelle IA se compose de deux services locaux, qui n'écoutent que sur l'adresse de bouclage (127.0.0.1) :

Port	Utilisation	Description
11580	Port proxy	Point d'entrée unifié pour les applications. Votre code et les outils d'IA pris en charge envoient leurs requêtes ici ; la passerelle les achemine vers le canal fournisseur correspondant selon les permissions de la clé virtuelle.
11581	Port d'administration	Utilisé en interne par l'application ServBay pour gérer les canaux, les clés et les statistiques ; il n'est généralement pas nécessaire d'y accéder directement.

Le port proxy expose également des points de terminaison compatibles avec plusieurs formats (compatibles OpenAI, Anthropic et Gemini). Voir Points de terminaison et variables d'environnement.

Canaux fournisseurs pris en charge

La passerelle IA intègre près de 20 préréglages de fournisseurs, regroupés par catégorie, que vous pouvez sélectionner directement lors de l'ajout d'un canal :

• Principaux (Mainstream) : OpenAI, Anthropic, Google Gemini, Azure OpenAI, AWS Bedrock, OpenRouter.
• Chine (China) : DeepSeek, Qwen (Tongyi Qianwen), Zhipu GLM, Kimi (Moonshot), Doubao·Volcano, ERNIE Bot, Hunyuan, MiniMax, 01.AI, StepFun. Parmi eux, Qwen, Zhipu GLM, Kimi, Doubao·Volcano, Hunyuan, MiniMax, StepFun, etc. prennent en charge le basculement entre les points de terminaison Chine / international.
• Local (Local) : Ollama (par défaut 127.0.0.1:11434), LM Studio (par défaut 127.0.0.1:1234).
• Personnalisé (Custom) : OpenAI Compatible (tout service compatible OpenAI), Custom (entièrement personnalisé).

Pour la procédure complète d'ajout et de configuration, consultez Gestion des canaux.

Prérequis

• ServBay est installé et en cours d'exécution sur macOS ou Windows.
• La passerelle IA est une fonctionnalité à valeur ajoutée de ServBay ; vous devez d'abord vous connecter à votre compte ServBay avant d'ajouter des canaux / clés. Si vous n'êtes pas connecté, l'interface vous guide pour terminer la connexion.

TIP

La passerelle IA offre les mêmes fonctionnalités sur ServBay pour macOS et ServBay pour Windows ; le port proxy (11580), le port d'administration (11581) ainsi que les chemins des fichiers de configuration des outils pris en charge sont identiques. Toute différence entre plateformes sera précisée séparément dans la documentation.

Compte et forfaits

Certaines capacités de la passerelle IA sont liées au forfait de votre compte ServBay :

• Limite du nombre de canaux / clés — Les forfaits gratuit et payants permettent de créer un nombre différent de canaux et de clés virtuelles. Lorsque la limite est atteinte, l'interface invite à passer à un forfait supérieur.
• Gestion des quotas et du budget — Les limites par quota (tokens / nombre de requêtes / montant) et le tableau de bord budgétaire font partie des fonctionnalités VIP / payantes ; sans abonnement, les zones correspondantes sont verrouillées et invitent à passer à un forfait supérieur.

Pour plus de détails sur les forfaits, consultez ServBay Pro et ServBay Team.

Comptes d'abonnement et suivi des quotas

La passerelle IA permet d'associer des comptes fournisseurs par abonnement (comme les comptes Claude Pro / Max connectés via une autorisation OAuth), afin que vous puissiez consulter et gérer directement ces ressources d'abonnement dans la passerelle locale, sans avoir à vous connecter à la console web de chaque fournisseur.

Ce que permettent les comptes d'abonnement

• Des informations d'offre claires en un coup d'œil — Affiche le nom de l'offre d'abonnement, la structure de facturation et la période de validité.
• Points de terminaison disponibles et limites de sortie — Consultez la liste des points de terminaison appelables par ce compte d'abonnement et les limites de longueur maximale de sortie de chaque modèle.
• Suivi des quotas multi-fenêtres — Présente visuellement le pourcentage de quota utilisé / restant, s'il est actuellement épuisé, ainsi que l'heure de réinitialisation du quota, pour vous aider à répartir raisonnablement vos ressources d'abonnement.
• Visibilité de l'expiration des identifiants — Lorsque les identifiants d'autorisation du compte d'abonnement expirent ou ne sont plus valides, l'interface les signale clairement afin de vous inviter à réautoriser.

Fonctionnalité expérimentale

L'association de comptes d'abonnement via OAuth est actuellement une fonctionnalité expérimentale ; les fournisseurs pris en charge seront progressivement étendus. Lors de l'autorisation, vous devez suivre le flux OAuth du fournisseur dans votre navigateur ; le jeton d'autorisation est stocké uniquement en local.

Stockage des données

• Les données telles que la configuration des canaux, les clés virtuelles et les statistiques d'utilisation sont conservées localement par le service backend de la passerelle.
• La version en clair d'une clé virtuelle n'est affichée qu'une seule fois lors de sa création (ou de sa rotation) ; ensuite, la passerelle ne conserve que son préfixe à des fins d'identification. Veillez à la copier et à la conserver immédiatement lors de la création.
• Lors de la prise de contrôle en un clic d'un outil, la passerelle sauvegarde d'abord le fichier de configuration d'origine de l'outil cible avec l'extension .bak, puis écrit la configuration pointant vers la passerelle locale, ce qui facilite une restauration à tout moment.

Flux d'utilisation typique

1. Connectez-vous à votre compte ServBay, puis accédez à la passerelle IA.
2. Dans la page Canaux, ajoutez au moins un canal fournisseur (par exemple OpenAI ou DeepSeek), saisissez la véritable clé API et testez la connectivité.
3. Dans la page Clés virtuelles, créez une clé virtuelle et limitez si nécessaire les modèles / canaux disponibles et le débit.
4. Dans la page Points de terminaison, renseignez la clé virtuelle dans votre application, ou utilisez sur la même page la prise de contrôle en un clic pour votre outil de programmation IA habituel.
5. Dans la page Statistiques et surveillance, observez l'utilisation, les coûts et la latence, et définissez un budget si nécessaire.

En résumé

La passerelle IA ServBay rassemble la situation fragmentée du développement IA — « plusieurs fournisseurs, plusieurs clés, plusieurs outils » — en « une entrée locale, un ensemble de clés virtuelles, une vue d'utilisation unique ». Elle vous permet de gérer de manière centralisée et sécurisée vos capacités d'IA en local, de maîtriser précisément les coûts et de connecter divers outils de programmation IA à une passerelle unifiée au moindre coût. C'est l'une des capacités clés de ServBay pour le développement AI-native.