Gemini streamGenerateContent（流式）

POST

/v1beta/models/{model}:streamGenerateContent

Gemini 原生格式的流式内容生成接口。

请求体与 generateContent 完全一致，区别在于：

路径使用 :streamGenerateContent 替代 :generateContent

需添加查询参数 alt=sse 以获得 SSE 格式的流式响应

支持的模型与 generateContent 一致。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Path 参数

Query 参数

Body 参数application/json必填

示例

{
    "contents": [
        {
            "role": "user",
            "parts": [
                {
                    "text": "写一首关于春天的诗"
                }
            ]
        }
    ],
    "generationConfig": {
        "temperature": 1,
        "maxOutputTokens": 2048
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://maas.trainkr.cloud/v1beta/models/:streamGenerateContent?alt' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "contents": [
        {
            "role": "user",
            "parts": [
                {
                    "text": "写一首关于春天的诗"
                }
            ]
        }
    ],
    "generationConfig": {
        "temperature": 1,
        "maxOutputTokens": 2048
    }
}'

返回响应

🟢200

text/event-stream

SSE 流式返回，每个事件包含一个 GenerateContentResponse 对象

Body

示例

null

🟠400请求参数错误

🟠401鉴权失败

🟠403无权限访问

🟠404资源不存在

🟠429请求过于频繁，请稍后重试

🔴500服务内部错误

修改于 2026-03-29 14:06:31

Gemini generateContent（非流式）

聊天接口（通用）