Kurzanleitung: Gemini API

In dieser Kurzanleitung erfahren Sie, wie Sie unsere Bibliotheken installieren und Ihre erste Gemini API-Anfrage mit der Interactions API senden.

Hinweis

Wenn Sie die Gemini API verwenden möchten, benötigen Sie einen API-Schlüssel, um Ihre Anfragen zu authentifizieren, Sicherheitslimits zu erzwingen und die Nutzung für Ihr Konto zu verfolgen.

Erstellen Sie kostenlos einen in AI Studio, um loszulegen:

Gemini API-Schlüssel erstellen

Google GenAI SDK installieren

Python

Installieren Sie mit Python 3.9 oder höher das google-genai Paket mit dem folgenden pip-Befehl:

pip install -q -U google-genai

JavaScript

Installieren Sie mit Node.js Version 18 oder höher das Google Gen AI SDK für TypeScript und JavaScript mit dem folgenden npm-Befehl:

npm install @google/genai

Erste Anfrage senden

Es gibt zwei Möglichkeiten, eine Anfrage an die Gemini API zu senden:

  • (Empfohlen) Die Interactions API ist ein neues Primitiv mit nativer Unterstützung für die mehrstufige Toolnutzung, Orchestrierung und komplexe Argumentationsabläufe durch typisierte Ausführungsschritte. Künftig werden neue Modelle, die über die Hauptmodellfamilie hinausgehen, sowie neue agentische Funktionen und Tools ausschließlich über die Interactions API eingeführt.
  • generateContent bietet eine Möglichkeit, eine einfache, zustandslose Antwort von einem Modell zu generieren. Wir empfehlen zwar die Verwendung der Interactions API, aber generateContent wird vollständig unterstützt.

In diesem Beispiel wird die Interactions API verwendet, um eine Anfrage an die Gemini API mit dem Modell Gemini 3 Flash zu senden.

Wenn Sie Ihren API-Schlüssel als die Umgebungsvariable GEMINI_API_KEY festlegen, wird er vom Client automatisch ausgewählt, wenn Sie die Gemini API-Bibliotheken verwenden. Andernfalls müssen Sie Ihren API-Schlüssel als Argument beim Initialisieren des Clients übergeben.

Beachten Sie, dass in allen Codebeispielen in der Gemini API-Dokumentation davon ausgegangen wird, dass Sie die Umgebungsvariable GEMINI_API_KEY festgelegt haben.

Python

# This will only work for SDK newer than 2.0.0
from google import genai

# The client gets the API key from the environment variable `GEMINI_API_KEY`.
client = genai.Client()

interaction = client.interactions.create(
    model="gemini-3-flash-preview", 
    input="Explain how AI works in a few words"
)

# Print the model's text response
for step in interaction.steps:
    if step.type == "model_output":
        for content_block in step.content:
            if content_block.type == "text":
                print(content_block.text)

JavaScript

// This will only work for SDK newer than 2.0.0
import { GoogleGenAI } from "@google/genai";

// The client gets the API key from the environment variable `GEMINI_API_KEY`.
const ai = new GoogleGenAI({});

async function main() {
  const interaction = await ai.interactions.create({
    model: "gemini-3-flash-preview",
    input: "Explain how AI works in a few words",
  });

  const modelStep = interaction.steps.find(s => s.type === 'model_output');
  if (modelStep) {
    for (const contentBlock of modelStep.content) {
      if (contentBlock.type === 'text') console.log(contentBlock.text);
    }
  }
}

main();

REST

# Specifies the API revision to avoid breaking changes when they become default
curl -X POST "https://generativelanguage.googleapis.com/v1beta/interactions" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H 'Content-Type: application/json' \
  -H "Api-Revision: 2026-05-20" \
  -d '{
    "model": "gemini-3-flash-preview",
    "input": "Explain how AI works in a few words"
  }'

Zustandsloser Modus

Standardmäßig verwaltet die Interactions API den Unterhaltungsstatus serverseitig, wenn Sie previous_interaction_id verwenden. Wenn Sie den Unterhaltungsverlauf lieber selbst clientseitig verwalten möchten, können Sie den zustandslosen Modus aktivieren, indem Sie store=false festlegen und die gesammelten Schritte im Feld input nachfolgender Anfragen übergeben.

Weitere Informationen und vollständige zustandslose Beispiele für Unterhaltungen mit mehreren Runden finden Sie im Leitfaden zur Textgenerierung.

Nächste Schritte

Nachdem Sie Ihre erste API-Anfrage gesendet haben, können Sie sich die folgenden Leitfäden ansehen, in denen Gemini in Aktion gezeigt wird: