Connecter vos applications et outils à Xcellerate AIG : API compatible OpenAI, Claude Code, Cursor et Copilot Studio

Toute application, tout SDK ou outil qui parle à OpenAI peut parler à Xcellerate AIG dès que vous changez deux réglages : l'URL de base et la clé API. Les équipes qui utilisent les SDK d'Anthropic, de Google ou d'AWS Bedrock peuvent les garder, car AIG répond dans le format de chaque fournisseur. Chaque appel reçoit alors budgets, limites de débit, garde-fous, routage, basculement et une entrée de journal.

TL;DR

• Créez une clé virtuelle par application, équipe ou agent.
• Pointez le client vers la bonne URL de base : /v1, /anthropic, /genai, /bedrock ou /v1/mcp.
• Vérifiez le premier appel dans les journaux. Les vraies clés de vos fournisseurs n'arrivent jamais chez vos clients.

Avant de commencer

• Un administrateur autorisé à créer des clés virtuelles (droit Gouvernance).
• Au moins un fournisseur activé dans AIG et un catalogue de modèles synchronisé.
• Un accès réseau de l'application vers https://<your-gateway> (TLS, port 443).
• Un client qui permet de définir une URL de base ou un endpoint personnalisé.

Connecter votre application ou outil

1. Créez une clé virtuelle

Allez dans Gouvernance → Gouvernance → Clés virtuelles et cliquez sur Nouvelle clé virtuelle. Limitez si besoin fournisseurs et modèles, et définissez budget, limite de débit, expiration (de 30 minutes à jamais), outils MCP et politique IP. Copiez tout de suite le jeton sk-xc-… : il n'est affiché qu'une fois.

2. Pointez le client vers AIG

• Claude Code : réglez ANTHROPIC_BASE_URL sur https://<your-gateway>/anthropic et ANTHROPIC_AUTH_TOKEN sur votre clé virtuelle.
• Microsoft Copilot Studio : endpoint https://<your-gateway>/v1/mcp, authentification « API key », en-tête Authorization: Bearer <virtual key>. Les outils apparaissent sous la forme mcp__<server>__<tool>.

3. Utilisez un nom de modèle d'AIG

Prenez le nom dans Connect → Models (Connecter → Modèles), par exemple openai/gpt-4o-mini, ou le nom court s'il est unique.

4. Vérifiez le premier appel

Envoyez une requête et ouvrez Trafic → Journaux. Le filtre « Arrived as » montre par quelle entrée l'appel est arrivé. Chaque réponse contient l'ID de requête dans l'en-tête x-xc-request-id.

Ce qui se passe après la connexion

• GET /v1/models ne liste que les modèles que cette clé peut appeler.
• /v1 couvre chat completions (streaming compris), embeddings, génération d'images, synthèse vocale, transcription, rerank, models, responses, files, batches, feedback et MCP.
• Le routage peut servir une requête via un autre fournisseur que celui demandé ; la réponse garde le format de l'appelant.
• En-têtes optionnels : x-xc-tags (p. ex. prod,checkout) pour l'attribution des coûts, x-xc-agent-name et x-xc-agent-run-id pour les chronologies d'agents, X-Request-Id et traceparent pour relier vos propres logs et traces.

Bon à savoir

• Les requêtes en streaming ont besoin de stream_options: {"include_usage": true} pour être tarifées.
• Les clients du SDK Bedrock doivent remplacer l'en-tête SigV4 Authorization par la clé virtuelle, par exemple via un event hook boto3. Seuls invoke et invoke-with-response-stream sont servis.
• Les appels de fonction Gemini arrivent en entier, pas en streaming. Les flux Anthropic indiquent les tokens d'entrée à la fin.
• Les endpoints bêta des fournisseurs ne sont pas modélisés. Un pass-through par clé et par fournisseur existe, désactivé par défaut.
• En mode gratuit : 5 clés virtuelles actives au maximum et 5 requêtes par clé et par jour.
• Les interfaces de chat comme Open WebUI n'ont pas d'intégration dédiée. Connectez-les comme n'importe quel client compatible OpenAI.

Dépannage

• 401 « Incorrect API key provided. » ou « This API key has expired. » : clé inconnue, révoquée ou expirée.
• 403 « This API key is not permitted to use the model '…'. » : le modèle sort du périmètre de la clé. Un blocage par garde-fou renvoie aussi 403.
• 404 « The model '…' does not exist or you do not have access to it. » : vérifiez le nom dans l'écran Models.
• 402 ou 429 : budget ou limite de débit de la clé épuisé ; attendez le délai retry-after.

Les erreurs sur /anthropic et /genai reviennent dans le format d'erreur de ce fournisseur.

En savoir plus sur une API pour tous les modèles, les clés virtuelles et les journaux de requêtes.

Vous voulez faire passer les outils IA de votre équipe par une seule passerelle maîtrisée ? Parlez-nous d'AIG.