cicora.ai
Specifica APIEventi inviati dal server

Streaming

Ricevi token e delta strutturati tramite SSE senza attendere la risposta completa.

Riferimento per l'integrazione: scegli i parametri e le funzionalità disponibili dalle impostazioni API del tuo account e dal catalogo dei modelli per il tuo ambiente.

Apri uno stream SSE

Abilita stream: true e disabilita il buffering del client. Il server invia eventi di dati man mano che le parti della risposta diventano disponibili.

Elabora lo stream in modo incrementale: un evento non deve necessariamente contenere testo completo o una chiamata di strumento completa.

Stream 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."}]
  }'

Assembla i delta

  • Accumula il testo per scelta/indice o identificatore dell'elemento.
  • Raccogli gli argomenti dello strumento come stream di frammenti JSON e analizzali dopo il completamento.
  • Quando le metriche finali sono rilevanti, abilita esplicitamente l'opzione di utilizzo disponibile nello stream.

Completa e annulla

Considera lo stream completo solo dopo un evento terminale. Una connessione che si chiude senza tale evento costituisce un percorso di errore distinto.

Collega un AbortController o equivalente alla navigazione dell'utente, affinché una richiesta inutilizzata non resti aperta.