Skip to main content
POST
GPT Responses (tous modèles, paramètres complets)
BaseURL : La BaseURL par défaut est 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.
Les outils côté serveur (web_search, code_interpreter, file_search, mcp) s’exécutent sur le serveur : le client n’a pas besoin d’en retransmettre les résultats, et ils ne sont proposés que sur cette API. Le point de terminaison Chat Completions ne prend en charge que les appels d’outils function ordinaires.
Remarque Cette API ne prend en charge que les modes synchrone et streaming : le mode asynchrone en arrière-plan background: true n’est pas pris en charge, et aucun point de terminaison ne permet de consulter, d’annuler ou de supprimer une réponse par son ID. Pour les générations longues, utilisez stream: true afin de maintenir la connexion ouverte.L’outil image_generation n’est pas disponible sur cette série de modèles ; pour la génération d’images, utilisez les API des modèles de la série image.
Conversations à plusieurs tours : transmettez l’id retourné au tour précédent comme previous_response_id du tour suivant pour poursuivre le contexte. Les réponses ont une durée de conservation ; une fois expirée, cet ID n’est plus valide et la requête est traitée comme une nouvelle conversation. Pour les scénarios exigeant une grande exactitude du contexte, il est recommandé de gérer vous-même l’historique complet de input.

Autorisations

Authorization
string
header
requis

##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

application/json
model
enum<string>
requis

Modèle à appeler :

Options disponibles:
gpt-5.6-sol,
gpt-5.6-terra,
gpt-5.6-luna,
gpt-5.5,
gpt-5.4,
gpt-5.2,
gpt-5.1
Exemple:

"gpt-5.6-sol"

input
requis

Entrée du modèle : une simple chaîne de caractères, ou un tableau d'éléments d'entrée.

Le content d'un élément d'entrée prend en charge deux types de blocs : input_text (texte) et input_image (image) :

Image

  • Transmettez dans image_url l'URL publique de l'image
  • image_url doit être une chaîne de caractères ; l'écrire sous la forme { "url": "..." } retourne 400
  • detail est au même niveau qu'image_url (et non imbriqué dedans) : auto (par défaut) / low / high / original
  • L'image doit pouvoir être téléchargée, sinon 400 est retourné

Résultats d'outils

  • Le tableau peut aussi contenir des éléments de résultat d'outils du tour précédent, comme function_call_output

Remarque Les types de blocs de cette API diffèrent de ceux de l'API Chat Completions (qui utilise text / image_url). Ils ne peuvent pas être mélangés ; une erreur de type retourne 400.

Exemple:

"Search for AI news from the past week and summarize it in three sentences."

instructions
string

Instructions au niveau système, équivalentes à insérer un message système tout au début de input. Lors de la poursuite d'une conversation avec previous_response_id, ce paramètre n'est pas hérité du tour précédent et doit être transmis à chaque tour.

Exemple:

"You are a concise assistant. Answer in no more than three sentences."

stream
boolean
défaut:false

Indique s'il faut renvoyer une réponse en streaming (événements SSE, se terminant par response.completed). Par défaut false.

Exemple:

false

max_output_tokens
integer

Nombre maximal de tokens à générer (tokens de raisonnement inclus). Lorsque la limite est atteinte, status vaut incomplete.

Exemple:

2048

reasoning
object

Contrôle du raisonnement.

Les valeurs possibles d'effort (profondeur de raisonnement) varient selon le modèle :

summary (résumé du raisonnement) : auto / concise / detailed, disponible sur toute la série. Une fois activé, un élément reasoning apparaît dans output.

mode (mode de raisonnement) : standard / pro, pris en charge uniquement par la famille gpt-5.6.

context (portée du contexte de raisonnement) : auto / current_turn / all_turns, pris en charge uniquement par la famille gpt-5.6.

Les tokens de raisonnement sont facturés comme des tokens de sortie et comptabilisés dans usage.output_tokens_details.reasoning_tokens.

text
object

Contrôle du texte de sortie :

  • format : {"type": "text"} (par défaut), {"type": "json_object"}, ou {"type": "json_schema", "name": "...", "schema": {...}, "strict": true} pour des résultats structurés
  • verbosity : low / medium / high, contrôle le niveau de détail de la réponse
tools
object[]

Déclaration des outils. Les outils côté serveur s'exécutent sur le serveur : le client n'a pas besoin d'en retransmettre les résultats :

Les outils function ordinaires (appels de fonctions côté client) sont également pris en charge.

Remarque image_generation n'est pas disponible sur cette série de modèles ; utilisez plutôt les API des modèles de la série image.

Exemple:
tool_choice

Contrôle la sélection de l'outil : "auto" (par défaut) / "none" / "required", ou un objet imposant un outil précis, par ex. {"type": "web_search"}.

Options disponibles:
none,
auto,
required
max_tool_calls
integer

Limite du nombre total d'appels d'outils autorisés dans cette réponse.

Exemple:

5

parallel_tool_calls
boolean
défaut:true

Indique si le modèle peut appeler plusieurs outils en parallèle au cours d'un même tour. Valeur par défaut true.

Remarque Seules la famille gpt-5.6 et gpt-5.5 permettent de le définir à false ; sur gpt-5.4 / gpt-5.2 / gpt-5.1, ce paramètre est sans effet et se comporte toujours comme true.

Exemple:

true

previous_response_id
string

L'id de la réponse précédente, utilisé pour enchaîner les tours de conversation sans retransmettre l'historique.

Remarque Doit être utilisé avec store: true (valeur par défaut). Les réponses ont une durée de conservation ; une fois expirée, cet ID n'est plus valide et la requête est traitée comme une nouvelle conversation, sans héritage du contexte. Pour les scénarios exigeant une grande exactitude du contexte, il est recommandé de gérer vous-même l'historique complet de input.

