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 tutta la durata della versione principale. In caso di modifiche che causano interruzioni, verrà creata la versione principale successiva 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.
• v1beta: questa versione include funzionalità in anteprima che potrebbero essere in fase di sviluppo e sono soggette a modifiche che causano interruzioni. Inoltre, non è garantito che le funzionalità della versione beta vengano spostate nella versione stabile. Se hai bisogno di stabilità nel tuo ambiente di produzione e non puoi rischiare modifiche che causano interruzioni, non devi utilizzare questa versione in produzione.

• - 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 scegliere di utilizzare altre 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'})

response = client.models.generate_content(
    model='gemini-3-flash-preview',
    contents="Explain how AI works",
)

print(response.text)

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

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

async function main() {
  const response = await ai.models.generateContent({
    model: "gemini-3-flash-preview",
    contents: "Explain how AI works",
  });
  console.log(response.text);
}

await main();

curl "https://generativelanguage.googleapis.com/v1/models/gemini-3-flash-preview:generateContent" \
-H "x-goog-api-key: $GEMINI_API_KEY" \
-H 'Content-Type: application/json' \
-X POST \
-d '{
  "contents": [{
    "parts":[{"text": "Explain how AI works."}]
    }]
   }'