Gemini API – Kurzanleitung

In dieser Kurzanleitung erfahren Sie, wie Sie unsere Bibliotheken installieren und Ihre erste Gemini API-Anfrage stellen.

Hinweis

Wenn Sie die Gemini API verwenden möchten, benötigen Sie einen API-Schlüssel, um Ihre Anfragen zu authentifizieren, Sicherheitslimits durchzusetzen und die Nutzung Ihres Kontos zu verfolgen.

Erstellen Sie kostenlos ein Konto in AI Studio, um loszulegen:

Gemini API-Schlüssel erstellen

Google GenAI SDK installieren

Python

Installieren Sie mit Python 3.9+ das google-genai-Paket mit dem folgenden pip-Befehl:

pip install -q -U google-genai

JavaScript

Installieren Sie mit Node.js v18+ das Google Gen AI SDK für TypeScript und JavaScript mit dem folgenden npm-Befehl:

npm install @google/genai

Ok

Installieren Sie google.golang.org/genai in Ihrem Modulverzeichnis mit dem Befehl „go get“:

go get google.golang.org/genai

Java

Wenn Sie Maven verwenden, können Sie google-genai installieren, indem Sie Ihren Abhängigkeiten Folgendes hinzufügen:

<dependencies>
  <dependency>
    <groupId>com.google.genai</groupId>
    <artifactId>google-genai</artifactId>
    <version>1.0.0</version>
  </dependency>
</dependencies>

C#

Installieren Sie googleapis/go-genai in Ihrem Modulverzeichnis mit dem dotnet add-Befehl.

dotnet add package Google.GenAI

Apps Script

  1. Wenn Sie ein neues Apps Script-Projekt erstellen möchten, rufen Sie script.new auf.
  2. Klicken Sie auf Unbenanntes Projekt.
  3. Benennen Sie das Apps Script-Projekt in AI Studio um und klicken Sie auf Umbenennen.
  4. API-Schlüssel festlegen
    1. Klicken Sie links auf Projekteinstellungen Symbol für die Projekteinstellungen.
    2. Klicken Sie unter Skripteigenschaften auf Skripteigenschaft hinzufügen.
    3. Geben Sie unter Property den Schlüsselnamen GEMINI_API_KEY ein.
    4. Geben Sie für Wert den Wert für den API-Schlüssel ein.
    5. Klicken Sie auf Skripteigenschaften speichern.
  5. Ersetzen Sie den Inhalt der Datei Code.gs durch den folgenden Code:

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 Tool-Nutzung, Orchestrierung und komplexe Reasoning-Abläufe über typisierte Ausführungsschritte. Künftig werden neue Modelle, die über die Kernfamilie 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, generateContent wird aber vollständig unterstützt.

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

Wenn Sie Ihren API-Schlüssel als Umgebungsvariable GEMINI_API_KEY festlegen, wird er automatisch vom Client übernommen, 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

from google import genai

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

response = client.models.generate_content(
    model="gemini-3-flash-preview", contents="Explain how AI works in a few words"
)
print(response.text)

JavaScript

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 response = await ai.models.generateContent({
    model: "gemini-3-flash-preview",
    contents: "Explain how AI works in a few words",
  });
  console.log(response.text);
}

main();

Ok

package main

import (
    "context"
    "fmt"
    "log"
    "google.golang.org/genai"
)

func main() {
    ctx := context.Background()
    // The client gets the API key from the environment variable `GEMINI_API_KEY`.
    client, err := genai.NewClient(ctx, nil)
    if err != nil {
        log.Fatal(err)
    }

    result, err := client.Models.GenerateContent(
        ctx,
        "gemini-3-flash-preview",
        genai.Text("Explain how AI works in a few words"),
        nil,
    )
    if err != nil {
        log.Fatal(err)
    }
    fmt.Println(result.Text())
}

Java

package com.example;

import com.google.genai.Client;
import com.google.genai.types.GenerateContentResponse;

public class GenerateTextFromTextInput {
  public static void main(String[] args) {
    // The client gets the API key from the environment variable `GEMINI_API_KEY`.
    Client client = new Client();

    GenerateContentResponse response =
        client.models.generateContent(
            "gemini-3-flash-preview",
            "Explain how AI works in a few words",
            null);

    System.out.println(response.text());
  }
}

C#

using System.Threading.Tasks;
using Google.GenAI;
using Google.GenAI.Types;

public class GenerateContentSimpleText {
  public static async Task main() {
    // The client gets the API key from the environment variable `GOOGLE_API_KEY`.
    var client = new Client();
    var response = await client.Models.GenerateContentAsync(
      model: "gemini-3-flash-preview", contents: "Explain how AI works in a few words"
    );
    Console.WriteLine(response.Candidates[0].Content.Parts[0].Text);
  }
}

Apps Script

// See https://developers.google.com/apps-script/guides/properties
// for instructions on how to set the API key.
const apiKey = PropertiesService.getScriptProperties().getProperty('GEMINI_API_KEY');
function main() {
  const payload = {
    contents: [
      {
        parts: [
          { text: 'Explain how AI works in a few words' },
        ],
      },
    ],
  };

  const url = 'https://generativelanguage.googleapis.com/v1beta/models/gemini-3-flash-preview:generateContent';
  const options = {
    method: 'POST',
    contentType: 'application/json',
    headers: {
      'x-goog-api-key': apiKey,
    },
    payload: JSON.stringify(payload)
  };

  const response = UrlFetchApp.fetch(url, options);
  const data = JSON.parse(response);
  const content = data['candidates'][0]['content']['parts'][0]['text'];
  console.log(content);
}

REST

curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-3-flash-preview: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"
          }
        ]
      }
    ]
  }'

Nächste Schritte

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