Skip to main content
TokenLab bietet diese Route nur für Modelle mit veröffentlichtem nativen Gemini-Vertrag und einer gleichartigen Upstream-Route an; ein Fallback auf Chat Completions findet nicht statt. ProtoJSON-lowerCamelCase und ursprüngliche proto-snake_case-Namen sind beide offiziell und werden auch in gemischten Anfragen erhalten. Unbekannte Felder werden bestmöglich weitergeleitet, und der Upstream entscheidet über ihre Unterstützung.

Pfadparameter

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

Abfrageparameter

string
API-Key (Alternative zur Header-Authentifizierung).

Authentifizierung

Gemini-Endpunkte unterstützen mehrere Authentifizierungsmethoden:
  • ?key=YOUR_API_KEY Abfrageparameter
  • x-goog-api-key: YOUR_API_KEY Header
  • Authorization: Bearer YOUR_API_KEY Header

Request-Body

array
erforderlich
Konversationsinhalte. role-Werte und alle parts bleiben unverändert; TokenLab führt weder trim/lowercase noch Base64-Umschreibung oder MIME-Erkennung durch. inlineData / inline_data und fileData / file_data sind offizielle Schreibweisen, und fileData.mimeType ist lokal nicht vorgeschrieben. Bei TokenLab Files- oder Cache-IDs werden Eigentum und ursprüngliche Upstream-Bindung geprüft; andere Medien- und Toolregeln bleiben beim Anbieter.
object
Systemanweisung für das Modell.
object
Native Generierungskonfiguration. lowerCamelCase-Namen wie maxOutputTokens, candidateCount und thinkingConfig sowie die entsprechenden snake_case-Namen werden unverändert akzeptiert. TokenLab entfernt thinkingConfig nicht nach einem Fehler und erzwingt kein lokales Streaming-Limit für candidateCount; der Upstream entscheidet über Bereiche und Kombinationen.
array
Einstellungen für Sicherheitsfilter.

Antwort

array
Generierte Inhaltskandidaten.
object
Informationen zur Token-Nutzung.

Beispiele für multimodale Eingaben

Bei multimodalen Gemini-Anfragen platzierst du Medien in contents[].parts[] und nutzt entweder Inline-Bytes oder URL-basierte Dateiverweise. Der öffentliche Gemini-Contract unterstützt derzeit folgende Medienkategorien:
  • Bild
  • audio
  • video
Für Inline-Medien verwende inlineData oder inline_data und übergib Base64-kodierte Dateibytes. Für URL-Medien verwende fileData oder file_data und übergib eine öffentlich erreichbare https-URL.

Beispiel für Bildeingabe

Beispiel für Audioeingabe

Beispiel für Videoeingabe

Video-Eingabebeispiel

Audio-Eingabebeispiel