Gemini API-Referenz

In dieser API-Referenz werden die unären, Streaming- und Echtzeit-APIs beschrieben, mit denen Sie mit den Gemini-Modellen interagieren können. Sie können die REST APIs in jeder Umgebung verwenden, die HTTP-Anfragen unterstützt. Im Startleitfaden erfahren Sie, wie Sie Ihren ersten API-Aufruf starten. 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 um die folgenden Hauptendpunkte herum organisiert:

  • Interaktionen (CreateInteraction) (empfohlen): Das empfohlene Standard-Primitive für die Entwicklung mit Gemini, optimiert für Agentic Workflows, serverseitige Statusverwaltung und komplexe multimodale Mehrfachdialoge.
  • Standardmäßige Inhaltserstellung (generateContent): Ein Standard-REST-Endpunkt, der Ihre Anfrage verarbeitet und die vollständige Antwort des Modells in einem einzigen Paket zurückgibt. Dies ist am besten für nicht interaktive Aufgaben geeignet, bei denen Sie auf das gesamte Ergebnis warten können.
  • Streaming-Inhaltserstellung (streamGenerateContent): Verwendet vom Server gesendete Ereignisse (SSE, Server-Sent Events), um Teile der Antwort an Sie zu senden, sobald sie generiert werden. Dies bietet eine schnellere und interaktivere Erfahrung für Anwendungen wie Chatbots.
  • Live API (BidiGenerateContent): Eine zustandsbehaftete WebSocket-basierte API für bidirektionales Streaming, die für Echtzeit-Unterhaltungen entwickelt wurde.
  • Batchmodus (batchGenerateContent): Ein Standard-REST Endpunkt zum Senden von Batches von 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 auch diese Funktionen, auf die Sie mit der generateContent-API zugreifen können.
  • Plattform-APIs: Hilfsendpunkte, die Kernfunktionen wie das Hochladen von Dateien und das Zählen von Tokens 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 einen solchen Schlüssel mit wenigen Klicks in Google AI Studio erstellen.

Im Folgenden sehen Sie eine Beispielanfrage 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 zum Übergeben Ihres Schlüssels an die API mit Gemini SDKs, siehe den Leitfaden API-Schlüssel für Gemini verwenden.