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 compatibles por completo durante el ciclo de vida de la versión principal. Si hay cambios rotundos, se creará la próxima versión principal de la API y la versión existente dejará de estar disponible después de un período razonable. Se pueden introducir cambios sin interrupciones 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án sujetas a cambios rápidos y rotundos. Tampoco hay ninguna 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 inicies aplicaciones de producción con esta versión.

• : Compatible
• : Nunca se admitirá.

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

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

from google import genai

client = genai.Client(api_key="YOUR_API_KEY",
                      http_options={'api_version': 'v1alpha'})

response = client.models.generate_content(
    model='gemini-2.0-flash',
    contents="Explain how AI works",
)

print(response.text)

const { GoogleGenerativeAI } = require("@google/generative-ai");

const genAI = new GoogleGenerativeAI("YOUR_API_KEY");
const model = genAI.getGenerativeModel({ model: 'gemini-1.5-flash' }, { apiVersion: 'v1' });

const prompt = "Explain how AI works";

const result = await model.generateContent(prompt);
console.log(result.response.text());

curl "https://generativelanguage.googleapis.com/v1/models/gemini-1.5-flash:generateContent?key=YOUR_API_KEY" \
-H 'Content-Type: application/json' \
-X POST \
-d '{
  "contents": [{
    "parts":[{"text": "Explain how AI works."}]
    }]
   }'