Skip to main content
POST
使用 Gemini 原生 streamGenerateContent API 以流式方式调用 Gemini 模型,适合需要边生成边展示的聊天、Agent 和长文本生成场景。

接口说明

该接口保留 Gemini 原生流式请求结构。响应可能表现为 JSON 流或 SSE,具体取决于客户端与上游通道。

路径参数

string
default:"gemini-2.5-pro"
required
Gemini 模型 ID,例如 gemini-2.5-progemini-2.0-flash。完整列表以 GET /v1/models 返回结果为准。

请求头

string
required
API Key 鉴权信息,格式为 Bearer YOUR_API_KEY
string
required
固定为 application/json

请求体

object[]
required
对话内容数组。
string
消息角色,常用值为 usermodel
object[]
required
内容片段数组,可包含文本、图片、文件或工具相关内容。
object
生成配置,例如 temperaturemaxOutputTokensresponseModalities
object[]
Gemini 原生工具定义。

响应体

object[]
模型候选输出片段数组。文本通常位于 candidates[0].content.parts[0].text
object
token 用量统计。部分流式片段中可能不会返回该字段。

错误码