Gemini API-Referenz

In dieser API-Referenz werden die Unary-, Streaming- und Echtzeit-APIs beschrieben, die Sie für die Interaktion mit den Gemini-Modellen verwenden können. Sie können die REST APIs in jeder Umgebung verwenden, die HTTP-Anfragen unterstützt. Informationen zu den ersten Schritten mit Ihrem ersten API-Aufruf finden Sie im Startleitfaden. Wenn Sie die Referenzen für unsere sprachspezifischen Bibliotheken und SDKs suchen, klicken Sie in der linken Navigationsleiste unter SDK-Referenzen auf den Link für die entsprechende Sprache.

Primäre Endpunkte

Die Gemini API ist in die folgenden Hauptendpunkte unterteilt:

  • Interaktionen (CreateInteraction) (empfohlen): Das empfohlene Standard-Primitive für die Entwicklung mit Gemini, optimiert für Agent-Workflows, serverseitige Statusverwaltung und komplexe multimodale Unterhaltungen mit mehreren Durchgängen.
  • Standardinhaltsgenerierung (generateContent): Ein Standard-REST-Endpunkt, der Ihre Anfrage verarbeitet und die vollständige Antwort des Modells in einem einzigen Paket zurückgibt. Das ist am besten für nicht interaktive Aufgaben geeignet, bei denen Sie auf das gesamte Ergebnis warten können.
  • Streaming-Inhaltsgenerierung (streamGenerateContent): Hier werden vom Server gesendete Ereignisse (SSE) verwendet, um Teile der Antwort an Sie zu senden, sobald sie generiert werden. Das sorgt für eine schnellere und interaktivere Nutzung von Anwendungen wie Chatbots.
  • Live API (BidiGenerateContent): Eine zustandsbehaftete WebSocket-basierte API für bidirektionales Streaming, die für Konversationsanwendungsfälle in Echtzeit entwickelt wurde.
  • Batchmodus (batchGenerateContent): Ein Standard-REST-Endpunkt zum Senden von Batches mit generateContent-Anfragen.
  • Einbettungen (embedContent): Ein Standard-REST-Endpunkt, der einen Texteinbettungsvektor aus der Eingabe Content generiert.
  • Gen Media APIs:Endpunkte zum Generieren von Medien mit unseren spezialisierten Modellen wie Imagen für die Bildgenerierung und Veo für die Videogenerierung. Gemini bietet diese Funktionen ebenfalls. Sie können über die generateContent API darauf zugreifen.
  • Plattform-APIs:Utility-Endpunkte, die Kernfunktionen wie Dateien hochladen und Tokens zählen unterstützen.

Authentifizierung

Alle Anfragen an die Gemini API müssen einen x-goog-api-key-Header mit Ihrem API-Schlüssel enthalten. Sie können mit wenigen Klicks einen in Google AI Studio erstellen.

Hier sehen Sie ein Beispiel für eine Anfrage mit dem API-Schlüssel im Header:

curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-3.5-flash:generateContent" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H 'Content-Type: application/json' \
  -X POST \
  -d '{
    "contents": [
      {
        "parts": [
          {
            "text": "Explain how AI works in a few words"
          }
        ]
      }
    ]
  }'

Eine Anleitung dazu, wie Sie Ihren Schlüssel mit den Gemini SDKs an die API übergeben, finden Sie im Leitfaden Gemini API-Schlüssel verwenden.