Connecter OpenAI, Anthropic, Gemini, Mistral, Groq ou OpenRouter à Xcellerate AIG

En connectant OpenAI, Anthropic, Google Gemini, Mistral, Groq ou OpenRouter à Xcellerate AIG, votre équipe dispose d'un point d'accès unique et gouverné aux modèles d'IA hébergés. Vos applications appellent AIG avec leur propre clé virtuelle et ne voient jamais la clé du fournisseur. Ce guide s'adresse à l'administrateur qui configure AIG pour un MSP, une PME ou une entreprise de services.

En bref

• La configuration est identique pour les six fournisseurs : choisissez le type, donnez un nom, collez une clé API.
• Un nouveau fournisseur démarre désactivé, pour que vous puissiez le tester avec une seule petite requête.
• Après l'activation, synchronisez le catalogue de modèles et émettez une clé virtuelle par application.

Avant de commencer

• Un compte chez le fournisseur et une clé API standard : clé OpenAI, clé de la console Anthropic, clé Google AI Studio (API Gemini) ou clé Mistral, Groq ou OpenRouter.
• Le rôle Admin dans AIG, ou un rôle personnalisé autorisé à créer et modifier des fournisseurs.
• Un accès HTTPS sortant du serveur AIG vers le fournisseur. Les adresses par défaut sont api.openai.com/v1, api.anthropic.com/v1, generativelanguage.googleapis.com/v1beta, api.mistral.ai/v1, api.groq.com/openai/v1, openrouter.ai/api/v1. Si le trafic doit passer par un proxy, configurez-le sous General settings → Network egress (paramètres généraux → trafic réseau sortant).
• Aucune URL de rappel ni aucun webhook n'est nécessaire.

Configurer le fournisseur

1. Lancez l'assistant

Dans la barre latérale, allez dans Connexion → Fournisseurs et cliquez sur Connecter un fournisseur.

2. Choisissez le fournisseur et nommez-le

Dans Type de fournisseur, choisissez OpenAI, Anthropic, Google Gemini, Mistral, Groq ou OpenRouter. Donnez un Nom d'affichage que tout le monde reconnaît, par exemple « OpenAI production ». Laissez URL de base vide pour utiliser l'adresse par défaut du fournisseur.

3. Collez la clé API

Collez la clé dans le champ Clé API. AIG enregistre le fournisseur désactivé : aucun trafic ne lui est encore envoyé.

4. Testez

Avec Try it (essayer), envoyez une petite requête réelle. Elle coûte quelques jetons. Vous pouvez aussi choisir Continue anyway (continuer quand même) ; le fournisseur reste alors désactivé. Plus tard, Tester la connexion effectue le même contrôle.

5. Activez, synchronisez et émettez une clé

Cliquez sur Enable provider (activer le fournisseur). Chargez ensuite le catalogue via Models → Sync (modèles → synchroniser), puis créez une clé pour votre application dans Governance → Virtual keys → New virtual key (nouvelle clé virtuelle).

Facultatif : plusieurs clés, périmètre réduit

• Avec Ajouter une clé, placez plusieurs clés du fournisseur sur un même fournisseur et donnez à chacune un Weight (poids) pour répartir le trafic.
• Limitez une clé à certains modèles avec Allowed models (modèles autorisés).
• Sous Ce que ce fournisseur sert, cochez uniquement ce dont vous avez besoin.

Ce qui se passe après la connexion

Vos applications désignent un modèle sous la forme <nom-du-fournisseur>/<modèle>, par exemple openai/gpt-4o-mini, ou par un simple nom de modèle qu'AIG résout via le catalogue. AIG traduit chaque requête dans le format du fournisseur : une même requête de style OpenAI peut ainsi atteindre OpenAI, Anthropic ou Gemini.

La synchronisation du catalogue récupère les noms de modèles, les fenêtres de contexte et les prix depuis une fiche de données publiée, selon un planning (au plus une fois par heure) ou à la demande.

Ce que chaque type sert :

• OpenAI : chat, embeddings, images, voix, transcription, rerank
• Anthropic : chat
• Google Gemini : chat, embeddings
• Mistral : chat, embeddings, transcription
• Groq : chat, transcription, voix
• OpenRouter : chat, embeddings, images

Bon à savoir

• Max retries (nombre maximal de nouvelles tentatives) vaut 0 par défaut. Activez les nouvelles tentatives en connaissance de cause.
• Avec plusieurs clés, AIG alterne automatiquement. Une clé refusée passe en Dead ou Suspect ; une clé limitée en débit passe en Cooling down et revient d'elle-même.
• Désactiver un fournisseur arrête le trafic dès la requête suivante, en conservant ses clés. Supprimer un fournisseur supprime aussi ses clés.
• Les requêtes de style OpenAI en streaming ne sont valorisées que si l'appelant envoie stream_options: {"include_usage": true}.
• Les clés API sont en écriture seule : après l'enregistrement, vous ne voyez qu'un indice masqué comme sk-…4f2a, et les clés du fournisseur n'apparaissent jamais dans les messages d'erreur.
• Sans licence, AIG fonctionne en mode gratuit : 5 clés virtuelles, 5 requêtes par clé et par jour. Une licence lève cette limite.

Dépannage

• « No enabled key to test with. » Ajoutez une clé ou activez la clé existante, puis testez à nouveau.
• « No model to try. Sync the catalog first… » Lancez Models → Sync et réessayez.
• <model> did not answer (<ms> ms): <message> Le message vient du fournisseur. Vérifiez la clé et l'accès de votre compte à ce modèle.
• No healthy API key is available for provider '…' (503) ou Every API key configured for '…' failed for this request. (502) : vérifiez le statut des clés (Healthy, Dead, Cooling down, Suspect), corrigez la clé, puis cliquez sur Clear health flags (effacer les indicateurs d'état). No enabled provider is configured for '…' (400) signifie qu'aucun fournisseur activé ne correspond à ce nom.

Parlons d'AIG

Vous voulez voir comment AIG s'intègre à votre MSP ou à votre entreprise de services ? Parlez-nous d'AIG. Pour aller plus loin : tous les fournisseurs dans un catalogue et les clés virtuelles.