Migrer de Chat Completions vers Responses API

Guide de production : Migrer de Chat Completions vers Responses API. Il comprend un artefact déterministe, des limites d’échec, des contrôles de déploiement et des sources vérifiées.

Guide de production : Migrer de Chat Completions vers Responses API. Il comprend un artefact déterministe, des limites d’échec, des contrôles de déploiement et des sources vérifiées.

Décider d’abord

Migrer de Chat Completions vers Responses API est un contrat de production explicite, pas une modification isolée. Définissez réussite, échec terminal et rollback avant de déplacer le trafic ; l’artefact sépare preuve et hypothèse.

Commencez par endpoint, prouvez request_body avec un cas déterministe et faites de rollback une condition de mise en production.

Artefact réutilisable

Une ligne ne passe que si sa preuve vient de la même requête, fenêtre de test ou version de configuration.

Point de contrôle Preuve à conserver Condition de réussite
endpoint /v1/chat/completions->/v1/responses La valeur est préservée et comparée exactement à la frontière du protocole.
request_body messages[]->input;response_format->text.format La valeur est préservée et comparée exactement à la frontière du protocole.
tool_result tool_call_id->call_id;role:_tool->function_call_output Le relevé relie une requête logique et une tentative précise.
zero_values temperature:_0,stream:_false,empty_arrays La valeur est préservée et comparée exactement à la frontière du protocole.
state previous_response_id_and_repeated_top-level_instructions Owner, source, date et limite sont consignés.
rollback old_endpoint_remains_selectable_during_bounded_rollout La limite est explicite et l’échec est fermé.

Exemple détaillé

L’exemple est synthétique et déterministe. Utilisez vos valeurs revues, sans secret ni donnée client.

# Chat Completions
curl -sS https://modelflare.dev/v1/chat/completions \
  -H "Authorization: Bearer $MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"'"$MODEL_ID"'","messages":[{"role":"user","content":"Return OK"}],"stream":false}'

# Responses
curl -sS https://modelflare.dev/v1/responses \
  -H "Authorization: Bearer $MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"'"$MODEL_ID"'","input":"Return OK","stream":false}'

Procédure de mise en œuvre

  1. Figer requête, réponse, configuration et référence observable.
  2. Exécuter un cas positif déterministe et conserver le résultat complet.
  3. Exécuter le cas négatif ou limite associé.
  4. Relier les tentatives à un ID logique et consigner temps, état final et usage sans contenu sensible.
  5. Déployer sur une cohorte bornée avec critères d’arrêt.
  6. Relire l’état durable et le comportement public ; revenir en arrière si une invariance échoue.

Modes d’échec

Ces échecs invalident le résultat même si le HTTP externe semble réussir :

  • Un 0 ou false explicite disparaît à la sérialisation.
  • La route est supposée conserver un état caché.
  • Un champ pratique est lu et les sorties typées, tools, refus ou résultats partiels sont perdus.
  • Une réponse texte est prise pour une preuve complète de compatibilité.

Limite de Modelflare

Modelflare centralise routage compatible OpenAI, clés, groupes, usage et erreurs, mais une route configurée ne prouve aucune capacité optionnelle. Vérifiez modèle et canal par le protocole natif, conservez les zéros explicites et prenez le règlement durable comme vérité de facturation.

La page parente couvre la décision générale et la documentation la configuration actuelle.

Liste avant publication

  • Répondre à la question principale avant le contexte.
  • Nommer un owner pour chaque champ, état, métrique et formule.
  • N’utiliser que des identifiants synthétiques.
  • Conserver structure, code, limites et avertissements dans toutes les langues.
  • Revérifier contrats, support et prix à T-1 ; déplacer la date si un fait change.
  • Avant l’heure, exclure de l’API publique, des routes et du sitemap.

Sources et date de vérification

Sources vérifiées le 2026-08-07 ; elles ne prouvent pas une route non testée.