Gemini API-Schlüssel verwenden

Wenn Sie die Gemini API verwenden möchten, müssen Sie Ihre Anfragen authentifizieren. Sie können sich mit einem Standard- oder Autorisierungs-API-Schlüssel authentifizieren.

Gemini API-Schlüssel erstellen oder ansehen

API-Schlüsseltypen: Standard- und Autorisierungsschlüssel

API-Schlüssel ermöglichen den Zugriff auf die Gemini API, ihre Sicherheitsmerkmale unterscheiden sich jedoch. Die Gemini API wird von Standard-API-Schlüsseln auf Autorisierungsschlüssel umgestellt, um die Sicherheit zu verbessern:

• Standard-API-Schlüssel: Verknüpfen Anfragen mit einem Google Cloud-Projekt für Abrechnungs- und Kontingentzwecke. Standardschlüssel identifizieren keinen Aufrufer, was die Granularität der Berechtigungen und der Zugriffssteuerung einschränkt, die sie unterstützen können.
• Autorisierungsschlüssel (Auth-Schlüssel): Direkt an ein Google Cloud-Dienstkonto gebunden. Wenn Sie einen Autorisierungsschlüssel verwenden, werden Ihre Anfragen unter der Identität dieses gebundenen Dienstkontos verarbeitet, was eine detaillierte Zugriffssteuerung ermöglicht. Autorisierungsschlüssel sind standardmäßig auf die Generative Language API (Gemini API) beschränkt und bieten eine schnelle Durchsetzung von Maßnahmen bei geleakten Schlüsseln, die die Nutzung von geleakten Schlüsseln, die von unseren Systemen erkannt wurden, schnell beendet.

Um eine sichere Nutzung zu gewährleisten, wird die Gemini API von Standardschlüsseln auf Authentifizierungsschlüssel umgestellt:

• Authentifizierungsschlüssel als Standard: Ab dem 28. Mai 2026 werden alle neuen API-Schlüssel, die in Google AI Studio erstellt werden, automatisch als Authentifizierungsschlüssel erstellt.
• Uneingeschränkte Schlüssel werden abgelehnt: Die Gemini API lehnt Anfragen von uneingeschränkten Standardschlüsseln ab. Standard-API-Schlüssel mit expliziten Einschränkungen funktionieren weiterhin. Diese Einschränkung verhindert die unbefugte Verwendung von Schlüsseln, die möglicherweise öffentlich freigegeben oder mit anderen Diensten verknüpft sind.

API-Schlüssel in Google AI Studio verwalten

Sie können Ihre Projekte und Schlüssel direkt in Google AI Studio verwalten.

Google Cloud-Projekte

Jeder Gemini API-Schlüssel ist mit einem Google Cloud-Projekt verknüpft. In Google Cloud-Projekten werden Abrechnung, Mitbearbeiter und Berechtigungen verwaltet. Google AI Studio bietet eine einfache Oberfläche für den Zugriff auf diese Projekte.

• Standardprojekt: Wenn Sie ein neuer Nutzer sind, erstellt Google AI Studio automatisch ein Google Cloud-Standardprojekt und einen API-Schlüssel, nachdem Sie die Nutzungsbedingungen akzeptiert haben. Sie können dieses Projekt umbenennen, indem Sie in Ihrem Dashboard die Ansicht Projekte aufrufen.
• Vorhandene Projekte: Wenn Sie bereits ein Google Cloud-Konto haben, wird in AI Studio kein Standardprojekt erstellt. Stattdessen müssen Sie Ihre vorhandenen Projekte importieren.

Projekte werden importiert

Standardmäßig werden in Google AI Studio nicht alle Ihre Google Cloud-Projekte angezeigt. Sie müssen die Projekte importieren, die Sie verwenden möchten:

1. Rufen Sie Google AI Studio auf.
2. Öffnen Sie im linken Bereich das Dashboard und wählen Sie Projekte aus.
3. Klicken Sie auf den Button Projekte importieren.
4. Suchen Sie nach dem Google Cloud-Projekt, das Sie importieren möchten, wählen Sie es aus und klicken Sie dann auf Importieren.
5. Rufen Sie nach dem Import die Seite API-Schlüssel im Dashboard auf, um einen Schlüssel in diesem Projekt zu erstellen.

Fehlerbehebung bei Berechtigungen zum Erstellen von Schlüsseln

