AGTCloud API Docs
文档指南API Reference集成与资源更新与帮助
文本与对话

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。

POST/v1beta/models/{model}:streamGenerateContent

使用 SSE 持续返回 GenerateContentResponse 数据块。

Authorization

bearerAuth
AuthorizationBearer <token>

在 Authorization Header 中使用 Bearer your-api-key。

In: header

Path Parameters

model*string

用于生成内容的模型 ID。路径中会自动组成 models/{model}。

Default"MODEL_ID"

Query Parameters

alt*"sse"

选择 SSE 传输格式。该参数属于 URL 查询参数,不属于 GenerateContentRequest 请求体。

Default"sse"

Value in

  • "sse"

Request Body

Gemini 使用 Content 与 Parts 表达文本、多模态、工具和生成配置。

application/json
文本对话

使用 user 与 model Content 组织单轮或多轮文本对话。

contents[]
按顺序排列的对话内容。
parts[].text
每条消息中的文本内容。
role
消息生产者,常用值为 user 或 model。
application/json
{
  "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 文本流。

Google Gemini Stream Generate Content 官方文档查看上游流式协议定义与最新字段变化。