Explicación de las versiones de la API

En este documento, se proporciona una descripción general de alto nivel de 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 cambios que interrumpen la compatibilidad, se creará la próxima versión principal de la API y la versión existente se marcará como obsoleta después de un período razonable. Se pueden introducir cambios no rotundos en la API sin cambiar la versión principal. A partir de junio de 2026, la API de Interactions estará disponible de forma general y se admitirá en v1.
• v1beta: Esta versión incluye funciones y capacidades iniciales que se encuentran en desarrollo activo. Si bien las funciones en v1beta pueden estar sujetas a cambios a medida que las perfeccionamos en función de los comentarios, te permite probar nuevas capacidades antes de que se promuevan a estables.

• : Compatible
• : Nunca será compatible

Cómo configurar la versión de la API en un SDK

Los SDK de la API de Gemini usan v1beta de forma predeterminada, pero puedes especificar versiones de forma explícita 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'})

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