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. Die Funktionen der stabilen Version werden während der gesamten Lebensdauer der Hauptversion vollständig unterstützt. Bei bahnbrechenden Änderungen wird die nächste Hauptversion der API erstellt und die vorhandene Version nach angemessener Zeit eingestellt. Nicht funktionsgefährdende Änderungen können an der API vorgenommen werden, ohne die Hauptversion zu ändern.
  • v1beta: Diese Version enthält Funktionen mit Vorabzugriff, die sich noch in der Entwicklungsphase befinden und sich schnell und ohne Ankündigung ändern können. Außerdem gibt es keine Garantie dafür, dass die Funktionen in der Betaversion in die stabile Version übernommen werden. Aufgrund dieser Instabilität sollten Sie Produktionsanwendungen nicht mit dieser Version starten.
Funktion v1 v1beta
Inhalte generieren – Nur Text eingeben
Inhalte generieren – Text- und Bildeingabe
Inhalte generieren – Textausgabe
Inhalte generieren – Unterhaltungen über mehrere Themen (Chat)
Inhalte generieren – Funktionsaufrufe
Inhalte erstellen – Streaming
Inhalte einbetten – Nur-Text-Eingabe
Antwort generieren
Semantische Suche
  •  – 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 festlegen:

from google import genai

client = genai.Client(api_key="YOUR_API_KEY",
                      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({
  apiKey: "YOUR_API_KEY",
  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?key=YOUR_API_KEY" \
-H 'Content-Type: application/json' \
-X POST \
-d '{
  "contents": [{
    "parts":[{"text": "Explain how AI works."}]
    }]
   }'