Gestion des canaux dans la passerelle IA

Un « canal » correspond à une configuration du point d’accès d’un fournisseur dans la passerelle IA. Il contient l’adresse du fournisseur, la véritable clé API, les modèles disponibles, la tarification, les quotas, et d’autres informations. C’est à travers ces canaux que la passerelle redirige les requêtes d’applications vers le fournisseur approprié. Cette page explique comment ajouter, configurer, tester et gérer vos canaux.

Prérequis

• ServBay doit être installé, en cours d'exécution et vous devez être connecté à votre compte ServBay (une connexion est requise avant d’ajouter un canal).
• Préparez la vraie clé API du fournisseur souhaité (pour les fournisseurs locaux comme Ollama / LM Studio, ce champ peut rester vide).
• Si vous découvrez la passerelle IA, nous vous recommandons de lire d’abord l’introduction à la passerelle IA.

Ajouter un canal

Accédez à Passerelle IA → Canaux, puis cliquez sur Ajouter pour ouvrir l’assistant d’ajout. Le processus se déroule en trois étapes :

Première étape : Choisir un fournisseur

Les fournisseurs sont regroupés par catégorie ; cliquez simplement sur la carte de votre choix :

• Principaux (Mainstream) : OpenAI, Anthropic, Google Gemini, Azure OpenAI, AWS Bedrock, OpenRouter.
• Chine : DeepSeek, QWen, Zhipu GLM, Kimi, Doubao Volcengine, Wenxin Yiyan, Hunyuan, MiniMax, Yi, StepFun Stars.
• Local : Ollama, LM Studio.
• Personnalisé (Custom) : OpenAI Compatible, Custom.

Une fois votre fournisseur sélectionné, la passerelle remplira automatiquement l’URL de base par défaut.

Basculement bi-régional

Certains fournisseurs chinois tels que QWen, Zhipu GLM, Kimi, Doubao Volcengine, Hunyuan, MiniMax ou StepFun Stars proposent deux points de terminaison : Chine et International. Lorsque vous choisissez l’un de ces fournisseurs, un sélecteur de région (🇨🇳 Chine / 🌐 International) s’affiche. Le changement mettra à jour automatiquement l’URL de base selon la région.

Deuxième étape : Saisir la configuration

• Nom du canal (obligatoire) — Sert à identifier le canal dans la liste, personnalisable.
• Base URL (obligatoire) — Adresse API du fournisseur. Elle est renseignée par défaut pour la plupart des fournisseurs ; pour Azure OpenAI et Custom, saisissez-la manuellement.
• API Key (facultatif) — La vraie clé du fournisseur. Si le champ reste vide, vous pourrez seulement tester la disponibilité de l’endpoint, sans valider la clé ; pour les fournisseurs locaux (Ollama / LM Studio), il n'est généralement pas nécessaire d’en fournir.
• Modèles — Deux méthodes au choix :
  • Découverte automatique : cliquez sur Découvrir, la passerelle interroge le fournisseur et charge la liste des modèles disponibles, sélection multiple sous forme d’étiquettes.
  • Saisie manuelle : indiquez le nom du modèle à la main. Pour Azure, il faut saisir le nom du déploiement (Deployment name), et non le nom du modèle.
• Priorité / Pondération — Si plusieurs canaux couvrent le même modèle, la passerelle utilise ce paramètre pour la répartition de charge.

Attention pour Azure OpenAI

Pour les canaux Azure, le champ « Modèle » doit correspondre au nom du déploiement (Deployment name) créé dans le portail Azure, et non au nom du modèle sous-jacent. Le Base URL doit aussi être celui de votre ressource Azure.

Troisième étape : Vérifier et soumettre

Vérifiez le résumé de la configuration, puis validez. En cas de succès, le canal s’ajoute à la liste avec affichage de son état de santé en temps réel.

Test de connectivité

Depuis la liste des canaux, il est possible d’effectuer un test de connectivité sur chaque canal. Deux validations sont réalisées :

