GloopAPI 接入指南
流式响应
消费流式事件与结束信号。
流式让应用逐段接收输出，不改变模型权限与计费。设置 stream: true 并消费 text/event-stream。不能把响应整体当成单个 JSON。
Responses 使用带 type 的事件，例如 response.output_text.delta 与 response.completed；须按事件类型解析。
按协议解析
Chat Completions 的 SSE data 为 JSON chunk，文本通常位于 choices[].delta，工具调用也可能分片。data: [DONE] 表示协议结束。请求 stream_options.include_usage 时可能收到最终用量 chunk，其 choices 可以为空；缺失用量不能解释为免费。
网络边界
一段网络字节不等于一个事件：先缓冲到空行分隔符，合并多行 data，再解析 JSON。处理 UTF-8 字符跨分片、空行、注释和错误事件。端点右侧示例展示该协议的事件形状。
断连或缺少结束事件时，将输出标为不完整；保留已经展示的文本与请求诊断信息。关闭连接不能保证请求没有执行，也不保证退款。未确认的同步文本请求不具备持久任务的恢复契约，不应自动再次发送。
用量与后续处理
收到正常结束后再提交完整结果；最终计费依据平台用量记录，不能由本地 chunk 数推算。若流在 HTTP 200 后报告错误，仍应按协议错误处理，不能只看初始状态。更多决策见错误处理与计费。