Wenn die Schaltfläche API-Schlüssel erstellen nicht verfügbar ist und die Meldung „Sie sind nicht berechtigt, in diesem Projekt einen Schlüssel zu erstellen“ angezeigt wird, fehlen Ihnen die erforderlichen IAM-Berechtigungen.

Bitten Sie den Administrator Ihres Google Cloud-Projekts oder Ihrer Google Cloud-Organisation, Ihnen eine Rolle mit den folgenden Berechtigungen zuzuweisen (z. B. Project Editor):

• resourcemanager.projects.get: Ermöglicht AI Studio, das Projekt zu verifizieren.
• apikeys.keys.create: Ermöglicht die Schlüsselgenerierung.
• serviceusage.services.enable: sorgt dafür, dass die Generative Language API aktiviert ist.
• iam.serviceAccounts.create: Erforderlich, um das verknüpfte Dienstkonto zu erstellen.
• iam.serviceAccountApiKeyBindings.create: Bindet das Dienstkonto an den API-Schlüssel.

Wenn Sie keinen Administratorzugriff erhalten, können Sie ein neues Google Cloud-Projekt erstellen, das nicht mit einer Organisation verknüpft ist, um Ihre Schlüssel zu generieren.

Unbekannte Schlüssel auf der Seite „Nutzung“

Auf der Seite „Nutzung“ in Google AI Studio werden Anfragen, die keinem benannten API-Schlüssel im Projekt zugeordnet werden können, unter (unbekannte Schlüssel) gruppiert. Dazu gehören Schlüssel, die vor mehr als 30 Tagen gelöscht wurden, Schlüssel ohne Anzeigenamen und Anfragen, die mit anderen Anmeldedaten wie OAuth gestellt wurden.

Schlüssel in der Google Cloud Console erstellen

In Google AI Studio werden nur Schlüssel angezeigt, die uneingeschränkt oder auf die Gemini API beschränkt sind. Wenn Sie AI Studio nicht verwenden können oder alle Ihre API-Schlüssel an einem Ort verwalten möchten, folgen Sie der Cloud-Dokumentation zum Erstellen eines API-Schlüssels. Wenn Sie einen Gemini API-Schlüssel erstellen, müssen Sie ihn an ein Dienstkonto binden.

Umgebung einrichten

Sobald Sie einen Schlüssel haben, konfigurieren Sie Ihre Umgebung so, dass er in Ihren Anwendungen sicher verwendet wird.

Option 1: Umgebungsvariablen verwenden (empfohlen)

Legen Sie die Umgebungsvariable GEMINI_API_KEY oder GOOGLE_API_KEY fest. Die Gemini API-Clientbibliotheken erkennen und verwenden diese Variablen automatisch. Wenn beide konfiguriert sind, hat „GOOGLE_API_KEY“ Vorrang.

Wählen Sie Ihr Betriebssystem aus, um die Variable festzulegen:

~/.bashrc

touch ~/.bashrc && open ~/.bashrc

export GEMINI_API_KEY=<YOUR_API_KEY_HERE>

source ~/.bashrc

~/.zshrc

touch ~/.zshrc && open ~/.zshrc

export GEMINI_API_KEY=<YOUR_API_KEY_HERE>

source ~/.zshrc

Option 2: API-Schlüssel explizit im Code angeben

Sie können den API-Schlüssel beim Initialisieren des Clients explizit übergeben. Tun Sie dies nur, wenn Sie keine Umgebungsvariablen verwenden können.

from google import genai

client = genai.Client(api_key="YOUR_API_KEY")

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

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

const ai = new GoogleGenAI({ apiKey: "YOUR_API_KEY" });

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

main();

import com.google.genai.Client;
import com.google.genai.gaos.models.interactions.CreateModelInteraction;
import com.google.genai.gaos.models.interactions.Interaction;
import com.google.genai.gaos.models.interactions.InteractionsInput;
import com.google.genai.gaos.models.interactions.Model;
import com.google.genai.gaos.models.operations.CreateInteractionRequestBody;

Client client = Client.builder().apiKey("YOUR_API_KEY").build();

CreateModelInteraction params =
    CreateModelInteraction.builder()
        .model(Model.of("gemini-3.8-flash"))
        .input(InteractionsInput.of("Explain how AI works in a few sentences."))
        .build();

Interaction interaction =
    client.interactions.create(CreateInteractionRequestBody.of(params)).interaction().get();

System.out.println(interaction.outputText().orElse(""));

package main

