Gemini nativ
Inhalte per Streaming generieren
Streamt die Inhaltsgenerierung im Format der Google Gemini API
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
Modellname (z. B. gemini-2.5-pro, gemini-3.5-flash).
Query-Parameter
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
{
"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..."
}
}
]
}
]
}API-Key-Authentifizierung. Erstellen oder verwalten Sie API-Keys unter Dashboard > API > API Keys.
Ort: header
Pfadparameter
Modellname (z. B. gemini-2.5-pro)
Abfrageparameter
API-Schlüssel (Alternative zur Header-Authentifizierung)
Header
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