Erläuterung der API-Versionen

Dieses Dokument bietet einen allgemeinen Überblick über die Unterschiede zwischen den Versionen v1 und v1beta 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. Wenn es grundlegende Änderungen gibt, 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 dass sich die Hauptversion ändert.
• v1beta: Diese Version enthält frühe Funktionen, die sich möglicherweise noch in der Entwicklung befinden und funktionsgefährdende Änderungen erfahren können. Es gibt auch keine Garantie dafür, dass die Funktionen in der Betaversion in die stabile Version übernommen werden. Wenn Sie Stabilität in Ihrer Produktionsumgebung benötigen und keine Breaking Changes riskieren können, sollten Sie diese Version nicht in der Produktion verwenden.

•  – Unterstützt
•  – Wird nie unterstützt

API-Version in einem SDK konfigurieren

Das Gemini API SDK verwendet standardmäßig v1beta. Sie können aber auch andere Versionen verwenden, indem Sie die API-Version festlegen, wie im folgenden Codebeispiel gezeigt:

from google import genai

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

response = client.models.generate_content(
    model='gemini-2.0-flash',
    contents="Explain how AI works",
)

print(response.text)

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

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

async function main() {
  const response = await ai.models.generateContent({
    model: "gemini-2.0-flash",
    contents: "Explain how AI works",
  });
  console.log(response.text);
}

await main();

curl "https://generativelanguage.googleapis.com/v1/models/gemini-1.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."}]
    }]
   }'