文本生成-流

POST

/v1beta/models/gemini-3-pro-preview:streamGenerateContent

官方文档：https://ai.google.dev/gemini-api/docs/text-generation?hl=zh-cn#multi-turn-conversations

网站中的模型与调用示例

文本生成-流

官方文档：https://ai.google.dev/gemini-api/docs/text-generation?hl=zh-cn#multi-turn-conversations

请求参数

{
  "contentType": "application/json",
  "properties": {
    "contents": {
      "items": {
        "properties": {
          "parts": {
            "items": {
              "properties": {
                "text": {
                  "type": "string"
                }
              },
              "type": "object"
            },
            "type": "array"
          }
        },
        "type": "object"
      },
      "type": "array"
    }
  },
  "required": [
    "contents"
  ]
}

请求示例 · 示例

{
  "contents": [
    {
      "parts": [
        {
          "text": "Hello there"
        }
      ],
      "role": "user"
    }
  ],
  "generationConfig": {
    "temperature": 1,
    "thinkingConfig": {
      "includeThoughts": true,
      "thinkingBudget": 26240
    },
    "topP": 1
  },
  "systemInstruction": {
    "parts": [
      {
        "text": "You are a cat. Your name is Neko."
      }
    ]
  }
}

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Query 参数

Header 参数

Body 参数application/json

示例

文本生成-流文本生成-流 · 示例

{
    "systemInstruction": {
        "parts": [
            {
                "text": "You are a cat. Your name is Neko."
            }
        ]
    },
    "contents": [
        {
            "role": "user",
            "parts": [
                {
                    "text": "Hello there"
                }
            ]
        }
    ],
    "generationConfig": {
        "temperature": 1,
        "topP": 1,
        "thinkingConfig": {
            "includeThoughts": true,
            "thinkingBudget": 26240
        }
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

文本生成-流文本生成-流 · 示例

curl --location --globoff '/v1beta/models/gemini-3-pro-preview:streamGenerateContent?key={{YOUR_API_KEY}}&alt=sse' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "systemInstruction": {
        "parts": [
            {
                "text": "You are a cat. Your name is Neko."
            }
        ]
    },
    "contents": [
        {
            "role": "user",
            "parts": [
                {
                    "text": "Hello there"
                }
            ]
        }
    ],
    "generationConfig": {
        "temperature": 1,
        "topP": 1,
        "thinkingConfig": {
            "includeThoughts": true,
            "thinkingBudget": 26240
        }
    }
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "id": "resp_example",
    "object": "response",
    "status": "completed"
}

🟠400请求有误

🟠401没有权限

修改于 2026-10-24 18:33:06

视频理解-url [原生格式] 开发中

文本生成+思考-流

文本生成-流

网站中的模型与调用示例#

文本生成-流#

请求参数#

请求示例 · 示例#

请求参数

请求示例代码

返回响应

网站中的模型与调用示例

文本生成-流

请求参数

请求示例 · 示例