TokenLab

Gemini 原生

串流生成內容

使用 Google Gemini API 格式串流生成內容

POST
/v1beta/models/{model}:streamGenerateContent

Gemini generateContent 的 SSE 版本。事件可能僅包含中繼資料或沒有 finishReason 的中繼內容。串流在自然 EOF 處結束,且不會附加 [DONE] 標記。

路徑參數

modelstringpath必填

模型名稱(例如 gemini-2.5-pro、gemini-3.5-flash)。

查詢參數

keystringquery

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"}]
      }
    ]
  }'

回應

Stream Chunk
{
  "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..."
          }
        }
      ]
    }
  ]
}

授權

AuthorizationBearer <token>

API Key 驗證。請在 Dashboard > API > API Keys 建立或管理 API 金鑰。

位置: header

路徑參數

model*string

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

查詢參數

key?string

API 金鑰 (標頭驗證的替代方案)

請求標頭

X-TokenLab-Delivery-Policy?string

單次請求傳遞策略。會覆寫 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