import (
    "context"
    "fmt"
    "log"

    "google.golang.org/genai"
    "google.golang.org/genai/interactions/models/interactions"
    "google.golang.org/genai/interactions/models/operations"
)

func main() {
    ctx := context.Background()
    client, err := genai.NewClient(ctx, &genai.ClientConfig{
        APIKey: "YOUR_API_KEY",
    })
    if err != nil {
        log.Fatal(err)
    }

    res, err := client.Interactions.Create(ctx, operations.CreateInteractionRequest{
        Body: operations.NewCreateInteractionRequestBody(interactions.CreateModelInteraction{
            Model: interactions.Model("gemini-3.8-flash"),
            Input: interactions.NewInteractionsInput("Explain how AI works in a few sentences."),
        }),
    })
    if err != nil {
        log.Fatal(err)
    }
    if res.Interaction.OutputText != nil {
        fmt.Println(*res.Interaction.OutputText)
    }
}

curl "https://generativelanguage.googleapis.com/v1beta/interactions" \
  -H 'Content-Type: application/json' \
  -H "x-goog-api-key: YOUR_API_KEY" \
  -X POST \
  -d '{
    "model": "gemini-3.8-flash",
    "input": "Explain how AI works in a few words"
  }'

Sicherheits- und Secret-Verwaltung

Behandeln Sie Ihren Gemini API-Schlüssel wie ein Passwort. Wenn sie manipuliert werden, können andere das Kontingent Ihres Projekts verbrauchen, unerwartete Abrechnungsgebühren verursachen und auf private Ressourcen zugreifen.

Kritische Sicherheitsregeln

• Schlüssel vertraulich behandeln: Checken Sie API-Schlüssel niemals in Quellcodeverwaltungssysteme wie Git ein.
• Schlüssel niemals clientseitig in der Produktion preisgeben: Codieren Sie API-Schlüssel nicht direkt in Web- oder mobilen Apps. In clientseitigem Code kompilierte Schlüssel können von Nutzern extrahiert werden. Führen Sie zum Schutz clientseitiger Apps einen Backend-Proxyserver aus, um die eigentlichen API-Aufrufe auszuführen.

Best Practices für die Secret-Verwaltung

• Umgebungsvariablen: Schlüssel werden aus Umgebungsvariablen und nicht aus Konfigurationsdateien gelesen.
• Secret Manager: Speichern Sie Ihre Schlüssel für die Produktion in einem sicheren Secret-Speicher wie Google Cloud Secret Manager.
• Abrechnungsbenachrichtigungen: Richten Sie in der Google Cloud Console Abrechnungsbenachrichtigungen ein, um sich bei einem Anstieg der Nutzung oder der Kosten benachrichtigen zu lassen.

Checkliste für die Reaktion auf Datenpannen

Wenn Sie vermuten, dass Ihr API-Schlüssel geleakt wurde:

1. Neuen Schlüssel generieren: Erstellen Sie einen Ersatzschlüssel in Google AI Studio oder in der Cloud Console.
2. Anwendung aktualisieren: Stellen Sie Ihren Code mit dem neuen Schlüssel bereit.
3. Deaktivieren oder löschen Sie den kompromittierten Schlüssel: Deaktivieren Sie den kompromittierten Schlüssel in der Cloud Console, sobald der neue Schlüssel verifiziert wurde. Löschen Sie den alten Schlüssel erst, wenn der neue Schlüssel vollständig aktiv ist, um Anwendungsausfallzeiten zu vermeiden.
4. Nutzung prüfen: Prüfen Sie die Abrechnungslogs und die API-Nutzung in der Google Cloud Console, um nicht autorisierte Aktivitäten zu erkennen.

Schlüssel einschränken und sichern

Wenn Sie Ihre API-Schlüssel einschränken, minimieren Sie den potenziellen Schaden, falls ein Schlüssel manipuliert wird.

Einschränkungen für den Ursprung der Anfrage anwenden

Mit Ursprungseinschränkungen wird festgelegt, welche IP-Adressen, Websites oder Anwendungen Ihren Schlüssel verwenden können.

1. Rufen Sie in der Google Cloud Console die Seite „Anmeldedaten“ auf.
2. Wählen Sie Ihr Projekt aus und klicken Sie auf den Namen des API-Schlüssels, den Sie einschränken möchten.
3. Wählen Sie unter Anwendungseinschränkungen die Option IP-Adressen (oder den entsprechenden Einschränkungstyp für Ihre Umgebung) aus.
4. Geben Sie die zulässigen IP-Adressen oder ‑Bereiche an und klicken Sie auf Speichern.

