generateContent（流式）

POST

/v1beta/models/{model}:{action}

Gemini 原生流式生成，端点 streamGenerateContent，用 Server-Sent Events（SSE）分块返回，边生成边推送。

路径里 {model} 填模型名（如 gemini-2.5-pro），{action} 固定为 streamGenerateContent，建议带查询参数 ?alt=sse。

请求体和 generateContent 一样：contents 里放对话内容。响应是多条 data: {...}，每条含增量的 candidates[0].content.parts[0].text，拼接起来就是完整回复。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

API Key

在 header 添加参数

x-api-key

示例：

x-api-key: ********************

Path 参数

Body 参数application/json必填

示例

{
    "contents": [
        {
            "parts": [
                {
                    "text": "用一句话介绍西湖"
                }
            ]
        }
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/v1beta/models/gemini-2.5-pro:streamGenerateContent' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "contents": [
        {
            "parts": [
                {
                    "text": "用一句话介绍西湖"
                }
            ]
        }
    ]
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{}

修改于 2026-07-22 02:14:57

claude-fable-5-1

gemini-omni-flash-preview 接口使用文档