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 que no son compatibles con versiones anteriores, 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.
| Función | v1 | v1beta |
|---|---|---|
| Genera contenido: Entrada de solo texto | ||
| Genera contenido: Entrada de texto y una imagen | ||
| Genera contenido: Salida de texto | ||
| Genera contenido: conversaciones de varios turnos (chat) | ||
| Genera contenido: Llamadas a función | ||
| Genera contenido: Transmisión | ||
| Incorpora contenido: Entrada de solo texto | ||
| Generar respuesta | ||
| Recuperador semántico |
- : Compatible
- : Nunca se admitirá.
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 v1 en su lugar. Para ello, configura la versión de la API como se muestra en el siguiente ejemplo de código:
Python
El SDK de Python, google.generativeai, usa v1beta y no proporciona un método para cambiar la versión de la API.
La biblioteca cliente de Python de bajo nivel, google.ai.generativelanguage, expone
otras versiones como módulos separados: google.ai.generativelanguage_v1 y
google.ai.generativelanguage_v1beta. El valor predeterminado es v1beta.
import google.ai.generativelanguage_v1 as glm
client = glm.GenerativeServiceClient(
client_options=dict(api_key=YOUR_API_KEY))
response = client.generate_content({
"model": "models/gemini-1.5-flash",
"contents": [ {"parts": [ {"text": "Explain how AI works"}]}]
})
print(type(response).to_dict(response))
Node.js
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());
REST
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": "Write a story about a magic backpack."}]
}]
}'