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

En plus de la prise de contrôle en un clic des outils d'IA existants, vous pouvez également appeler directement la passerelle IA depuis votre propre application, vos scripts ou n'importe quel outil d'IA. Cet article présente les formats de points de terminaison exposés par la passerelle et la manière de s'y connecter avec une clé virtuelle.

Points de terminaison du proxy

Le service proxy de la passerelle IA écoute sur http://127.0.0.1:11580. Pour rester compatible avec les SDK et outils de différents fournisseurs, la passerelle expose sur le même port des points de terminaison dans plusieurs formats de protocole :

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 d'API OpenAI (ex. /v1/chat/completions)
Compatible Anthropic	http://127.0.0.1:11580/v1/messages	SDK Anthropic et Claude Code, etc.
Compatible Gemini	http://127.0.0.1:11580/v1beta	SDK Google Gemini, etc.

Il vous suffit de choisir le format correspondant au protocole du SDK utilisé, puis de pointer vos requêtes vers l'adresse de la passerelle ; celle-ci route les requêtes vers le canal du fournisseur correspondant en fonction des autorisations de la clé virtuelle.

Authentification : utiliser une clé virtuelle

Toutes les requêtes vers la passerelle sont authentifiées avec une clé virtuelle, et non avec la clé réelle du fournisseur. Commencez par créer une clé virtuelle sur la page Clés et copiez sa valeur en clair.

Sur la page Passerelle IA → Points de terminaison (Endpoints), vous pouvez sélectionner une clé virtuelle ; la passerelle génère alors directement des extraits de variables d'environnement copiables pour les outils courants.

Exemples de variables d'environnement

Les exemples suivants supposent que vous disposez déjà d'une clé virtuelle (notée <你的虚拟密钥>).

SDK / outils compatibles OpenAI

export OPENAI_BASE_URL="http://127.0.0.1:11580/v1"
export OPENAI_API_KEY="<你的虚拟密钥>"

Claude Code / Anthropic

# Remarque : le protocole Anthropic utilise l'adresse racine de la passerelle, sans /v1
export ANTHROPIC_BASE_URL="http://127.0.0.1:11580"
export ANTHROPIC_AUTH_TOKEN="<你的虚拟密钥>"

Gemini

export GOOGLE_GEMINI_BASE_URL="http://127.0.0.1:11580"
export GEMINI_API_KEY="<你的虚拟密钥>"

Exemple d'appel (compatible OpenAI)

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

Le champ model doit correspondre à un modèle configuré dans vos canaux et que cette clé virtuelle est autorisée à appeler.

Prérequis

• Le service proxy de la passerelle IA est en cours d'exécution.
• Au moins un canal opérationnel est configuré, et une clé virtuelle disposant des autorisations nécessaires sur les modèles / canaux concernés a été créée.

Questions fréquentes (FAQ)

• Q : Une requête renvoie un échec d'authentification ?
  • R : Vérifiez que vous utilisez bien une clé virtuelle (et non la clé réelle du fournisseur), et que cette clé n'a pas expiré ni été révoquée.
• Q : Le modèle est indiqué comme indisponible ou non autorisé ?
  • R : Vérifiez que ce model est configuré dans un canal et que la liste « Modèles / canaux autorisés » de la clé virtuelle actuelle l'inclut.
• Q : Quel format de point de terminaison utiliser ?
  • R : Choisissez selon le protocole de votre SDK — style OpenAI : /v1 ; style Anthropic : /v1/messages (l'URL de base ne contient pas /v1) ; style Gemini : /v1beta.
• Q : D'autres appareils du réseau local peuvent-ils accéder à la passerelle ?
  • R : Par défaut, la passerelle n'écoute que sur 127.0.0.1 (machine locale uniquement). Il s'agit du réglage recommandé pour des raisons de sécurité.

Résumé

La passerelle IA expose un point de terminaison local unifié dans trois formats compatibles : OpenAI, Anthropic et Gemini. Associée à l'authentification par clé virtuelle, elle vous permet de connecter n'importe quelle application ou outil d'IA à la passerelle et de bénéficier d'une gestion centralisée des clés et de statistiques d'utilisation. Pour les outils CLI courants, utiliser directement la prise de contrôle en un clic est encore plus simple.