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à della versione stabile sono completamente supportate per l'intero ciclo di vita della versione principale. In caso di modifiche che causano interruzioni, verrà creata una nuova versione principale dell'API e la versione esistente verrà ritirata dopo un periodo di tempo ragionevole. Le modifiche che non causano interruzioni possono essere introdotte nell'API senza modificare la versione principale. L'API Interactions e le relative funzionalità principali sono generalmente disponibili in v1.
• v1beta: questa versione include funzionalità e funzionalità iniziali in fase di sviluppo attivo. Sebbene le funzionalità di 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.

Supporto di funzionalità e funzionalità

La tabella seguente descrive 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:

from google import genai

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

interaction = client.interactions.create(
    model='gemini-3.6-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.6-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.6-flash",
    "input": "Explain how AI works",
  }'