Gemini Stream Generate Content
使用 Gemini Stream Generate Content 接口接收 SSE 流式生成结果。
Stream Generate Content 接口使用与普通生成相同的 Content、Parts、Bearer 鉴权和生成配置,并通过单向 SSE 持续返回 GenerateContentResponse 数据块;它不同于基于 WebSocket 的双向 Live API。
客户端应按空行边界解析每个 SSE data:,再依次拼接文本或 Structured Output 片段,不能对完整响应流一次性执行 JSON.parse。中间数据块可能没有 finishReason;当 usageMetadata 出现时应保留最新值。相同的 responseId 用于关联同一次生成的所有数据块;如果 candidates 缺失,请检查 promptFeedback。
/v1beta/models/{model}:streamGenerateContent使用 SSE 持续返回 GenerateContentResponse 数据块。
Authorization
bearerAuth 在 Authorization Header 中使用 Bearer your-api-key。
In: header
Path Parameters
用于生成内容的模型 ID。路径中会自动组成 models/{model}。
"MODEL_ID"Query Parameters
选择 SSE 传输格式。该参数属于 URL 查询参数,不属于 GenerateContentRequest 请求体。
"sse"Value in
- "sse"
Request Body
Gemini 使用 Content 与 Parts 表达文本、多模态、工具和生成配置。
application/json使用 user 与 model Content 组织单轮或多轮文本对话。
- contents[]
- 按顺序排列的对话内容。
- parts[].text
- 每条消息中的文本内容。
- role
- 消息生产者,常用值为 user 或 model。
{
"contents": [
{
"role": "user",
"parts": [
{
"text": "你好!请介绍一下自己。"
}
]
}
]
}使用 Content 与 text Part 组织单轮或多轮文本对话。
Response Body
text/event-stream
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
SSE data 数据结构
以下字段描述单个 data: 事件中的 JSON,不代表整个 SSE 文本流。