Gemini API – Kurzanleitung

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

Hinweis

Sie benötigen einen Gemini API-Schlüssel. Falls Sie noch keinen haben, können Sie ihn kostenlos in Google AI Studio 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 das Google Gen AI SDK für TypeScript und JavaScript mit dem folgenden npm-Befehl, wenn Sie Node.js v18+ verwenden:

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>

Apps Script

Wenn Sie ein neues Apps Script-Projekt erstellen möchten, rufen Sie script.new auf.
Klicken Sie auf Unbenanntes Projekt.
Benennen Sie das Apps Script-Projekt AI Studio um und klicken Sie auf Umbenennen.
API-Schlüssel festlegen
1. Klicken Sie links auf 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.
Ersetzen Sie den Inhalt der Datei Code.gs durch den folgenden Code:

Erste Anfrage senden

Hier ist ein Beispiel, in dem mit der Methode generateContent eine Anfrage an die Gemini API mit dem Modell Gemini 2.5 Flash gesendet wird.

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.

In allen Codebeispielen in der Gemini API-Dokumentation wird davon ausgegangen, 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-2.5-flash", 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-2.5-flash",
    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-2.5-flash",
        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-2.5-flash",
            "Explain how AI works in a few words",
            null);

    System.out.println(response.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-2.5-flash: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-2.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"
          }
        ]
      }
    ]
  }'

Die Funktion „Thinking“ ist in vielen unserer Codebeispiele standardmäßig aktiviert.

Viele Codebeispiele auf dieser Website verwenden das Modell Gemini 2.5 Flash, bei dem die Funktion „thinking“ (Denken) standardmäßig aktiviert ist, um die Qualität der Antworten zu verbessern. Beachten Sie, dass dies die Reaktionszeit und die Tokennutzung erhöhen kann. Wenn Sie Geschwindigkeit priorisieren oder Kosten minimieren möchten, können Sie diese Funktion deaktivieren, indem Sie das Denkbudget auf null setzen, wie in den Beispielen unten gezeigt. Weitere Informationen finden Sie im Leitfaden zum Denken.

Python

from google import genai
from google.genai import types

client = genai.Client()

response = client.models.generate_content(
    model="gemini-2.5-flash",
    contents="Explain how AI works in a few words",
    config=types.GenerateContentConfig(
        thinking_config=types.ThinkingConfig(thinking_budget=0) # Disables thinking
    ),
)
print(response.text)

JavaScript

import { GoogleGenAI } from "@google/genai";

const ai = new GoogleGenAI({});

async function main() {
  const response = await ai.models.generateContent({
    model: "gemini-2.5-flash",
    contents: "Explain how AI works in a few words",
    config: {
      thinkingConfig: {
        thinkingBudget: 0, // Disables thinking
      },
    }
  });
  console.log(response.text);
}

await main();

Ok

package main

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

func main() {

  ctx := context.Background()
  client, err := genai.NewClient(ctx, nil)
  if err != nil {
      log.Fatal(err)
  }

  result, _ := client.Models.GenerateContent(
      ctx,
      "gemini-2.5-flash",
      genai.Text("Explain how AI works in a few words"),
      &genai.GenerateContentConfig{
        ThinkingConfig: &genai.ThinkingConfig{
            ThinkingBudget: int32(0), // Disables thinking
        },
      }
  )

  fmt.Println(result.Text())
}

REST

curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-2.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"
          }
        ]
      }
    ]
    "generationConfig": {
      "thinkingConfig": {
        "thinkingBudget": 0
      }
    }
  }'

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-2.5-flash: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);
}

Nächste Schritte

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