Erläuterung der API-Versionen

In diesem Dokument finden Sie einen allgemeinen Überblick über die Unterschiede zwischen den v1 und v1beta Versionen der Gemini API.

• v1: Stabile Version der API. Funktionen in der stabilen Version werden während des gesamten Lebenszyklus der Hauptversion vollständig unterstützt. Bei nicht abwärtskompatiblen Änderungen wird eine neue Hauptversion der API erstellt und die vorhandene Version nach einem angemessenen Zeitraum eingestellt. Nicht abwärtskompatible Änderungen können an der API vorgenommen werden, ohne die Hauptversion zu ändern. Die Interactions API und ihre Kernfunktionen sind in v1 allgemein verfügbar.
• v1beta: Diese Version enthält frühe Funktionen und Möglichkeiten, die aktiv entwickelt werden. Funktionen in v1beta können sich ändern, da wir sie basierend auf Feedback weiterentwickeln. Sie können jedoch neue Funktionen ausprobieren, bevor sie in die stabile Version übernommen werden.

Unterstützung für Funktionen und Features

In der folgenden Tabelle wird die Verfügbarkeit von Funktionen in v1 (allgemeine Verfügbarkeit) und v1beta (Beta) aufgeschlüsselt. Sofern nicht anders angegeben, gelten die Kernfunktionen und ‑tools der API sowohl für die Interactions API als auch für generateContent:

• - Unterstützt

API-Version in einem SDK konfigurieren

In den Gemini API SDKs ist standardmäßig v1beta festgelegt. Sie können jedoch Versionen explizit angeben, indem Sie die API-Version wie im folgenden Codebeispiel gezeigt festlegen:

from google import genai

client = genai.Client(http_options={'api_version': 'v1'})

interaction = client.interactions.create(
    model='gemini-3.6-flash',
    input="Explain how AI works",
)

print(interaction.output_text)

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

const ai = new GoogleGenAI({
  httpOptions: { apiVersion: "v1" },
});

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

await main();

curl -X POST "https://generativelanguage.googleapis.com/v1/interactions" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "gemini-3.6-flash",
    "input": "Explain how AI works",
  }'