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 el funcionamiento, se creará una nueva versión principal de la API y la versión existente se dejará de usar después de un período razonable. Se pueden introducir cambios no rotundos en la API sin cambiar la versión principal. La API de Interactions y sus funciones principales están disponibles de forma general 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.

Compatibilidad con funciones y capacidades

En la siguiente tabla, se detalla la disponibilidad de las capacidades en v1 (DG) y v1beta (beta). Las capacidades y herramientas principales de la API se aplican tanto a la API de Interactions como a generateContent, a menos que se especifique lo contrario:

• : 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.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",
  }'