Gemini nativ

Inhalte generieren

Generiert Inhalte unter Verwendung des Google Gemini API-Formats

POST
/v1beta/models/{model}:generateContent

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

modelstringpatherforderlich

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

Query-Parameter

keystringquery

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

Authentifizierung

Gemini-Endpunkte unterstützen mehrere Authentifizierungsmethoden:

  • ?key=YOUR_API_KEY Query-Parameter
  • x-goog-api-key: YOUR_API_KEY Header
  • Authorization: Bearer YOUR_API_KEY Header

Request-Body

contentsarrayerforderlich

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.

systemInstructionobject

Systemanweisung für das Modell.

generationConfigobject

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.

safetySettingsarray

Einstellungen für Sicherheitsfilter.

toolsarray

Gemini-Tools wie functionDeclarations. Die unterstützten Tool-Typen hängen vom Modell ab.

toolConfigobject

Tool-Konfiguration wie functionCallingConfig.

cachedContentstring

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

candidatesarray

Kandidaten für generierte Inhalte.

usageMetadataobject

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

Response
{
  "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.

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

application/json

application/json

application/json

application/json

application/json

application/json