cicora.ai
Especificación de la APIEventos enviados por el servidor

Streaming

Recibe tokens y deltas estructurados por SSE sin esperar la respuesta completa.

Referencia de integración: elige los parámetros y las capacidades disponibles en la configuración de la API de tu cuenta y en el catálogo de modelos de tu entorno.

Abre un flujo SSE

Activa stream: true y desactiva el búfer del cliente. El servidor envía eventos de datos conforme están disponibles las partes de la respuesta.

Procesa el flujo incrementalmente: un evento no tiene por qué contener texto terminado ni una llamada de herramienta completa.

Flujo SSE
bash
curl --no-buffer --request POST https://cicora.ai/api/v1/chat/completions \
  --header "Authorization: Bearer $CICORA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "openai/gpt-5.6-sol",
    "stream": true,
    "stream_options": {"include_usage": true},
    "messages": [{"role": "user", "content": "Write a three-line poem."}]
  }'

Ensambla los deltas

  • Acumula texto por choice/index o identificador de elemento.
  • Recopila argumentos de herramienta como flujo de fragmentos JSON y analízalos al terminar.
  • Cuando importen las métricas finales, activa explícitamente la opción de uso disponible en el flujo.

Finaliza y cancela

Considera completo el flujo solo tras un evento terminal. El cierre de la conexión sin él constituye una ruta de fallo distinta.

Vincula un AbortController o equivalente a la navegación del usuario para que una solicitud sin uso no permanezca abierta.