Crea una respuesta
Una solicitud Responses contiene model e input. Input puede ser una cadena corta o un conjunto estructurado de elementos cuando el flujo lo requiera.
Diseña el controlador en torno al array de salida: el texto, una llamada a herramienta y los elementos de servicio pueden tener tipos distintos.
Solicitud de la API Responses
bash
curl --request POST https://cicora.ai/api/v1/responses \
--header "Authorization: Bearer $CICORA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "openai/gpt-5.6-sol",
"input": "Summarize the incident report for an engineer."
}'Controla el flujo de trabajo
- Guarda el ID de respuesta y el ID de conversación o sesión asociado en tu sistema.
- Limita los pasos automáticos de un bucle de agente en la aplicación.
- Comprueba los parámetros del modelo antes de añadir audio, imágenes o herramientas.
Analiza el resultado
No dependas de la posición de un elemento de texto. Recorre output, extrae tipos reconocidos y conserva los desconocidos para observabilidad.
Cuando necesites streaming, usa la forma de streaming del mismo flujo y combina los deltas solo por identificadores de elemento.