Exemple:

"resp_0f5c2b2c20c39e8a006a7ef545443081979e478b10927984b5"

store
boolean
défaut:true

Indique si cette réponse est conservée côté serveur ; seules les réponses conservées peuvent être référencées par previous_response_id. Valeur par défaut true.

Remarque Seules la famille gpt-5.6 et gpt-5.5 permettent de le définir à false ; sur gpt-5.4 / gpt-5.2 / gpt-5.1, ce paramètre est sans effet et se comporte toujours comme true. Si vous ne souhaitez pas de conservation, choisissez un modèle permettant de la désactiver.

Exemple:

true

include
string[]

Contenus supplémentaires à retourner dans la réponse. Valeurs possibles :

  • reasoning.encrypted_content
  • message.output_text.logprobs
  • web_search_call.results
  • web_search_call.action.sources
  • file_search_call.results
  • code_interpreter_call.outputs
  • message.input_image.image_url
  • computer_call_output.output.image_url
Exemple:
temperature
number

Température d'échantillonnage, valeurs de 0 à 2. Plus la valeur est basse, plus la sortie est déterministe.

Remarque Sur gpt-5.4 / gpt-5.2 / gpt-5.1, la valeur 0 est sans effet (elle est traitée comme non transmise et remplacée par la valeur par défaut 1) ; pour une sortie plus déterministe, utilisez une valeur supérieure à 0, comme 0.01.

Plage requise: 0 <= x <= 2
Exemple:

0.7

top_p
number

Paramètre d'échantillonnage nucléus, valeurs de 0 à 1. Il est déconseillé de l'ajuster en même temps que temperature.

Plage requise: 0 <= x <= 1
Exemple:

0.9

top_logprobs
integer

Nombre de tokens candidats retournés à chaque position, valeurs de 0 à 20 ; doit être utilisé avec include: ["message.output_text.logprobs"].

Remarque Pris en charge uniquement par la famille gpt-5.6 et gpt-5.5 ; les autres modèles ne prennent pas en charge ce paramètre.

Plage requise: 0 <= x <= 20
Exemple:

2

frequency_penalty
number

Pénalité de fréquence, valeurs de -2 à 2, réduit la probabilité de contenus répétitifs.

Remarque Prise en charge uniquement par la famille gpt-5.6 ; les autres modèles ne prennent pas en charge ce paramètre.

Plage requise: -2 <= x <= 2
Exemple:

0.5

presence_penalty
number

Pénalité de présence, valeurs de -2 à 2, encourage le modèle à aborder de nouveaux sujets.

Remarque Prise en charge uniquement par la famille gpt-5.6 ; les autres modèles ne prennent pas en charge ce paramètre.

Plage requise: -2 <= x <= 2
Exemple:

0.5

truncation
enum<string>
défaut:disabled

Traitement du contexte qui dépasse la fenêtre : disabled (par défaut, retourne directement une erreur) ou auto (tronque automatiquement la partie centrale).

Options disponibles:
auto,
disabled
Exemple:

"auto"

context_management
object[]

Configuration de compactage automatique des longues conversations, par exemple [{"type": "compaction", "compact_threshold": 100000}] : lorsque le contexte dépasse le seuil, l'historique est compacté automatiquement.

Remarque Pris en charge uniquement par la famille gpt-5.6 ; les autres modèles ne prennent pas en charge ce paramètre.

prompt_cache_key
string

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.

Exemple:

"app-agent-v1"

prompt_cache_retention
enum<string>

Politique de conservation du cache de prompts : in_memory (par défaut) ou 24h (prolonge la durée de conservation du cache).

Options disponibles:
in_memory,
24h
Exemple:

"in_memory"

prompt
object

Référence un modèle de prompt déjà créé, sous la forme {"id": "pmpt_xxx", "version": "1", "variables": {...}}.

metadata
object

Paires clé-valeur personnalisées retournées telles quelles avec la réponse, pratiques pour le marquage côté métier. Les clés et les valeurs sont des chaînes de caractères.

Exemple:
safety_identifier
string

Identifiant stable de l'utilisateur final, utilisé pour le suivi des abus.

Remarque Pris en charge uniquement par la famille gpt-5.6 ; les autres modèles ne prennent pas en charge ce paramètre.

Exemple:

"user-1024"

user
string

Identifiant de l'utilisateur final, utilisé pour distinguer l'origine des appels.

Exemple:

"user-1024"

Réponse

Réponse générée avec succès (objet JSON, ou flux d'événements SSE se terminant par response.completed lorsque stream=true)

id
string

Identifiant unique de cette réponse, utilisable comme previous_response_id au tour suivant

Exemple:

"resp_0f5c2b2c20c39e8a006a7ef545443081979e478b10927984b5"

object
enum<string>

Type de réponse

Options disponibles:
response
Exemple:

"response"

status
enum<string>

Statut de la réponse : completed pour une fin normale, incomplete lorsque la génération s'est arrêtée avant terme, par exemple en atteignant max_output_tokens, failed en cas d'échec de la génération

Options disponibles:
completed,
incomplete,
failed
Exemple:

"completed"

model
string

Nom du modèle réellement utilisé

Exemple:

"gpt-5.6-sol"

created_at
integer

Horodatage de création

Exemple:

1786705221

output
object[]

Éléments de sortie classés dans l'ordre de génération : l'élément reasoning (résumé du raisonnement / contenu de raisonnement chiffré), les éléments d'appel d'outils (comme web_search_call ou code_interpreter_call), puis enfin l'élément message contenant le contenu output_text.

incomplete_details
object

Explique la raison lorsque status vaut incomplete

usage
object

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.

metadata
object

Paires clé-valeur personnalisées transmises dans la requête, retournées telles quelles