Spiegazione delle versioni API

Questo documento fornisce una panoramica generale delle differenze tra le versioni v1 e v1beta dell'API Gemini.

• v1: versione stabile dell'API. Le funzionalità nella versione stabile sono completamente supportate per tutta la durata della versione principale. Se vengono apportate modifiche che causano interruzioni, verrà creata la successiva versione principale dell'API e la versione esistente verrà ritirata dopo un periodo di tempo ragionevole. Nell'API possono essere introdotte modifiche non sostanziali senza modificare la versione principale. A partire da giugno 2026, l'API Interactions è disponibile e supportata in v1.
• v1beta: questa versione include funzionalità e capacità iniziali in fase di sviluppo attivo. Sebbene le funzionalità in v1beta possano 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.

• - Supportato
• - Non sarà mai 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:

from google import genai

client = genai.Client(http_options={'api_version': 'v1'})

interaction = client.interactions.create(
    model='gemini-3.5-flash',
    input="Explain how AI works",
)

print(interaction.output_text)

import { GoogleGenAI } from "@google/genai";

const ai = new GoogleGenAI({
  httpOptions: { apiVersion: "v1" },
});

async function main() {
  const interaction = await ai.interactions.create({
    model: "gemini-3.5-flash",
    input: "Explain how AI works",
  });
  console.log(interaction.output_text);
}

await main();

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.5-flash",
    "input": "Explain how AI works"
  }'