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 iniciales que pueden estar en desarrollo y están sujetas a cambios rotundos. Tampoco hay garantía de 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 que interrumpan el funcionamiento, no debes usar esta versión en producció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."}]
    }]
   }'