Vai al contenuto
NotHolyDocs

Guide

Streaming

Ricevi i token mentre vengono generati con i server-sent events, in tutti i formati dell'API.

Vedi in Markdown

Imposta stream: true. La risposta è text/event-stream. Gli eventi arrivano uno alla volta, senza buffer.

curl -N https://api.notholy.com/v1/chat/completions \
  -H "Authorization: Bearer $NOTHOLY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "notholy-specter", "stream": true, "stream_options": {"include_usage": true}, "messages": [{"role": "user", "content": "Define XSS."}]}'

Cosa aspettarti

  • Chat completions e completamenti di testo finiscono con data: [DONE]. Il chunk precedente contiene sempre usage, con o senza include_usage.
  • Responses finisce con response.completed (o response.incomplete al limite di output). Messages finisce con message_delta e message_stop. Nessuno dei due invia [DONE].
  • Durante le pause lunghe arrivano commenti keep-alive (formati OpenAI) o eventi ping (Messages).
  • Se lo stream si interrompe, paghi solo i token generati prima dell'interruzione.
  • Gli errori trovati prima che lo stream parta (chiave, crediti, limiti) tornano come normale errore JSON con il suo stato HTTP. Un guasto dopo la partenza dello stream arriva come evento di errore nello stesso formato: data: {"error": ...}, response.failed o un evento error.

Prossimi passi