API Reference
Streaming 与 SSE
流式请求返回逐步事件，适合降低首 Token 等待时间，但不会改变额度计量。
设置 stream: true，使用支持 SSE 的客户端逐事件消费；客户端取消时关闭上游连接。
- 模式
- SSE / stream
- cURL
- -N
- 超时
- 首 Token + 长响应
- 重试
- 有限且可去重
发起流式请求
Streaming
bashcurl -N "https://api.51cowork.com/v1/chat/completions" \
-H "Authorization: Bearer <key-from-dashboard>" \
-H "Content-Type: application/json" \
-d '{"model":"<model-from-v1-models>","stream":true,"messages":[{"role":"user","content":"Hello"}]}'客户端消费
- 逐个读取 event 或 chunk，不要先聚合完整响应。
- 记录自己的业务 request ID，并关联网关 request_id。
- 收到部分内容后发生错误时，保留已收到事件用于诊断。
取消与重试
| 情况 | 处理 |
|---|---|
| 用户取消 | 传播 AbortSignal 或关闭 response body |
| 首 Token 超时 | 增加读取超时并检查网关可达性 |
| 中途断开 | 不要默认从头重试，避免重复费用 |
| 429 / 临时 5xx | 读取 Retry-After，有限退避 |