Skip to main content
POST
/
v1beta
/
models
/
{model}
:streamGenerateContent
curl -N -X POST "https://gogogotoken.ai/v1beta/models/gemini-2.5-pro:streamGenerateContent" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{
      "role": "user",
      "parts": [{ "text": "Write a haiku about the sea." }]
    }]
  }'

{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          { "text": "Blue waves breathe softly" }
        ]
      }
    }
  ]
}
使用 Gemini 原生 streamGenerateContent API 以流式方式调用 Gemini 模型，适合需要边生成边展示的聊天、Agent 和长文本生成场景。 
curl -N -X POST "https://gogogotoken.ai/v1beta/models/gemini-2.5-pro:streamGenerateContent" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{
      "role": "user",
      "parts": [{ "text": "Write a haiku about the sea." }]
    }]
  }'

{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          { "text": "Blue waves breathe softly" }
        ]
      }
    }
  ]
}

​
接口说明

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

​
路径参数

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

​
请求头

​
Authorization
string
required
API Key 鉴权信息，格式为 Bearer YOUR_API_KEY。
​
Content-Type
string
required
固定为 application/json。

​
请求体

​
contents
object[]
required
对话内容数组。
​
role
string
消息角色，常用值为 user 或 model。
​
parts
object[]
required
内容片段数组，可包含文本、图片、文件或工具相关内容。
​
generationConfig
object
生成配置，例如 temperature、maxOutputTokens、responseModalities。
​
tools
object[]
Gemini 原生工具定义。

​
响应体

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

​
错误码

状态码含义处理建议
401API Key 无效或未传检查请求头与令牌状态
403无权限访问目标 Gemini 模型检查 API Key 分组权限
429触发限速降低请求频率或调整套餐
5xx上游或网关异常稍后重试，并查看控制台日志