流式生成内容

端点

POST /v1beta/models/{model}:streamGenerateContent

与 生成内容 相同的请求体，改用本端点即可流式返回，响应为 text/event-stream。

请求

请求头与参数与生成内容完全相同。官方 SDK 与示例通常附加 ?alt=sse 查询参数；是否附加都返回 SSE。

参数

同 生成内容。

响应

每个分片是一行 data: {...}，结构与非流式响应一致（candidates、usageMetadata），文本在 candidates[0].content.parts[].text，逐片拼接即为完整回复。流结束时连接关闭，没有单独的结束标记。

示例

curl "https://caapi.top/v1beta/models/gemini-3.5-flash:streamGenerateContent?alt=sse" \
  -H "Authorization: Bearer sk-xxxxxx" \
  -H "content-type: application/json" \
  -d '{
    "contents": [
      {"role": "user", "parts": [{"text": "写一首五言绝句"}]}
    ]
  }'

错误

流开始前的错误（鉴权失败、模型不可用）按普通 JSON 错误返回，见 流式输出。