Introduction à ServBay AI Gateway (Passerelle IA)

ServBay AI Gateway est une passerelle locale unifiée pour les fournisseurs de solutions IA intégrée à ServBay. Elle exécute un point d’accès proxy sur votre ordinateur, recevant toutes les requêtes vers près de 20 fournisseurs de modèles d’IA majeurs (OpenAI, Anthropic, DeepSeek, Tongyi Qianwen, etc.) à travers un point d’entrée unique. Cela vous permet de centraliser la gestion des clés API, le suivi de l’utilisation et des coûts, et de rediriger en un clic vos outils de développement IA en ligne de commande (comme Claude Code, Codex, Gemini CLI) vers la passerelle locale.

Ce document explique ce qu’est la passerelle IA, les problématiques qu’elle résout, et son architecture générale. Pour des instructions pratiques, consultez :

• Gestion des canaux — Ajouter et configurer les différents fournisseurs
• Clés virtuelles — Créer, restreindre, tourner et révoquer des clés virtuelles
• Prise en main en un clic des outils IA — Rediriger Claude Code et autres CLI vers la passerelle
• Statistiques et surveillance — Utilisation, coûts et budgets
• Points d’accès & variables d’environnement — Utiliser la passerelle IA dans votre code

Aperçu

Dans le développement IA au quotidien, il n’est pas rare de posséder plusieurs clés API de fournisseurs distincts, éparpillées dans divers fichiers de configuration de projets et d’outils. Cela rend le suivi des dépenses complexe et le changement de fournisseur peu pratique. ServBay AI Gateway centralise et simplifie ces tâches :

• Un seul point d’accès pour tous vos fournisseurs — Une fois vos canaux configurés, toutes les requêtes transitent par l’URL locale http://127.0.0.1:11580. Votre application ne cible plus qu’une seule adresse.
• Remplacez vos clés réelles par des clés virtuelles — Distribuez des "clés virtuelles" à vos applications et outils, pendant que vos API Keys réelles restent sécurisées sur la passerelle. Ces clés virtuelles sont entièrement administrables (restrictions, rotation, révocation) à tout moment.
• Tableau de bord unifié pour l’utilisation et les coûts — Toutes les requêtes passant par la passerelle sont tracées. Vous bénéficiez de statistiques sur le volume, la consommation de tokens, les coûts, latences et utilisation multimodale, avec gestion de budget intégrée.
• Prise en main automatique de vos outils IA préférés — Plus besoin de modifier manuellement les fichiers de configuration : la passerelle peut diriger en un clic Claude Code, Codex, Gemini CLI, Qwen Code, Kimi CLI, CodeBuddy, opencode, Crush, etc., vers son point d’accès local.

Architecture & Ports

La passerelle IA repose sur deux services locaux, tous deux à l’écoute sur l’adresse de loopback (127.0.0.1) :

Port	Utilisation	Description
11580	Port proxy	Point d’entrée unifié pour vos applications. Tout votre code et les outils contrôlés envoient leurs requêtes ici ; la passerelle route selon les droits de la clé virtuelle.
11581	Port de gestion	Sert aux opérations internes (gestion des canaux, des clés, statistiques), réservé à l’application ServBay. Vous n’aurez généralement pas à l’utiliser directement.

Le port proxy expose plusieurs formats d’accès compatibles (OpenAI, Anthropic, Gemini, etc.), voir Points d’accès & variables d’environnement pour plus de détails.

Fournisseurs Pris en Charge

La passerelle intègre d’emblée près de 20 fournisseurs, classés par catégories ; il suffit de choisir dans la liste pour configurer :

• Grand public : OpenAI, Anthropic, Google Gemini, Azure OpenAI, AWS Bedrock, OpenRouter.
• Chine : DeepSeek, Tongyi Qianwen, Zhipu GLM, Kimi (Moonshot AI), Doubao Volcano, Wenxin Yiyan, HunYuan, MiniMax, 01.AI, StepStar. Plusieurs d’entre eux (Tongyi Qianwen, Zhipu GLM, Kimi, Doubao Volcano, HunYuan, MiniMax, StepStar) permettent de basculer entre points d’accès Chine / International.
• Local : Ollama (par défaut 127.0.0.1:11434), LM Studio (par défaut 127.0.0.1:1234).
• Personnalisé : OpenAI Compatible (tout service compatible OpenAI), Custom (entièrement personnalisable).

Pour le mode d’emploi détaillé, voir Gestion des canaux.

Prérequis

• ServBay doit être installé et lancé sur macOS ou Windows.
• La passerelle IA est une fonctionnalité premium de ServBay ; vous devez être connecté à votre compte ServBay avant d’ajouter un canal ou une clé. Si vous n’êtes pas connecté, un guide de connexion s’affichera.

TIP

La passerelle IA offre les mêmes fonctionnalités, ports proxy (11580) et gestion (11581), ainsi que les chemins de fichiers de configuration des outils, sous macOS et Windows. Toute différence selon le système sera explicitement signalée.

Compte & Forfaits

Certaines fonctionnalités de la passerelle IA dépendent de votre type de compte ServBay :

• Limite de canaux / clés virtuelles — Le nombre de canaux et de clés virtuelles créables varie selon l’offre (gratuite/payante). Si la limite est atteinte, un message d’alerte s’affichera.
• Quota & gestion de budget — Les plafonds de consommation (token / nombre de requêtes / montant) et le tableau de bord de budget sont réservés à l’offre VIP / payante. Ces fonctionnalités sont verrouillées sans abonnement.

Pour plus d’informations sur les offres, consultez ServBay Pro et ServBay Team.

Stockage des Données

• La configuration des canaux, les clés virtuelles et les statistiques d’utilisation sont stockées localement sur le backend de la passerelle.
• La clé virtuelle en clair n'est affichée qu’une seule fois à la création (ou lors d’une rotation) ; seule la partie préfixe est conservée ensuite pour l’identification. Veillez à la copier immédiatement lors de la génération.
• Lors de la prise de contrôle des outils, leurs fichiers de configuration d’origine sont sauvegardés (suffixe .bak), puis remplacés par une configuration pointant vers la passerelle, permettant une restauration simple.

Exemple de Flux d’Utilisation

1. Connectez-vous à votre compte ServBay et accédez à la passerelle IA.
2. Depuis la page Gestion des canaux, ajoutez au moins un fournisseur (ex : OpenAI ou DeepSeek), entrez la clé API réelle et vérifiez la connexion.
3. Depuis la page Clés virtuelles, créez une clé virtuelle en définissant ses droits (modèles / canaux utilisables, limitation de débit).
4. Dans la page Points d’accès, renseignez la clé virtuelle dans votre application, ou utilisez la prise en main en un clic pour vos outils CLI d’IA.
5. Sur la page Statistiques et surveillance, suivez l’utilisation, les coûts et les temps de réponse, et définissez un budget si besoin.

Résumé

ServBay AI Gateway transforme le développement IA fragmenté — "multiplicité de fournisseurs, de clés et d’outils" — en une expérience centralisée avec "un point d’accès local, une seule gestion de clé virtuelle, une vision unifiée de l’utilisation". Elle vous permet de sécuriser et de piloter l’intégralité de vos ressources IA, de maîtriser vos coûts avec précision, et d’intégrer tous vos outils de développement IA dans la passerelle, le tout localement et en toute simplicité. ServBay AI Gateway constitue ainsi un pilier essentiel pour le développement IA-native.