Gemini 原生流式内容生成

POST

/v1beta/models/{model}:streamGenerateContent

使用 Gemini 原生流式接口。建议附加 ?alt=sse 并按 SSE 逐条解析 JSON。

请求参数

Path 参数

Query 参数

Body 参数application/json必填

示例

{
    "contents": [
        {
            "role": "user",
            "parts": [
                {
                    "text": "分步骤介绍向量检索流程。"
                }
            ]
        }
    ],
    "generationConfig": {
        "maxOutputTokens": 1200
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/v1beta/models/gemini-3.1-flash-image-preview:streamGenerateContent?alt=sse' \
--header 'Content-Type: application/json' \
--data '{
    "contents": [
        {
            "role": "user",
            "parts": [
                {
                    "text": "分步骤介绍向量检索流程。"
                }
            ]
        }
    ],
    "generationConfig": {
        "maxOutputTokens": 1200
    }
}'

返回响应

🟢200成功

text/event-stream

Gemini SSE 流式响应。每个 data: 事件包含一个部分生成结果。

Bodytext/event-stream

示例

data: {"candidates":[{"content":{"role":"model","parts":[{"text":"第一步："}]},"index":0}]}

data: {"candidates":[{"content":{"role":"model","parts":[{"text":"将文本转换为向量。"}]},"finishReason":"STOP","index":0}],"usageMetadata":{"totalTokenCount":42}}

🟠400请求有误

🟠401没有权限

🟠429

🔴500服务器错误

修改于 2026-08-11 12:29:51

创建聊天补全

创建 Responses 响应