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