Gemini 原生
流式生成内容
使用 Google Gemini API 格式流式生成内容
Gemini generateContent 的 SSE 版本。事件可能只有 metadata,也可能是没有 finishReason 的中间内容。流在自然 EOF 时结束,不附加 [DONE] 标记。
路径参数
模型名称(例如,gemini-2.5-pro,gemini-3.5-flash)。
查询参数
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"}]
}
]
}'响应
{
"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..."
}
}
]
}
]
}API Key 身份验证。在 Dashboard > API > API Keys 中创建或管理 API Key。
位置: header
路径参数
模型名称 (例如 gemini-2.5-pro)
查询参数
API 密钥 (请求头身份验证的替代方案)
请求头
单次请求的交付策略。覆盖 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