Questo documento fornisce una panoramica generale delle differenze tra le versioni v1 e v1beta dell'API Gemini.
- v1: versione stabile dell'API. Le funzionalità della versione stabile sono
completamente supportate per tutta la durata della versione principale. Se vengono apportate
modifiche che causano interruzioni, verrà creata una nuova versione principale dell'API e la
versione esistente verrà ritirata dopo un periodo di tempo ragionevole.
Nell'API possono essere introdotte modifiche non distruttive senza modificare la
versione principale. L'API Interactions e le relative funzionalità principali sono
disponibili a livello generale in
v1. - v1beta: questa versione include funzionalità e capacità iniziali in fase di sviluppo attivo. Sebbene le funzionalità in
v1betapossano essere soggette a modifiche man mano che le perfezioniamo in base al feedback, ti consentono di provare nuove funzionalità prima che vengano promosse alla versione stabile.
Supporto di funzionalità e capacità
La tabella seguente mostra in dettaglio la disponibilità delle funzionalità in v1 (GA)
e v1beta (beta). Le funzionalità e gli strumenti principali dell'API si applicano sia
all'API Interactions sia a generateContent, se non diversamente specificato:
- - Supportato
Configurare la versione dell'API in un SDK
Per impostazione predefinita, gli SDK dell'API Gemini utilizzano v1beta, ma puoi specificare esplicitamente le versioni
impostando la versione dell'API come mostrato nel seguente esempio di codice:
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",
}'