文档 · 核心 API

流式 (SSE)

传 stream=true 即可拿到 OpenAI 兼容的 SSE 流。每个 chunk 含一个 delta，最后一个 chunk 之后是 [DONE] 哨兵。

§ 01

基础示例

curl https://api.cdgo.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-cdgo-..." \
  -H "Content-Type: application/json" \
  -N \
  -d '{
    "model": "gpt-4o-mini",
    "stream": true,
    "messages": [{"role":"user","content":"count to 5"}]
  }'

§ 02

线上协议

Content-Type: text/event-stream。每个事件为data: {json}。最后一个事件为data: [DONE]。我们不发自定义 event 名 ── 与 OpenAI 完全相同。

data: {"id":"...","choices":[{"index":0,"delta":{"role":"assistant","content":"1"}}]}

data: {"id":"...","choices":[{"index":0,"delta":{"content":" 2"}}]}

data: {"id":"...","choices":[{"index":0,"delta":{"content":" 3"}}]}

...

data: {"id":"...","choices":[{"index":0,"delta":{},"finish_reason":"stop"}],"cdgo":{"route":"gpt-4o-mini"}}

data: [DONE]

§ 03

断流处理

客户端断开连接后，我们会在 5 秒内停止上游计费。如果你正在写自己的客户端，请确保接收到 [DONE] 后再关闭连接，否则末尾的 usage 不会落账。