Gemini 原生

流式生成内容

使用 Google Gemini API 格式流式生成内容

POST
/v1beta/models/{model}:streamGenerateContent

Gemini generateContent 的 SSE 版本。事件可能只有 metadata,也可能是没有 finishReason 的中间内容。流在自然 EOF 时结束,不附加 [DONE] 标记。

路径参数

modelstringpath必填

模型名称(例如,gemini-2.5-pro,gemini-3.5-flash)。

查询参数

keystringquery

API 密钥,也可以改用请求头认证。

身份验证

与生成内容相同:?key=、x-goog-api-key 或 Authorization: Bearer。

请求正文

与 生成内容 相同。包含视觉请求使用的多模态 parts 数组,其中图片为结构化的 inline_data 部分。

generationConfig.candidateCount、工具、媒体类型及其他可选字段是否可用,以所选模型为准。

响应

返回 Gemini Server-Sent Events。仅含 metadata 的事件、没有 finishReason 的中间块以及自然 EOF 都是有效的。流不会附加 Chat Completions 的 [DONE] 标记。每个事件是一行 data:,内容为一个 JSON 块。响应始终是 SSE;接受 alt=sse,但不是必需的。

流开始前出现的错误会返回 JSON 格式的 Gemini 错误,错误码与生成内容相同。

请求

curl -N -X POST "https://api.tokenlab.sh/v1beta/models/gemini-2.5-pro:streamGenerateContent?key=sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "parts": [{"text": "Tell me a story"}]
      }
    ]
  }'

响应

Stream Chunk
{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {"text": "Once upon a time"}
        ]
      }
    }
  ]
}

视觉输入示例

流式视觉请求与非流式端点使用完全相同的 contents[].parts[] 结构。

{
  "contents": [
    {
      "role": "user",
      "parts": [
        { "text": "请描述这张图片。" },
        {
          "inline_data": {
            "mime_type": "image/jpeg",
            "data": "/9j/4AAQSkZJRgABAQ..."
          }
        }
      ]
    }
  ]
}

授权

AuthorizationBearer <token>

API Key 身份验证。在 Dashboard > API > API Keys 中创建或管理 API Key。

位置: header

路径参数

model*string

模型名称 (例如 gemini-2.5-pro)

查询参数

key?string

API 密钥 (请求头身份验证的替代方案)

请求头

X-TokenLab-Delivery-Policy?string

单次请求的交付策略。覆盖 API 密钥和 Workspace 的默认设置。自动优先尝试 TokenLab Verified,并在输出、请求接受或持久资源创建之前,可能会切换一次至仅限 Official。

可选值

  • "auto"
  • "verified"
  • "official"

请求体

application/json

原生的 Gemini GenerateContent 请求。ProtoJSON 的 lowerCamelCase 和原始 proto 的 snake_case 名称均被接受并保留,包括混合请求。如果一个字段的两种拼写方式同时存在,TokenLab 不会合并它们或选择本地优先级。未知字段将尽力转发。

响应

text/event-stream

application/json

application/json

application/json

application/json

application/json