Gemini API-Schlüssel verwenden

Zur Verwendung der Gemini API benötigen Sie einen API-Schlüssel. Sie können in Google AI Studio mit wenigen Klicks einen kostenlosen Schlüssel erstellen.

Sobald Sie einen API-Schlüssel haben, haben Sie folgende Möglichkeiten, eine Verbindung zur Gemini API herzustellen:

• API-Schlüssel als Umgebungsvariable festlegen
• API-Schlüssel explizit angeben

Für die ersten Tests können Sie einen API-Schlüssel hartcodieren. Dies sollte jedoch nur vorübergehend sein, da es nicht sicher ist. Beispiele für das Hartcodieren des API-Schlüssels finden Sie unter API-Schlüssel explizit angeben.

API-Schlüssel als Umgebungsvariable festlegen

Wenn du die Umgebungsvariable GEMINI_API_KEY oder GOOGLE_API_KEY festlegst, wird der API-Schlüssel automatisch vom Client übernommen, wenn eine der Gemini API-Bibliotheken verwendet wird. Es wird empfohlen, nur eine dieser Variablen festzulegen. Wenn beide festgelegt sind, hat GOOGLE_API_KEY Vorrang.

Wenn Sie die REST API oder JavaScript im Browser verwenden, müssen Sie den API-Schlüssel explizit angeben.

So legen Sie Ihren API-Schlüssel lokal als Umgebungsvariable GEMINI_API_KEY unter verschiedenen Betriebssystemen fest:

~/.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

API-Schlüssel explizit angeben

In einigen Fällen kann es sinnvoll sein, einen API-Schlüssel anzugeben. Beispiel:

• Sie führen einen einfachen API-Aufruf aus und möchten den API-Schlüssel hartcodieren.
• Sie möchten eine explizite Steuerung, ohne sich auf die automatische Erkennung von Umgebungsvariablen durch die Gemini API-Bibliotheken verlassen zu müssen.
• Sie verwenden eine Umgebung, in der Umgebungsvariablen nicht unterstützt werden (z. B. Web), oder Sie führen REST-Aufrufe aus.

Im Folgenden finden Sie Beispiele dafür, wie Sie einen API-Schlüssel explizit angeben können:

from google import genai

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

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

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

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

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();

package main

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

func main() {
    ctx := context.Background()
    client, err := genai.NewClient(ctx, &genai.ClientConfig{
        APIKey:  "YOUR_API_KEY",
        Backend: genai.BackendGeminiAPI,
    })
    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())
}

package com.example;

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

public class GenerateTextFromTextInput {
  public static void main(String[] args) {
    Client client = Client.builder().apiKey("YOUR_API_KEY").build();

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

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

curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-flash:generateContent?key=$YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  -X POST \
  -d '{
    "contents": [
      {
        "parts": [
          {
            "text": "Explain how AI works in a few words"
          }
        ]
      }
    ]
  }'

API-Schlüssel schützen

Es ist wichtig, Ihren Gemini API-Schlüssel sicher aufzubewahren. Beachten Sie bei der Verwendung Ihres Gemini API-Schlüssels Folgendes:

• Die Google AI Gemini API verwendet API-Schlüssel für die Autorisierung. Wenn andere Personen Zugriff auf Ihren Gemini API-Schlüssel erhalten, können sie Aufrufe mit dem Kontingent Ihres Projekts ausführen. Dies kann zu einem Verlust des Kontingents oder zu zusätzlichen Kosten für abrechenbare Projekte führen. Außerdem können sie auf abgestimmte Modelle und Dateien zugreifen.

• Durch das Hinzufügen von API-Schlüsseleinschränkungen können Sie die Oberfläche einschränken, die über jeden API-Schlüssel verwendet werden kann.

• Sie sind dafür verantwortlich, Ihren Gemini API-Schlüssel sicher aufzubewahren.

  • Gemini API-Schlüssel dürfen NICHT in die Versionsverwaltung eingecheckt werden.
  • Bei clientseitigen Anwendungen (Web und Dart/Flutter) besteht das Risiko, dass API-Schlüssel offengelegt werden. Wir empfehlen nicht, die Google AI Client-SDKs in Produktions-Apps zu verwenden, um die Google AI Gemini API direkt über Ihre Web-Apps aufzurufen.

Allgemeine Best Practices finden Sie auch in diesem Hilfeartikel.