Guias
Streaming
Respostas incrementais via Server-Sent Events.
Com "stream": true a resposta chega como Server-Sent Events: cada evento é uma linha data: {...} com um pedaço da mensagem, e o fluxo termina com data: [DONE].
cURL
curl -N https://api.semcensura.ia.br/v1/chat/completions \
-H "Authorization: Bearer $ISC_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "deepseek-v4.1-flash-fast", "messages": [{"role": "user", "content": "Olá!"}], "stream": true, "stream_options": {"include_usage": true}}'Formato dos eventos
SSE
data: {"object":"chat.completion.chunk","model":"deepseek-v4.1-flash-fast","choices":[{"index":0,"delta":{"role":"assistant","content":"Ol"},"finish_reason":null}],"usage":null}
data: {"object":"chat.completion.chunk","choices":[{"index":0,"delta":{"content":"á!"},"finish_reason":"stop"}],"usage":null}
data: {"object":"chat.completion.chunk","choices":[],"usage":{"prompt_tokens":9,"completion_tokens":3,"total_tokens":12}}
: isc-billing CAPTURED 41
data: [DONE]- O quadro com
choicesvazio eusagepreenchido só é enviado comstream_options.include_usage. - A linha de comentário
: isc-billing <estado> <micro-BRL>informa a cobrança final. Clientes SSE ignoram comentários. - Se o fornecedor interromper a geração, chega um evento
data: {"error": ...}antes do[DONE].
Proxies e timeouts
Desative o buffering do seu proxy reverso para repassar os eventos sem atraso. O gateway encerra a conexão se o fornecedor ficar muito tempo sem enviar dados.
Cancelamento
Fechar a conexão interrompe a geração. Os tokens já produzidos até ali são conciliados com o fornecedor e cobrados só depois da confirmação.