Explicación de las versiones de la API

En este documento, se proporciona una descripción general de alto nivel sobre las diferencias entre las versiones v1 y v1beta de la API de Gemini.

• v1: Es la versión estable de la API. Las funciones de la versión estable son totalmente compatibles durante el ciclo de vida de la versión principal. Si hay algún cambio rotundo, se creará la próxima versión principal de la API y la versión existente quedará obsoleta después de un período razonable. Se pueden introducir cambios no rotundos en la API sin cambiar la versión principal.
• v1beta: Esta versión incluye funciones tempranas que pueden estar en desarrollo y están sujetas a cambios rotundos. Tampoco se garantiza que las funciones de la versión Beta pasen a la versión estable. Si necesitas estabilidad en tu entorno de producción y no puedes arriesgarte a cambios rotundos, no debes usar esta versión en producción.

• - Compatible
• - Nunca será compatible

Configura la versión de la API en un SDK

Los SDK de la API de Gemini tienen como valor predeterminado v1beta, pero puedes optar por usar otras versiones configurando la versión de la API como se muestra en la siguiente muestra de código:

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."}]
    }]
   }'