Points de terminaison et variables d'environnement de la passerelle AI

En plus de la prise de contrôle en un clic pour les outils IA prêts à l’emploi, vous pouvez aussi connecter la passerelle AI directement dans vos propres applications, scripts ou n’importe quel outil IA. Ce guide détaille les formats de points de terminaison exposés par la passerelle, ainsi que la méthode de connexion via une clé virtuelle.

Points de terminaison proxy

Le service proxy de la passerelle AI écoute sur http://127.0.0.1:11580. Pour garantir la compatibilité avec différents SDKs et outils, la passerelle propose plusieurs formats de points de terminaison sur le même port :

Format de protocole	Chemin du point de terminaison	Cas d’utilisation
Compatible OpenAI	http://127.0.0.1:11580/v1	Tout SDK/outil utilisant le format API OpenAI (ex : /v1/chat/completions)
Compatible Anthropic	http://127.0.0.1:11580/v1/messages	SDK Anthropic, Claude Code, etc.
Compatible Gemini	http://127.0.0.1:11580/v1beta	SDK Google Gemini, ligne de commande Gemini, etc.

Il vous suffit de choisir le format adapté au protocole de votre SDK, et de pointer la requête vers l’adresse de la passerelle. Celle-ci acheminera la demande vers le canal correspondant selon les droits de votre clé virtuelle.

Authentification : utilisation de la clé virtuelle

Toutes les requêtes envoyées à la passerelle doivent être authentifiées par une clé virtuelle, et non par la vraie clé fournie par le prestataire AI. Commencez par créer une clé virtuelle depuis la page Clés puis copiez son texte.

Dans la page Passerelle AI → Points de terminaison, vous pouvez sélectionner une clé virtuelle ; la passerelle générera alors automatiquement des extraits de variables d’environnement à copier/utiliser dans vos outils habituels.

Exemple de variables d'environnement

Les exemples ci-dessous supposent que vous disposez déjà d’une clé virtuelle (remplacée ici par <votre_clé_virtuelle>).

SDK / outils compatibles OpenAI

export OPENAI_BASE_URL="http://127.0.0.1:11580/v1"
export OPENAI_API_KEY="<votre_clé_virtuelle>"

Claude Code / Anthropic

# Remarque : Le protocole Anthropic utilise l’URL racine de la passerelle, sans /v1
export ANTHROPIC_BASE_URL="http://127.0.0.1:11580"
export ANTHROPIC_AUTH_TOKEN="<votre_clé_virtuelle>"

Gemini

export GOOGLE_GEMINI_BASE_URL="http://127.0.0.1:11580"
export GEMINI_API_KEY="<votre_clé_virtuelle>"

Exemple d’appel (compatible OpenAI)

curl http://127.0.0.1:11580/v1/chat/completions \
  -H "Authorization: Bearer <votre_clé_virtuelle>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [{"role": "user", "content": "你好"}]
  }'

Le champ model doit correspondre à un modèle configuré dans votre canal, auquel votre clé virtuelle possède le droit d’accès.

Prérequis

• Le service proxy de la passerelle AI doit être en fonctionnement.
• Vous devez avoir configuré au moins un canal valide, et créé une clé virtuelle avec les droits adéquats sur les modèles / canaux.

FAQ (Questions fréquentes)

• Q : J'obtiens une erreur d’authentification ?
  • R : Vérifiez que vous utilisez bien une clé virtuelle (et non une clé fournisseur réelle), et que la clé n’a pas expiré/été révoquée.
• Q : Message indiquant que le modèle n’est pas disponible ou que l’accès est refusé ?
  • R : Assurez-vous que le champ model est bien configuré dans un canal et que votre clé virtuelle y est autorisée.
• Q : Quel format de point de terminaison utiliser ?
  • R : Suivez le protocole du SDK utilisé — Style OpenAI avec /v1, style Anthropic avec /v1/messages (base URL sans /v1), ou style Gemini avec /v1beta.
• Q : Puis-je accéder à la passerelle depuis d’autres appareils de mon réseau local ?
  • R : Par défaut, la passerelle écoute seulement sur 127.0.0.1 (localhost). Ceci est une recommandation de sécurité.

Résumé

La passerelle AI fournit localement des points de terminaison unifiés, compatibles OpenAI, Anthropic et Gemini. Grâce à la gestion des autorisations par clés virtuelles, vous pouvez connecter n’importe quelle application ou outil IA tout en centralisant la gestion des clés et des statistiques d’utilisation. Pour les outils en ligne de commande les plus courants, la prise de contrôle en un clic est le moyen le plus simple et rapide.