Gemini nativ
Inhalte generieren
Generiert Inhalte unter Verwendung des Google Gemini API-Formats
Verwenden Sie die Gemini-Request- und Response-Formate mit einem Modell, das von Modelle auflisten zurückgegeben wird. Es werden sowohl ProtoJSON-lowerCamelCase als auch die entsprechenden snake_case-Feldnamen von Proto akzeptiert. Die unterstützten optionalen Felder und Werte hängen vom ausgewählten Modell ab.
Pfadparameter
Modellname (z. B. gemini-2.5-pro, gemini-3.5-flash).
Query-Parameter
API-Schlüssel (Alternative zur Authentifizierung per Header).
Authentifizierung
Gemini-Endpunkte unterstützen mehrere Authentifizierungsmethoden:
?key=YOUR_API_KEYQuery-Parameterx-goog-api-key: YOUR_API_KEYHeaderAuthorization: Bearer YOUR_API_KEYHeader
Request-Body
Konversationsinhalte mit parts und einer optionalen role. Medienanteile verwenden inlineData / inline_data oder fileData / file_data. Dateien und Cache-IDs, die von TokenLab erstellt wurden, können nur in dem Workspace verwendet werden, zu dem sie gehören.
Systemanweisung für das Modell.
Generierungseinstellungen wie temperature, topP, topK, maxOutputTokens, stopSequences, candidateCount, responseModalities, responseMimeType, responseSchema und thinkingConfig. Entsprechende snake_case-Namen werden ebenfalls akzeptiert. Unterstützte Werte und Kombinationen hängen vom Modell ab.
Einstellungen für Sicherheitsfilter.
Gemini-Tools wie functionDeclarations. Die unterstützten Tool-Typen hängen vom Modell ab.
Tool-Konfiguration wie functionCallingConfig.
Name von zwischengespeicherten Inhalten, die mit Zwischengespeicherte Inhalte erstellen erstellt wurden, zum Beispiel cachedContents/abc123. Dies funktioniert nur in dem Workspace, in dem sie erstellt wurden.
Jedes der oben gezeigten lowerCamelCase-Felder kann auch die offizielle snake_case-Schreibweise von Proto verwenden, zum Beispiel system_instruction, generation_config, safety_settings, tool_config, cached_content, file_data.file_uri und inline_data.mime_type.
Unterstützte Methoden
Die Gemini-kompatible API umfasst Modelle auflisten, Modell abrufen, generateContent, streamGenerateContent, countTokens, Dateien und zwischengespeicherte Inhalte. Gemini Interactions und Live sind nicht verfügbar.
Lesen Sie die Antwort des Modells über Modell abrufen, bevor Sie es aufrufen: supportedGenerationMethods listet die Aktionen auf, die das Modell akzeptiert.
Antwort
Kandidaten für generierte Inhalte.
Informationen zum Token-Verbrauch.
Anfrage
curl -X POST "https://api.tokenlab.sh/v1beta/models/gemini-2.5-pro:generateContent?key=sk-your-api-key" \
-H "Content-Type: application/json" \
-d '{
"contents": [
{
"parts": [{"text": "Hello, Gemini!"}]
}
],
"generationConfig": {
"temperature": 0.7,
"maxOutputTokens": 1024
}
}'Fehler
400 INVALID_ARGUMENT: Der Body ist ungültig oder das Modell akzeptiert keine Gemini-Anfragen.401 UNAUTHENTICATED: Der API-Schlüssel fehlt oder ist ungültig.402 RESOURCE_EXHAUSTED: Das Guthaben reicht für diese Anfrage nicht aus.503 UNAVAILABLE: Derzeit ist für das Modell keine Route verfügbar. Versuchen Sie es später erneut.
Medieneingabe
Platzieren Sie Medien innerhalb von contents[].parts[] als eingebettete Base64-Bytes (inlineData oder inline_data) oder als öffentliche https-URL (fileData oder file_data). Bild-, Audio- und Videodateien werden unterstützt.
Bild
Verwenden Sie eingebettete Bild-Bytes:
{
"contents": [
{
"role": "user",
"parts": [
{ "text": "Please describe this image." },
{
"inlineData": {
"mimeType": "image/jpeg",
"data": "/9j/4AAQSkZJRgABAQ..."
}
}
]
}
]
}Verwenden Sie eine Bild-URL:
{
"contents": [
{
"role": "user",
"parts": [
{ "text": "Please describe this image." },
{
"fileData": {
"mimeType": "image/jpeg",
"fileUri": "https://example.com/demo.jpg"
}
}
]
}
]
}Audio
Verwenden Sie eine Audio-URL, hier mit den Proto-snake_case-Namen:
{
"contents": [
{
"role": "user",
"parts": [
{ "text": "Transcribe and summarize this audio." },
{
"file_data": {
"mime_type": "audio/mpeg",
"file_uri": "https://example.com/sample.mp3"
}
}
]
}
]
}Video
Verwenden Sie eine Video-URL:
{
"contents": [
{
"role": "user",
"parts": [
{ "text": "Describe this video briefly." },
{
"fileData": {
"mimeType": "video/mp4",
"fileUri": "https://example.com/sample.mp4"
}
}
]
}
]
}Antwort
{
"candidates": [
{
"content": {
"role": "model",
"parts": [
{"text": "Hello! How can I assist you today?"}
]
},
"finishReason": "STOP",
"safetyRatings": [
{"category": "HARM_CATEGORY_HARASSMENT", "probability": "NEGLIGIBLE"}
]
}
],
"usageMetadata": {
"promptTokenCount": 5,
"candidatesTokenCount": 10,
"totalTokenCount": 15
}
}Token-Zählung und Embeddings
Token zählen (POST /v1beta/models/{model}:countTokens) benötigt einen API-Schlüssel und wird nicht berechnet. Verwenden Sie die Zählung für Ihre Planung; die Abrechnung einer Generierungsanfrage erfolgt über das Feld usageMetadata in der entsprechenden Antwort.
Embedding-Modelle verwenden Embedding erstellen (POST /v1/embeddings). Rufen Sie embedContent oder batchEmbedContents nur für ein Modell auf, dessen Antwort bei Modell abrufen diese in supportedGenerationMethods auflistet.
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
application/json
application/json
application/json
application/json
application/json
application/json