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 v1 verwenden, indem Sie die API-Version wie im folgenden Codebeispiel gezeigt festlegen:
Python
Das Python SDK google.generativeai verwendet v1beta und bietet keine Methode zum Wechseln der API-Version.
Die Low-Level-Python-Clientbibliothek google.ai.generativelanguage stellt andere Versionen als separate Module bereit: google.ai.generativelanguage_v1 und google.ai.generativelanguage_v1beta. Der Standardwert ist v1beta.
import google.ai.generativelanguage_v1 as glm
client = glm.GenerativeServiceClient(
client_options=dict(api_key=YOUR_API_KEY))
response = client.generate_content({
"model": "models/gemini-1.5-flash",
"contents": [ {"parts": [ {"text": "Explain how AI works"}]}]
})
print(type(response).to_dict(response))
Node.js
const { GoogleGenerativeAI } = require("@google/generative-ai");
const genAI = new GoogleGenerativeAI("YOUR_API_KEY");
const model = genAI.getGenerativeModel({ model: 'gemini-1.5-flash' }, { apiVersion: 'v1' });
const prompt = "Explain how AI works";
const result = await model.generateContent(prompt);
console.log(result.response.text());
REST
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": "Write a story about a magic backpack."}]
}]
}'