Uneingeschränkte Standard-API-Schlüssel sichern

Wenn Sie die Gemini API weiterhin verwenden möchten, müssen Sie alle uneingeschränkten Schlüssel schützen.

Methode A: Schlüssel nur auf die Gemini API beschränken (AI Studio)

Wenn Sie den Schlüssel nur für die Gemini API verwenden, sichern Sie ihn direkt in AI Studio:

1. Suchen Sie auf der Seite API-Schlüssel in Google AI Studio nach Schlüsseln, die mit dem Label Uneingeschränkt gekennzeichnet sind.
2. Bewegen Sie den Mauszeiger auf das Label und klicken Sie im Dialogfeld auf Einschränkungen hinzufügen.
3. Wählen Sie Nur auf die Gemini API beschränken aus.
4. Klicken Sie zur Bestätigung auf Schlüssel einschränken.

Methode B: Schlüssel für andere Dienste einschränken (Google Cloud Console)

Wenn der Schlüssel für andere Google APIs freigegeben ist (nicht empfohlen), schränken Sie ihn in der Cloud Console ein. Hinweis: Gemini API-Anfragen, die diesen Schlüssel verwenden, schlagen fehl, nachdem diese Einschränkungen angewendet wurden.

1. Rufen Sie die Seite „Anmeldedaten“ in der Google Cloud Console auf.
2. Wählen Sie das Projekt und den API-Schlüssel aus.
3. Wählen Sie unter API-Einschränkungen im Drop-down-Menü API-Einschränkungen auswählen die APIs aus, auf die mit diesem Schlüssel zugegriffen werden soll. Wählen Sie nicht die Generative Language API aus.
4. Klicken Sie auf Speichern. Erstellen Sie in AI Studio einen separaten, eingeschränkten Schlüssel, um die Gemini API weiterhin zu verwenden.

Blockierte inaktive Schlüssel

Ab dem 7. Mai 2026 blockiert die Gemini API nicht eingeschränkte API-Schlüssel, die über einen längeren Zeitraum nicht verwendet wurden. Diese Schlüssel sind in AI Studio mit dem Tag Blockiert gekennzeichnet. Sie müssen einen neuen Schlüssel generieren oder einen vorhandenen eingeschränkten Schlüssel verwenden, um fortzufahren.

Zu einem Authentifizierungsschlüssel migrieren

So erstellen Sie einen neuen API-Schlüssel für die Authentifizierung und aktualisieren Ihre Anwendungen:

1. Rufen Sie die Seite „AI Studio API-Schlüssel“ auf.
2. Suchen Sie in der Spalte Schlüsseltyp nach Schlüsseln, die als Standard aufgeführt sind.
3. Klicken Sie auf API-Schlüssel erstellen, um einen neuen Schlüssel zu generieren. Alle neuen Schlüssel, die in AI Studio erstellt werden, werden automatisch als Authentifizierungsschlüssel erstellt.
4. Kopieren Sie den neuen API-Schlüssel für die Authentifizierung.
5. Aktualisieren Sie Ihren Anwendungscode, Ihre Umgebungsvariablen und alle Bereitstellungskonfigurationen, um den neuen Authentifizierungs-API-Schlüssel zu verwenden.
6. Testen Sie Ihre Anwendung, um zu prüfen, ob sie mit dem neuen Schlüssel ordnungsgemäß funktioniert.
7. Löschen oder widerrufen Sie nach der Bestätigung Ihren alten Traffic-Schlüssel, um Missbrauch zu verhindern.

Beschränkungen

In Google AI Studio gelten die folgenden Einschränkungen für die Projekt- und Schlüsselverwaltung:

• Sie können auf der Seite Projekte in Google AI Studio maximal 10 Projekte gleichzeitig erstellen.
• Auf den Seiten API-Schlüssel und Projekte werden maximal 100 Schlüssel und 50 Projekte angezeigt.
• Es werden nur API-Schlüssel angezeigt, die uneingeschränkt oder speziell auf die Generative Language API (Gemini API) beschränkt sind.

Für die erweiterte Projektverwaltung oder zum Ändern von Schlüsseln mit anderen Einschränkungen verwenden Sie die Seite „Anmeldedaten“ in der Google Cloud Console.