API tous modèles GPT - Référence complète Chat Completions
- API Chat Completions compatible OpenAI pour les modèles de texte de la série GPT ; le modèle précis est choisi via
model(toutes les valeurs possibles figurent dans le tableau comparatif du paramètremodel) - Toute la série est composée de modèles de raisonnement ; la profondeur se contrôle via
reasoning_effortet les tokens de raisonnement sont facturés comme des tokens de sortie - Le cache de prompts s’applique automatiquement : les tokens d’entrée servis depuis le cache sont facturés au tarif de cache, plus bas
- Prend en charge les modes synchrone et streaming (SSE)
- Prend en charge une entrée mixte texte et image, ainsi que les appels d’outils
function - Les outils côté serveur (recherche web, exécution de code, recherche documentaire, MCP) ne sont proposés que sur l’API Responses
- Remarque Le périmètre de prise en charge des paramètres d’échantillonnage (
temperature,top_p,logprobs, etc.) varie selon le modèle ; voir les notes de chaque paramètre ci-dessous
https://direct.evolink.ai, qui offre une meilleure prise en charge des modèles de texte et des connexions persistantes. https://api.evolink.ai est le point d’accès principal pour les services multimodaux et sert d’adresse de secours pour les modèles de texte.function ordinaires.stop (séquences d’arrêt) et web_search_options ne sont pris en charge par aucun modèle et retournent 400 s’ils sont transmis ; logit_bias ne s’applique pas à cette série de modèles.Le périmètre de prise en charge de temperature, top_p, frequency_penalty, presence_penalty, logprobs et verbosity varie selon le modèle : référez-vous aux notes de chaque paramètre ci-dessus.Autorisations
##Toutes les API nécessitent une authentification Bearer Token##
Obtenir une clé API :
Visitez la Page de gestion des clés API pour obtenir votre clé API
Ajouter à l'en-tête de requête :
Corps
Modèle à appeler :
gpt-5.6-sol, gpt-5.6-terra, gpt-5.6-luna, gpt-5.5, gpt-5.4, gpt-5.2, gpt-5.1 "gpt-5.6-sol"
Liste des messages de chat, prenant en charge le contexte multi-tours et l'entrée multimodale.
role peut valoir system / developer / user / assistant / tool.
content peut être une chaîne de caractères ou un tableau de blocs de contenu. Deux types de blocs sont pris en charge : text (texte) et image_url (image) :
Image
- Transmettez dans
image_url.urll'URL publique de l'image image_urlpeut aussi s'écrire directement sous forme de chaîne, équivalent à{ "url": "..." }detailcontrôle la précision d'analyse de l'image :auto(par défaut) /low/high/original- L'image doit pouvoir être téléchargée, sinon
400est retourné
Remarque Les types de blocs de cette API diffèrent de ceux de l'API Responses (qui utilise input_text / input_image). Ils ne peuvent pas être mélangés ; une erreur de type retourne 400.
Indique si la réponse est retournée en flux (flux d'événements SSE se terminant par data: [DONE]). Valeur par défaut false.
false
Nombre maximal de tokens à générer (tokens de raisonnement inclus).
Remarque Cette série de modèles utilise max_completion_tokens. Pour la compatibilité avec le code existant, transmettre uniquement max_tokens est automatiquement interprété comme max_completion_tokens ; en revanche, ne transmettez pas les deux champs à la fois — sur gpt-5.1 / gpt-5.2 / gpt-5.4, les transmettre ensemble retourne 400.
2048
Contrôle de la profondeur de raisonnement. Les valeurs possibles varient selon le modèle :
Les tokens de raisonnement sont facturés comme des tokens de sortie et comptabilisés dans usage.completion_tokens_details.reasoning_tokens.
none, low, medium, high, xhigh "medium"
Niveau de détail de la réponse : low / medium / high.
Remarque Pris en charge uniquement par gpt-5.6-sol / gpt-5.6-terra / gpt-5.6-luna / gpt-5.5 ; les autres modèles ne prennent pas en charge ce paramètre.
low, medium, high "low"
Température d'échantillonnage, valeurs de 0 à 2. Plus la valeur est basse, plus la sortie est déterministe.
Remarque Prise en charge uniquement par gpt-5.5 / gpt-5.4 / gpt-5.2 / gpt-5.1. La famille gpt-5.6 n'accepte que la valeur par défaut 1 ; toute autre valeur retourne 400.
0 <= x <= 20.7
Paramètre d'échantillonnage nucléus, valeurs de 0 à 1. Il est déconseillé de l'ajuster en même temps que temperature.
Remarque Pris en charge uniquement par gpt-5.5 / gpt-5.4 / gpt-5.2 / gpt-5.1 ; la famille gpt-5.6 ne prend pas en charge ce paramètre.
0 <= x <= 10.9
Pénalité de fréquence, valeurs de -2 à 2. Les valeurs positives pénalisent les tokens selon leur fréquence d'apparition et réduisent les contenus répétitifs.
Remarque Prise en charge uniquement par gpt-5.4 / gpt-5.2 / gpt-5.1 ; la famille gpt-5.6 et gpt-5.5 ne prennent pas en charge ce paramètre.
-2 <= x <= 20.5
Pénalité de présence, valeurs de -2 à 2. Les valeurs positives encouragent le modèle à aborder de nouveaux sujets.
Remarque Prise en charge uniquement par gpt-5.4 / gpt-5.2 / gpt-5.1 ; la famille gpt-5.6 et gpt-5.5 ne prennent pas en charge ce paramètre.
-2 <= x <= 20.5
Indique s'il faut retourner les probabilités logarithmiques de chaque token de sortie.
Remarque Pris en charge uniquement par gpt-5.4 / gpt-5.2 / gpt-5.1 ; la famille gpt-5.6 et gpt-5.5 ne prennent pas en charge ce paramètre.
true
Nombre de tokens candidats retournés à chaque position, valeurs de 0 à 5 ; doit être utilisé avec logprobs: true.
Remarque Même périmètre de prise en charge que logprobs.
0 <= x <= 52
Nombre de réponses candidates à générer, retournées sous forme de plusieurs entrées dans le tableau choices. Tous les tokens (y compris la sortie de chaque candidate) sont facturés.
1
Graine aléatoire. Avec la même graine et la même combinaison de paramètres, le modèle s'efforce de retourner des résultats cohérents (au mieux ; une reproductibilité totale n'est pas garantie).
42
Contrôle du format de sortie :
{"type": "text"}: texte libre, la valeur par défaut{"type": "json_object"}: retourne un JSON valide et exige que le motjsonfigure dansmessages, sinon400est retourné{"type": "json_schema", "json_schema": {...}}: retourne des résultats structurés conformes au JSON Schema fourni ; associez-le à"strict": truepour imposer la conformité au schéma
Liste d'outils, utilisée pour le Function Calling (appels de fonctions côté client, sans frais à l'appel).
Les outils côté serveur (recherche web, exécution de code, etc.) ne sont pas proposés sur cette API ; utilisez plutôt l'API Responses.
Contrôle du choix des outils : "auto" (par défaut) / "none" / "required", ou un objet désignant une fonction précise, comme {"type": "function", "function": {"name": "get_weather"}}.
none, auto, required Indique si le modèle peut appeler plusieurs outils en parallèle au cours d'un même tour. Valeur par défaut true ; avec false, les appels sont forcés un par un.
true
Clé de regroupement du cache. Transmettre la même valeur pour des requêtes partageant le même préfixe améliore le taux de succès du cache de prompts.
"app-chat-v1"
Identifiant de l'utilisateur final, utilisé pour distinguer l'origine des appels.
"user-1024"
Réponse
Génération de la conversation réussie (objet JSON ; avec stream=true, un flux d'événements SSE se terminant par data: [DONE])
Identifiant unique de cette conversation
"chatcmpl-CvJ2p8mQxK7nR4wS"
Type de réponse
chat.completion "chat.completion"
Horodatage de création
1786705221
Nom du modèle réellement utilisé
"gpt-5.6-sol"
Liste des résultats générés (sa longueur est égale à n dans la requête)
Statistiques d'utilisation des tokens. Le cache de prompts s'applique automatiquement ; les tokens d'entrée servis depuis le cache sont facturés au tarif de cache, plus bas.