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 significativos en la API sin cambiar la versión principal.
• v1beta: Esta versión incluye funciones de acceso anticipado que pueden estar en desarrollo y está sujeta a cambios rápidos y rotundos. Tampoco hay garantía de que las funciones de la versión beta se trasladen a la versión estable. Debido a esta inestabilidad, te recomendamos que no lances aplicaciones de producción con esta versión.

• : Compatible
• : Nunca será compatible

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

El SDK de la API de Gemini usa v1beta de forma predeterminada, pero puedes optar por usar otras versiones configurando la versión de la API como se muestra en el siguiente ejemplo de código:

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