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 über die gesamte Lebensdauer der Hauptversion vollständig unterstützt. Bei nicht abwärtskompatiblen Änderungen wird die nächste 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. Seit Juni 2026 ist die Interactions API allgemein verfügbar und wird in v1 unterstützt.
  • 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.
Funktion v1 v1beta
Interactions API
Inhalte generieren – Nur Texteingabe
Inhalte generieren – Text- und Bildeingabe
Inhalte generieren – Textausgabe
Inhalte generieren – Multi-Turn-Unterhaltungen (Chat)
Inhalte generieren – Funktionsaufrufe
Inhalte generieren – Streaming
Inhalte einbetten – Nur Texteingabe
Antwort generieren
Semantischer Retriever
  • - Unterstützt
  • - Wird nie 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 festlegen, wie im folgenden Codebeispiel gezeigt:

Python

from google import genai

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

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

print(interaction.output_text)

JavaScript

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

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

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

await main();

REST

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.5-flash",
    "input": "Explain how AI works"
  }'