In diesem Dokument finden Sie 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. Bei funktionsgefährdenden Änderungen wird eine neue Hauptversion der API erstellt und die vorhandene Version nach einem angemessenen Zeitraum eingestellt.
Es können abwärtskompatible Änderungen an der API vorgenommen werden, ohne dass sich die Hauptversion ändert. Die Interactions API und ihre Kernfunktionen sind in
v1allgemein verfügbar. - v1beta: Diese Version enthält erste Funktionen, die aktiv entwickelt werden. Funktionen in
v1betakönnen sich ändern, da wir sie auf Grundlage von Feedback weiterentwickeln. Sie haben jedoch die Möglichkeit, neue Funktionen auszuprobieren, bevor sie als stabil eingestuft werden.
Unterstützung von Funktionen und Merkmalen
In der folgenden Tabelle wird die Verfügbarkeit von Funktionen in v1 (allgemein verfügbar) und v1beta (Beta) beschrieben. Die wichtigsten API-Funktionen und ‑Tools gelten sowohl für die Interactions API als auch für generateContent, sofern nicht anders angegeben:
| Funktion | v1 | v1beta |
|---|---|---|
| Wichtige API-Funktionen | ||
| Interactions API | ||
| Funktionsaufrufe | ||
| Strukturierte Ausgabe | ||
| Denken / Argumentation | ||
| Systemanweisungen | ||
| Audioausgabe (Sprachkonfiguration) | ||
| Service Tier (Priority / Flex) | ||
| Tools | ||
| Tool zur Codeausführung | ||
| Fundierung mit der Google Suche | ||
| Google Maps-Fundierung | ||
| Tool zum URL-Kontext | ||
| Dateisuchtool | ||
| Tool zur Computernutzung | ||
| MCP-Server-Tool | ||
| Echtzeit-APIs | ||
| Live API (WebSockets) | ||
| Live Music API | ||
| Einmal-Tokens (Live API) | ||
| Plattform-APIs | ||
| Models API | ||
| Files Service Route (Files-Dienstroute) | ||
| Dateisuche speichert Route | ||
| Agents API | ||
| Webhooks API | ||
| Kontext-Caching |
- – Unterstützt
API-Version in einem SDK konfigurieren
Die Gemini API SDKs verwenden standardmäßig v1beta. Sie können jedoch Versionen explizit angeben, indem Sie die API-Version festlegen, wie im folgenden Codebeispiel gezeigt:
Python
from google import genai
client = genai.Client(http_options={'api_version': 'v1'})
interaction = client.interactions.create(
model='gemini-3.8-flash',
input="Explain how AI works",
)
print(interaction.output_text)
JavaScript
import { GoogleGenAI } from "@google/genai";
const ai = new GoogleGenAI({
httpOptions: { apiVersion: "v1" },
});
async function main() {
const interaction = await ai.interactions.create({
model: "gemini-3.8-flash",
input: "Explain how AI works",
});
console.log(interaction.output_text);
}
await main();
Java
import com.google.genai.Client;
import com.google.genai.gaos.models.interactions.CreateModelInteraction;
import com.google.genai.gaos.models.interactions.InteractionsInput;
import com.google.genai.gaos.models.interactions.Model;
import com.google.genai.gaos.models.operations.CreateInteractionRequestBody;
import com.google.genai.types.HttpOptions;
Client client = Client.builder()
.httpOptions(HttpOptions.builder().apiVersion("v1").build())
.build();
CreateModelInteraction req = CreateModelInteraction.builder()
.model(Model.of("gemini-3.6-flash"))
.input(InteractionsInput.of("Explain how AI works"))
.build();
var interaction = client.interactions.create(CreateInteractionRequestBody.of(req)).interaction().get();
System.out.println(interaction.outputText().orElse(""));
Go
package main
import (
"context"
"fmt"
"log"
"google.golang.org/genai"
"google.golang.org/genai/interactions/models/interactions"
"google.golang.org/genai/interactions/models/operations"
)
func main() {
ctx := context.Background()
client, err := genai.NewClient(ctx, &genai.ClientConfig{
HTTPOptions: genai.HTTPOptions{
APIVersion: "v1",
},
})
if err != nil {
log.Fatal(err)
}
res, err := client.Interactions.Create(ctx, operations.CreateInteractionRequest{
Body: operations.NewCreateInteractionRequestBody(interactions.CreateModelInteraction{
Model: interactions.Model("gemini-3.6-flash"),
Input: interactions.NewInteractionsInput("Explain how AI works"),
}),
})
if err != nil {
log.Fatal(err)
}
if res.Interaction.OutputText != nil {
fmt.Println(*res.Interaction.OutputText)
}
}
REST
curl -X POST "https://generativelanguage.googleapis.com/v1/interactions" \
-H "x-goog-api-key: $GEMINI_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"model": "gemini-3.8-flash",
"input": "Explain how AI works",
}'