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. Es können nicht funktionsgefährdende Änderungen an der API vorgenommen werden, ohne dass sich die Hauptversion ändert.
• v1beta: Diese Version enthält Early-Access-Funktionen, die sich möglicherweise noch in der Entwicklung befinden, und unterliegt schnellen und funktionsgefährdenden Änderungen. Es gibt auch keine Garantie dafür, dass die Funktionen in der Betaversion in die stabile Version übernommen werden. Aufgrund dieser Instabilität sollten Sie keine Produktionsanwendungen mit dieser Version starten.

•  – 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 wie im folgenden Codebeispiel gezeigt festlegen:

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."}]
    }]
   }'