Gemini 原生
串流生成內容
使用 Google Gemini API 格式串流生成內容
Gemini generateContent 的 SSE 版本。事件可能僅包含中繼資料或沒有 finishReason 的中繼內容。串流在自然 EOF 處結束,且不會附加 [DONE] 標記。
路徑參數
模型名稱(例如 gemini-2.5-pro、gemini-3.5-flash)。
查詢參數
API key(標頭驗證的替代方案)。
驗證
與 生成內容 相同:?key=、x-goog-api-key 或 Authorization: Bearer。
請求主體
與 生成內容 相同。這包含用於視覺請求、帶有結構化 inline_data 影像組件的多模態 parts 陣列。
對 generationConfig.candidateCount、工具、媒體類型及其他選填欄位的支援取決於所選的模型。
回應
傳回 Gemini Server-Sent Events。僅包含中繼資料的事件、沒有 finishReason 的中繼區塊以及自然 EOF 均為有效。串流不會附加 Chat Completions 的 [DONE] 標記。每個事件皆為一行包含一個 JSON 區塊的 data:。回應一律為 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": "Please describe this image." },
{
"inline_data": {
"mime_type": "image/jpeg",
"data": "/9j/4AAQSkZJRgABAQ..."
}
}
]
}
]
}API Key 驗證。請在 Dashboard > API > API Keys 建立或管理 API 金鑰。
位置: header
路徑參數
模型名稱 (例如 gemini-2.5-pro)
查詢參數
API 金鑰 (標頭驗證的替代方案)
請求標頭
單次請求傳遞策略。會覆寫 API key 與 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