Una API para todosGuía de uso
Sitio web ↗
Guía de usoAPI y formatos

Elige el formato de API

Chat Completions o Responses: ¿cuál elegir?

Son dos formas de organizar la comunicación, no dos modelos. Es como explicar la misma tarea mediante mensajes o rellenando un formulario. Ambas partes deben entender el formato.

Formato de APIExplicación sencillaOpción en Harness
OpenAI Chat CompletionsOrganiza la conversación en mensajes: lo que has dicho, la herramienta solicitada por el modelo y el resultado que devuelve.openai-completions
OpenAI ResponsesSepara las respuestas de texto, las llamadas a herramientas y sus resultados en distintos tipos de registros para que la aplicación procese cada paso.openai-responses

OpenAI en el nombre se refiere al formato de la interfaz. Si eliges el modelo DeepSeek de este ejemplo, seguirá respondiendo DeepSeek; el formato no lo convierte en un modelo GPT.

Cuatro preguntas frecuentes

¿Responses hace que la IA sea más inteligente?

Cambiar el formato no mejora el modelo por sí solo. Cada aplicación y modelo puede admitir los formatos de manera distinta. La prueba no determinó cuál ofrece mejores respuestas.

¿Chat Completions solo sirve para conversar?

También permite usar herramientas. En Harness completamos una lectura, un cálculo, un guardado y una nueva lectura de comprobación. Las herramientas de Harness actúan y el modelo utiliza sus resultados para continuar.

¿Necesito Responses para ajustar el razonamiento?

No. Ambos formatos aceptaron los niveles enviados para este modelo. Aun así, debes activar los niveles en Harness, como en el paso 6. Cambiar el formato no activa el menú.

¿Elijo Chat Completions en cualquier otro agente?

Sigue la guía de cada aplicación y modelo. Estos resultados corresponden a la combinación probada de Harness y DeepSeek, no a todas las herramientas y modelos.

Anthropic Messages

Anthropic Messages es un tercer formato habitual en Claude Code, no un modelo. El cliente añade /v1/messages a la raíz, mientras que los ejemplos OpenAI incluyen /v1 en la dirección base. La guía de Codex usa Responses; Harness empieza con Chat Completions y Kimi Code sigue su type. Consulta la guía de tu herramienta y confirma la compatibilidad del modelo: cambiar de formato no añade herramientas ni niveles de razonamiento.

Continúa leyendo