流式生成内容

端点
POST/v1beta/models/{model}:streamGenerateContent

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

请求

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

参数

生成内容

响应

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

示例

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

错误

流开始前的错误(鉴权失败、模型不可用)按普通 JSON 错误返回,见流式输出

准备好了?三步即可开始登录控制台 · 购买额度 · 创建 API Key
DiscordGet community help instantly
流式生成内容 · 帮助文档