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 während der gesamten Lebensdauer der Hauptversion vollständig unterstützt. Bei grundlegenden Änderungen wird die nächste Hauptversion der API erstellt und die vorhandene Version nach einem angemessenen Zeitraum eingestellt. Nicht grundlegende Änderungen können an der API vorgenommen werden, ohne die Hauptversion zu ändern.
- v1beta: Diese Version enthält frühe Funktionen, die sich möglicherweise noch in der Entwicklung befinden und grundlegenden Änderungen unterliegen. Es gibt auch keine Garantie, dass die Funktionen in der Betaversion in die stabile Version übernommen werden. Wenn Sie in Ihrer Produktionsumgebung Stabilität benötigen und keine grundlegenden Änderungen riskieren können, sollten Sie diese Version nicht in der Produktion verwenden.
| Funktion | v1 | v1beta |
|---|---|---|
| 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 | ||
| Interactions API |
- – Unterstützt
- – Wird nie unterstützt
API-Version in einem SDK konfigurieren
Die Gemini API SDKs verwenden standardmäßig v1beta. Sie können aber auch andere Versionen verwenden, indem Sie die API-Version wie im folgenden Codebeispiel gezeigt festlegen:
Python
from google import genai
client = genai.Client(http_options={'api_version': 'v1'})
response = client.models.generate_content(
model='gemini-3-flash-preview',
contents="Explain how AI works",
)
print(response.text)
JavaScript
import { GoogleGenAI } from "@google/genai";
const ai = new GoogleGenAI({
httpOptions: { apiVersion: "v1" },
});
async function main() {
const response = await ai.models.generateContent({
model: "gemini-3-flash-preview",
contents: "Explain how AI works",
});
console.log(response.text);
}
await main();
REST
curl "https://generativelanguage.googleapis.com/v1/models/gemini-3-flash-preview:generateContent" \
-H "x-goog-api-key: $GEMINI_API_KEY" \
-H 'Content-Type: application/json' \
-X POST \
-d '{
"contents": [{
"parts":[{"text": "Explain how AI works."}]
}]
}'