Skip to main content
Cette page présente les règles communes à tous les appels de modèle. La référence API Apifox contient les schémas complets de requêtes et de réponses ; cette documentation 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. Si supported_endpoint_types est présent, il aide à identifier le type de protocole indiqué pour le modèle.

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.