Spiegazione delle versioni API

Questo documento fornisce una panoramica di alto livello 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 distruttive senza modificare la versione principale.
• v1beta: questa versione include funzionalità con accesso in anteprima che potrebbero essere in fase di sviluppo ed è soggetta a modifiche rapide e sostanziali. Inoltre, non è garantito che le funzionalità della versione beta vengano trasferite alla versione stabile. A causa di questa instabilità, ti consigliamo di non avviare applicazioni di produzione con questa versione.

• - Supportato
• - Non sarà mai supportato

Configurare la versione dell'API in un SDK

L'SDK dell'API Gemini utilizza per impostazione predefinita 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': 'v1alpha'})

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

print(response.text)

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

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

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

await main();

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