Gemini nativ

Inhalte per Streaming generieren

Streamt die Inhaltsgenerierung im Format der Google Gemini API

POST
/v1beta/models/{model}:streamGenerateContent

SSE-Version von Gemini generateContent. Events dürfen ausschließlich Metadaten oder Zwischeninhalte ohne finishReason enthalten. Der Stream endet beim natürlichen EOF und hängt keine [DONE]-Markierung an.

Pfadparameter

modelstringpatherforderlich

Modellname (z. B. gemini-2.5-pro, gemini-3.5-flash).

Query-Parameter

keystringquery

API-Schlüssel (Alternative zur Authentifizierung über Header).

Authentifizierung

Genauso wie bei Inhalte generieren: ?key=, x-goog-api-key oder Authorization: Bearer.

Request-Body

Genauso wie bei Inhalte generieren. Dies umfasst multimodale parts-Arrays mit strukturierten inline_data-Bildteilen für Vision-Anfragen.

Die Unterstützung für generationConfig.candidateCount, Tools, Medientypen und andere optionale Felder hängt vom ausgewählten Modell ab.

Antwort

Gibt Server-Sent Events von Gemini zurück. Reine Metadaten-Events, Zwischen-Chunks ohne finishReason und ein natürliches EOF sind gültig. Der Stream hängt nicht den [DONE]-Sentinel von Chat Completions an. Jedes Event ist eine data:-Zeile, die einen JSON-Chunk enthält. Die Response ist immer SSE; alt=sse wird akzeptiert, ist aber nicht erforderlich.

Ein Fehler vor dem ersten Event gibt einen JSON-Gemini-Fehler mit denselben Codes wie bei Inhalte generieren zurück.

Anfrage

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

Antwort

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

Beispiel für Vision-Eingabe

Streaming-Vision-Anfragen verwenden dieselbe contents[].parts[]-Struktur wie der Nicht-Streaming-Endpunkt.

{
  "contents": [
    {
      "role": "user",
      "parts": [
        { "text": "Please describe this image." },
        {
          "inline_data": {
            "mime_type": "image/jpeg",
            "data": "/9j/4AAQSkZJRgABAQ..."
          }
        }
      ]
    }
  ]
}

Autorisierung

AuthorizationBearer <token>

API-Key-Authentifizierung. Erstellen oder verwalten Sie API-Keys unter Dashboard > API > API Keys.

Ort: header

Pfadparameter

model*string

Modellname (z. B. gemini-2.5-pro)

Abfrageparameter

key?string

API-Schlüssel (Alternative zur Header-Authentifizierung)

Header

X-TokenLab-Delivery-Policy?string

Zustellungsrichtlinie pro Anfrage. Überschreibt die API-Key- und Workspace-Standardeinstellungen. Versucht automatisch zuerst TokenLab Verified und kann vor der Ausgabe, der Annahme der Anfrage oder der Erstellung persistenter Ressourcen einmalig auf Official umstellen.

Zulässige Werte

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

Anfragekörper

application/json

Native Gemini GenerateContent-Anfrage. ProtoJSON lowerCamelCase und originale proto snake_case-Namen werden beide akzeptiert und beibehalten, einschließlich gemischter Anfragen. Wenn beide Schreibweisen eines Feldes vorhanden sind, führt TokenLab keine Zusammenführung durch und wählt keine lokale Priorität. Unbekannte Felder werden nach bestem Bemühen weitergeleitet.

Antwort

text/event-stream

application/json

application/json

application/json

application/json

application/json