Responses API ou Chat Completions : quel format choisir ?

Comparez formats de requête, streaming, outils et compatibilité des fournisseurs avant de choisir Responses API ou Chat Completions pour une application d’IA.

Responses API ou Chat Completions : quel format choisir ?

Responses API et Chat Completions envoient tous deux des prompts à des modèles de langage, mais organisent différemment les entrées, les sorties, les outils et le streaming. Le choix doit partir du contrat entre le client et le modèle, et non de l’hypothèse qu’un endpoint plus récent fonctionne automatiquement chez tous les fournisseurs.

La règle de décision la plus simple est la suivante :

  • Utilisez Responses API pour un agent de code ou une application qui attend déjà des éléments Responses, des événements d’outils et le cycle de vie du streaming Responses.
  • Utilisez Chat Completions pour les clients de chat largement compatibles et pour les familles de fournisseurs qui exposent leurs modèles au format OpenAI via une transmission directe Chat Completions.

Vérifiez toujours le format d’API pris en charge par le modèle sélectionné dans Modèles et tarifs.

Comparaison des protocoles

Question Responses API Chat Completions
Forme principale de l’entrée input et éléments d’entrée typés Un tableau messages
Modèle de sortie Éléments de sortie et événements typés Choix de messages de l’assistant et deltas
Streaming Flux d’événements Responses Flux de fragments Chat Completions
Activité des outils Éléments typés d’appel d’outil et de sortie d’outil Appels d’outils rattachés aux messages de l’assistant
Cas idéal Agents, outils de code et applications natives Responses Clients de chat et fournisseurs compatibles OpenAI largement pris en charge
Portabilité des modèles Uniquement les modèles vérifiés pour Responses Uniquement les modèles vérifiés pour Chat Completions

Le tableau décrit le contrat d’échange. Il ne signifie pas que Modelflare convertit chaque fonctionnalité d’un fournisseur entre les deux formats.

Quand Responses API est le meilleur choix

Choisissez /v1/responses lorsque le client traite déjà l’exécution d’un modèle comme une suite d’éléments typés plutôt que comme un seul message de l’assistant. C’est courant dans les agents de code qui doivent distinguer le texte visible, les résumés de raisonnement, les arguments de fonction, les entrées d’outils personnalisés et d’autres événements.

Une requête minimale se présente ainsi :

curl -sS https://modelflare.dev/v1/responses \
  -H "Authorization: Bearer $MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-sol",
    "input": "List the three checks to make before an API migration.",
    "stream": true
  }'

Le streaming Responses doit être validé de bout en bout. Un client qui comprend les fragments Chat Completions mais pas les événements Responses peut se connecter correctement sans pour autant afficher de sortie utile.

Quand Chat Completions est le choix le plus sûr

Choisissez /v1/chat/completions lorsque l’application s’articule autour des messages system, user, assistant et tool, ou lorsque la famille de fournisseurs sélectionnée documente un endpoint Chat Completions compatible OpenAI.

curl -sS https://modelflare.dev/v1/chat/completions \
  -H "Authorization: Bearer $MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_CHAT_MODEL",
    "messages": [
      {"role": "system", "content": "Answer concisely."},
      {"role": "user", "content": "What should an API health check verify?"}
    ],
    "stream": true
  }'

Pour les familles de fournisseurs autres qu’OpenAI, Modelflare peut proposer une transmission directe Chat Completions afin que des champs de requête privés, comme les réglages de raisonnement ou de recherche propres au fournisseur, parviennent tels quels au service du fournisseur amont. Ce comportement est volontairement plus restreint qu’une compatibilité Responses complète.

Ne pas choisir sur le seul nom du modèle

Trois vérifications distinctes sont nécessaires :

  1. La clé API a accès au modèle. L’accès dépend de la clé et des groupes de modèles disponibles.
  2. Le modèle prend en charge l’endpoint. Un modèle présent dans /v1/models n’est pas automatiquement valide pour les deux formats de requête.
  3. Le client comprend le flux. Les événements Responses et les fragments Chat Completions sont deux contrats client différents.

Si l’une de ces vérifications échoue, changer uniquement le chemin de l’endpoint peut transformer une erreur de compatibilité explicite en réponse vide ou partiellement affichée.

Migrer les outils et la sortie structurée

Avant de déplacer une intégration existante :

  • comparez le schéma de définition des outils utilisé par le client ;
  • vérifiez comment les ID d’appel d’outil et les sorties d’outils sont renvoyés ;
  • conservez les valeurs facultatives explicites au lieu de supprimer 0 ou false ;
  • vérifiez si le fournisseur exige des champs privés qui doivent être transmis sans modification ;
  • testez les réponses composées uniquement d’appels d’outils, qui peuvent ne contenir aucun delta de texte visible ;
  • confirmez la façon dont le client détecte la fin de la réponse et l’utilisation.

Obtenir un texte similaire avec le même prompt ne suffit pas à tester un protocole. Un vrai test doit inclure les fonctionnalités dont dépend l’application.

Un parcours de sélection pratique

  1. Ouvrez Modèles et tarifs et choisissez le modèle et le groupe.
  2. Confirmez le format d’API pris en charge.
  3. Suivez un guide propre au client dans la documentation Modelflare lorsqu’il en existe un.
  4. Envoyez une requête sans streaming.
  5. Envoyez une requête en streaming.
  6. Testez les outils ou la sortie structurée.
  7. Examinez la requête dans les journaux d’utilisation : statut, temps, utilisation des tokens et coût.

Responses API ne remplace pas Chat Completions dans tous les cas, et Chat Completions n’est pas obsolète. Le bon format est celui que prennent en charge à la fois le client, le modèle sélectionné et le contrat du fournisseur amont.

Une fois le format choisi, utilisez le guide du streaming des API d’IA pour implémenter le parseur d’événements, les mesures temporelles, l’annulation et la politique de délais d’expiration correspondants.