Skip to main content
Cette page présente les règles communes à tous les appels de modèle et explique quel protocole choisir et comment commencer sans risque.
Confirmez la capacité d’abordLes modèles disponibles dépendent du groupe de votre clé API, des restrictions de modèle et de l’état du service. Le catalogue global ne garantit pas qu’un modèle soit appelable avec une clé donnée.

​
Les trois valeurs nécessaires

Pour un client de type OpenAI, utilisez :
Pour un appel HTTP manuel, envoyez la clé dans Authorization :
Ne placez jamais une clé complète dans du code frontend, une capture, un chat ou un dépôt Git. Les règles d’URL varient selon le client : Claude Code utilise l’adresse sans /v1, tandis que Codex CLI utilise sa configuration Provider. Suivez le guide de l’outil client concerné.

​
Lister les modèles visibles par la clé

Copiez un ID depuis data[].id. Cette liste indique les modèles visibles actuellement par cette clé, pas tout le catalogue. data[].supported_endpoint_types énumère les protocoles de requête disponibles pour ce modèle. Utilisez uniquement un chemin dont le type est indiqué : openai pour Chat Completions, anthropic pour Messages, openai-response pour Responses et image-generation pour la génération d’images. Si plusieurs types sont présents, choisissez celui qui correspond à votre client.

​
Choisir le bon protocole

Un même nom de modèle n’accepte pas forcément tous les formats. Vérifiez le protocole dans la matrice des capacités, puis consultez :

​
Vérification minimale et nouvelles tentatives

  1. Listez les modèles puis envoyez une courte requête texte ou image minimale.
  2. Vérifiez l’ID, le groupe et le chemin avant d’ajouter des champs facultatifs, le streaming ou des lots.
  3. Conservez l’erreur, l’heure et le Request ID. Ne rejouez pas une requête non confirmée à haute fréquence.
Pour 401, vérifiez d’abord la clé. Pour 404, vérifiez un /v1 absent ou répété. Pour 400, vérifiez modèle, protocole et champs. Consultez l’auto-vérification pour la suite.