• Accessibilité de l’endpoint — Vérifie la connexion à l’URL de base (exactitude de l’adresse et réseau).
• Validité de la clé — Appelle l’API du fournisseur pour valider la clé API. Cette vérification n’est faite que si une clé est renseignée.

Le résultat affiche la latence aller-retour (en ms), un badge d’état et d’éventuelles erreurs.

TIP

Lors de l’ajout via l’assistant, si l’endpoint n’est pas accessible, il sera impossible de poursuivre ; si l’endpoint est accessible mais la clé n’est pas valide, un avertissement s’affichera et vous pourrez continuer (par exemple si vous souhaitez ajouter la clé ultérieurement).

Configuration avancée

En ajoutant ou modifiant un canal, vous pouvez accéder aux réglages avancés pour la gestion des coûts et des quotas :

• Multiplicateur de tarif — Applique un coefficient sur le prix officiel du fournisseur, afin de refléter votre coût réel ou un prix de revente. Par défaut : 1.0.
• Structure de facturation — Indique la méthode de facturation du canal : paiement à l’usage (pay as you go), abonnement ou forfait.
• Solde — Le solde peut provenir d’une valeur fixe, d’une facture OSS ou d’une gestion manuelle ; avec OSS, vous pouvez spécifier le type de facture. Le solde et la date de mise à jour sont affichés en lecture seule dans le détail du canal.
• Expiration de l’abonnement — Permet d’enregistrer la date de fin pour les canaux d’abonnement ou de forfait.
• Limite de quota (VIP) — Permet de définir un plafond par nombre de jetons (tokens), requêtes ou montant, et définir une période (quotidien, hebdomadaire, mensuel, personnalisé). Vous pouvez autoriser un certain dépassement (« tolérance de dérive »). Les limitations de quotas sont des fonctionnalités premium.

Modifier et supprimer un canal

• Modifier — Ouvrez un canal dans la liste pour modifier son nom, sa Base URL, sa clé API, ses modèles ou ses réglages avancés.
• Supprimer — Après suppression d’un canal, toute clé virtuelle dépendante ne pourra plus router vers ce canal. Procédez avec prudence.

État de santé

La liste des canaux et la page de suivi affichent en temps réel l’état de santé de chaque canal (Normal / Dégradé / Indisponible), pour vous aider à identifier rapidement un fournisseur défaillant.

Foire aux questions (FAQ)

• Q : J’ai un message demandant de me connecter lors de l’ajout d’un canal ?
  • R : La passerelle IA est une fonctionnalité premium de ServBay. Vous devez être connecté à votre compte ServBay pour ajouter un canal ou une clé. Suivez le processus à l’écran.
• Q : Je reçois un message disant que j’ai atteint la limite de canaux ajoutés ?
  • R : Le nombre de canaux créables dépend de votre forfait. Supprimez un canal inutilisé ou effectuez une mise à niveau pour en ajouter davantage.
• Q : Impossible de charger la liste de modèles avec la découverte automatique ?
  • R : Vérifiez la Base URL et la validité de la clé API (testez la « validité de la clé » dans le test de connectivité). Certains fournisseurs exigent une clé valide pour renvoyer la liste des modèles. Sinon, renseignez les noms des modèles manuellement.
• Q : Dois-je renseigner une clé pour Ollama / LM Studio en local ?
  • R : Généralement non. Assurez-vous que le service local est lancé et à l’écoute du port par défaut (Ollama 11434, LM Studio 1234).

Résumé

Les canaux sont la base du routage dans la passerelle IA. Grâce à un assistant en trois étapes, connectez-vous rapidement à près de 20 fournisseurs. Basculez entre régions, découvrez automatiquement les modèles disponibles, testez chaque canal selon deux critères de connectivité, et exploitez des options avancées pour un contrôle précis des coûts (tarification, quotas). Une fois vos canaux configurés, créez des clés virtuelles à destination de vos applications et outils.