2026-09-01

Migrar de Chat Completions a Responses API

Guía de producción: Migrar de Chat Completions a Responses API. Incluye un artefacto determinista, límites de fallo, controles de despliegue y fuentes verificadas.

Decisión primero

Migrar de Chat Completions a Responses API es un contrato explícito de producción, no un cambio aislado. Defina éxito, fallo terminal y rollback antes de mover tráfico; el artefacto separa evidencia de supuestos.

Empiece por endpoint, demuestre request_body con un caso determinista y convierta rollback en una condición de despliegue.

Artefacto reutilizable

Una fila solo pasa cuando la evidencia procede de la misma solicitud, ventana de prueba o versión de configuración.

Punto de control	Evidencia	Condición de aprobación
`endpoint`	`/v1/chat/completions->/v1/responses`	El valor se conserva y compara exactamente en el límite del protocolo.
`request_body`	`messages[]->input;response_format->text.format`	El valor se conserva y compara exactamente en el límite del protocolo.
`tool_result`	`tool_call_id->call_id;role:_tool->function_call_output`	El registro une una solicitud lógica y un intento concreto.
`zero_values`	`temperature:_0,stream:_false,empty_arrays`	El valor se conserva y compara exactamente en el límite del protocolo.
`state`	`previous_response_id_and_repeated_top-level_instructions`	Owner, fuente, fecha y limitación quedan registrados.
`rollback`	`old_endpoint_remains_selectable_during_bounded_rollout`	El límite es explícito y falla de forma cerrada.

Ejemplo resuelto

El ejemplo es sintético y determinista. Sustituya parámetros por valores revisados; no incluya secretos ni datos de clientes.

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

Procedimiento de implantación

Congele solicitud, respuesta, configuración y línea base observable.
Ejecute un caso positivo determinista y conserve el resultado completo.
Ejecute el caso negativo o límite correspondiente.
Una todos los intentos con un ID lógico y registre tiempo, estado final y uso sin contenido sensible.
Despliegue en una cohorte acotada con condiciones de parada.
Relea el estado duradero y el comportamiento público; revierta si falla una invariante.

Modos de fallo

Estos fallos invalidan el resultado aunque el HTTP exterior parezca correcto:

Se pierde un 0 o false explícito durante la serialización.
Se supone estado oculto que la ruta no conserva.
Se lee un campo cómodo y se pierden outputs tipados, tools, rechazos o resultados parciales.
Una sola respuesta de texto se toma como prueba de compatibilidad completa.

Límite de Modelflare

Modelflare centraliza rutas compatibles con OpenAI, claves, grupos, uso y fallos, pero una ruta configurada no prueba todas las capacidades del proveedor. Verifique modelo y canal por el protocolo nativo; conserve ceros explícitos y use la liquidación duradera como verdad de facturación.

Consulte la guía principal para el límite de decisión y la documentación para la configuración actual.

Lista previa a publicación

Responder primero a la pregunta principal.
Asignar un owner a cada campo, estado, métrica y fórmula.
Usar solo identificadores sintéticos.
Mantener estructura, código, límites y advertencias en todos los idiomas.
Revalidar contratos, soporte y precios en T-1; mover la fecha si cambia un hecho.
Antes de la hora, excluir la página de API pública, rutas y sitemap.

Fuentes y fecha de verificación

Fuentes verificadas el 2026-08-07; no demuestran compatibilidad de una ruta no probada.