流式响应
对话请求设置 stream: true,响应为 SSE(text/event-stream)。先按 首次调用 设置密钥和对话模型 ID。
发送请求
在 macOS/Linux 的 Bash 或 Zsh 中运行。-N 关闭 cURL 输出缓冲,--max-time 将整次请求限制在 120 秒内。
bash
: "${ZEROSEAL_API_KEY:?请先设置 ZEROSEAL_API_KEY}"
: "${ZEROSEAL_MODEL:?请先设置 ZEROSEAL_MODEL}"
curl -N --silent --show-error --max-time 120 \
--request POST 'https://gw.zeroseal.cn/v1/chat/completions' \
--header "Authorization: Bearer $ZEROSEAL_API_KEY" \
--header 'Content-Type: application/json' \
--write-out '\nHTTP %{http_code}\n' \
--data-binary @- <<JSON
{
"model": "$ZEROSEAL_MODEL",
"messages": [{"role": "user", "content": "用一句话介绍你自己。"}],
"max_completion_tokens": 1024,
"stream": true
}
JSON终端会逐块显示 data: {...},正常结束时通常收到 data: [DONE]。示例末尾的 HTTP 200 由 cURL 输出,不属于 SSE。
读取响应
按 SSE 事件边界(空行)读取 data: 内容,先判断 [DONE],再解析 JSON。不要把一次网络读取当作一个完整事件。
| 字段或标记 | 处理方式 |
|---|---|
choices[].delta.content | 追加非空文本;有些块只有角色、工具参数或思考字段 |
choices[].finish_reason | stop 表示生成结束,length 表示达到输出上限,tool_calls 表示需要执行工具;仍继续读取后续事件 |
usage | Gateway 自动设置 stream_options.include_usage: true;用量块可能有空 choices,也可能因断流而缺失 |
[DONE] | 上游发出的结束标记,不是 JSON |
字段定义见 OpenAI 流式响应。Gateway 原样转发上游事件,字段以模型支持范围为准。工具参数需收齐后再解析,流程见 兼容范围。
断流与费用
- 开始返回流式内容前失败,会返回 HTTP 错误和 JSON,按 错误排查 处理。
- 收到
200后仍可能断流。连接关闭不代表已收到完整响应;未收到结束标记时,保留已收到的内容并标记未完成。 - 客户端断开连接或超时后,Gateway 仍会继续读取上游。取得可信用量且计价有效时按实际用量结算;流正常结束或中断后仍无可信用量时退款。
重试会产生新请求,先查看 消费记录。