Skip to main content
POST /v1beta/models/{model}:streamGenerateContent?alt=sse 使用 x-goog-api-key 发送网关令牌，查询参数 alt=sse 选择 SSE。请求结构与非流式 generateContent 相同，路径动作不同；不要在请求体中添加 Chat 的 stream 代替它。 每个 SSE data 包含 Gemini 响应。文本和 functionCall 位于 candidates[].content.parts；检查 promptFeedback、候选索引和最终 finishReason，不能将 EOF 单独视为成功。工具定义见 tools[].functionDeclarations，结果通过 functionResponse 回传。 完整 Python SSE 与工具闭环示例包含两个运行模式、签名保留、可选 ID 关联与错误处理。规范只展开常用字段；不承诺 Live API、细粒度参数扩展或所有渠道均可用。 Read in English

​
媒体内容项

原生 contents[].parts[] 可以包含 inlineData: {mimeType, data} 或 fileData: {mimeType, fileUri}，前者使用纯 Base64；内容格式和来源必须受目标上游支持。videoMetadata、mediaResolution 是条件支持的原生扩展，不是网关统一转码或抽帧服务。 媒体输入不改变响应协议和完成检查。网关没有在已核查范围内提供 Gemini Files 上传/管理或 Interactions 端点；SDK 自动上传会产生额外的未支持请求。先使用 视频理解的完整非流式示例，流式输出仍按本接口 SSE 事件处理。

​
SSE 内置工具元数据

请求接受相同的有条件原生 googleSearch、urlContext、codeExecution 工具字段。原生 SSE 转发上游 JSON 事件。跨事件保留候选元数据和代码/结果 part，不要把全部事件扁平化成文本，也不要假设每个事件都有完整引用记录。已有文本/函数 SSE 示例没有实现这些内置工具消费者。先使用非流式内置工具示例；增加流式处理前需按原生协议累积字节偏移与来源关联。

授权

​
x-goog-api-key
string
header
必填

网关令牌 / Gateway token

路径参数

​
model
string
必填

裸模型 ID，不含 models/ 和动作后缀 / Bare model ID without models/ or an action suffix.

示例:

"YOUR_MODEL_ID"

查询参数

​
alt
enum<string>
必填

选择 SSE 传输 / Select SSE transport.

可用选项:
sse

请求体

application/json
​
contents
object[]
必填
Minimum array length: 1
​
systemInstruction
object
​
tools
object[]

响应

检查候选结束状态并处理流内错误 / Validate candidate finish status and in-stream errors.

The response is of type string.