Guia de integração GloopAPI
Respostas em streaming
Consuma eventos de streaming e sinais de término.
O streaming entrega a saída em partes sem alterar permissões ou cobrança. Defina stream: true e consuma text/event-stream. Não interprete toda a resposta como um único documento JSON.
Responses usa eventos tipados como response.output_text.delta e response.completed; interprete cada evento pelo tipo.
Analise conforme o protocolo
Em Chat Completions, data do SSE contém fragmentos JSON. O texto geralmente fica em choices[].delta, e chamadas de ferramentas também podem ser fragmentadas. data: [DONE] marca o fim. Ao solicitar stream_options.include_usage, pode chegar um fragmento final de uso com choices vazio; ausência de uso não significa gratuidade.
Limites de rede
Um bloco de bytes da rede não equivale a um evento: armazene até o separador de linha em branco, una as linhas data e analise o JSON. Trate caracteres UTF-8 divididos entre blocos, linhas vazias, comentários e erros do serviço. Os exemplos à direita do endpoint mostram as estruturas de eventos do protocolo.
Se houver desconexão ou faltar o evento final, marque a saída como incompleta e preserve o texto mostrado e os diagnósticos. Fechar a conexão não garante que o serviço não executou nem que haverá reembolso. Solicitações síncronas de texto não confirmadas não têm o contrato de recuperação de tarefas persistentes e não devem ser reenviadas automaticamente.
Uso e processamento posterior
Confirme o resultado completo apenas após um término normal. A cobrança final usa os registros de uso da plataforma e não pode ser inferida pela quantidade local de fragmentos. Se o stream informar erro depois de HTTP 200, trate como erro de protocolo, sem considerar apenas o status inicial. Consulte Tratamento de erros e Faturamento.