Chat Completions est l’API standard à utiliser avec les derniers modèles d’OpenAI. Vous pouvez découvrir comment démarrer grâce à notre guide de développement sur la génération de texte.
Depuis le 11 mars 2025, nous avons publié les briques de base de notre nouvelle plateforme Agents. Pour plus de détails, consultez notre documentation API pour notre API Responses, les Tools, dont Web Search, File Search et Computer Use, ainsi que notre SDK Agents avec Tracing.
Des prompts aux messages
Pour avoir une conversation plus interactive et dynamique avec nos modèles, vous pouvez utiliser des messages au format chat au lieu du format d’invite (prompt) historique utilisé avec Completions.
Voici comment ça marche :
Au lieu d’envoyer une seule chaîne de caractères comme prompt, vous envoyez une liste de messages en entrée.
Chaque message de la liste a deux propriétés : role et content.
Le « role » peut prendre l’une de ces trois valeurs : « system », « user » ou « assistant »
Le « content » contient le texte du message associé au rôle.
L’instruction système peut fournir des consignes de haut niveau pour la conversation
Les messages sont traités dans l’ordre où ils apparaissent dans la liste, et l’assistant répond en conséquence.
Même des requêtes Completions basiques peuvent être effectuées via Chat Completions, comme vous pouvez le voir ci-dessous :
| Avant | Maintenant |
'prompt' : 'raconte-moi une blague' | 'messages': [{'role':'user', 'content':'raconte-moi une blague'}] |
Désormais, il est plus facile que jamais d’avoir des échanges aller-retour avec le modèle en allongeant la liste des messages dans la conversation.
'messages': [{'role':'user', 'content':'raconte-moi une blague'},
{'role':'assistant', 'content':'pourquoi le poulet a-t-il traversé la route'},
{'role':'user', 'content':'Je ne sais pas, pourquoi le poulet a-t-il traversé la route'}]Instructions système
Vous pouvez aussi utiliser une instruction au niveau système pour guider le comportement du modèle tout au long de la conversation. Par exemple, en utilisant une instruction système et un message comme celui-ci
'messages': [{'role':'system', 'content':'Tu es un assistant qui parle comme Shakespeare.'},
{'role':'user', 'content':'raconte-moi une blague'}, vous obtiendrez quelque chose comme
{...
'message': {'role':'assistant',
'content':'Pourquoi le poulet a-t-il traversé la route ? Pour aller de l’autre côté, mais en vérité, l’autre côté était plein de périls et de dangers, alors il revint promptement d’où il venait, foi de moi !'}
...}Si vous voulez explorer des options qui ne vous obligent pas à gérer vous-même l’historique de la conversation de messages, consultez l’API Assistants.