Cuando compiles con la API de Gemini, te recomendamos que uses el SDK de GenAI de Google. Estas son las bibliotecas oficiales listas para producción que desarrollamos y mantenemos para los lenguajes más populares. Están en disponibilidad general y se usan en toda nuestra documentación y ejemplos oficiales.
Si no tienes experiencia con la API de Gemini, sigue nuestra guía de inicio rápido para comenzar.
Compatibilidad con idiomas e instalación
El SDK de IA generativa de Google está disponible para los lenguajes Python, JavaScript/TypeScript, Go y Java. Puedes instalar la biblioteca de cada lenguaje con administradores de paquetes o visitar sus repositorios de GitHub para obtener más información:
Python
Biblioteca:
google-genai
Repositorio de GitHub: googleapis/python-genai
Instalación:
pip install google-genai
JavaScript
Biblioteca:
@google/genai
Repositorio de GitHub: googleapis/js-genai
Instalación:
npm install @google/genai
Go
Biblioteca:
google.golang.org/genai
Repositorio de GitHub: googleapis/go-genai
Instalación:
go get google.golang.org/genai
Java
Biblioteca:
google-genai
Repositorio de GitHub: googleapis/java-genai
Instalación: Si usas Maven, agrega lo siguiente a tus dependencias:
<dependencies>
<dependency>
<groupId>com.google.genai</groupId>
<artifactId>google-genai</artifactId>
<version>1.0.0</version>
</dependency>
</dependencies>
Disponibilidad general
Comenzamos a lanzar el SDK de IA generativa de Google, un nuevo conjunto de bibliotecas para acceder a la API de Gemini, a fines de 2024, cuando lanzamos Gemini 2.0.
A partir de mayo de 2025, alcanzaron la disponibilidad general (GA) en todas las plataformas compatibles y son las bibliotecas recomendadas para acceder a la API de Gemini. Son estables, tienen asistencia completa para el uso en producción y se mantienen de forma activa. Proporcionan acceso a las funciones más recientes y ofrecen el mejor rendimiento cuando se trabaja con Gemini.
Si usas una de nuestras bibliotecas heredadas, te recomendamos que migres para que puedas acceder a las funciones más recientes y obtener el mejor rendimiento cuando trabajes con Gemini. Consulta la sección sobre bibliotecas heredadas para obtener más información.
Bibliotecas heredadas y migración
Si usas una de nuestras bibliotecas heredadas, te recomendamos que migres a las nuevas bibliotecas.
Las bibliotecas heredadas no brindan acceso a funciones recientes (como la API de Live y Veo) y están en proceso de baja. Dejarán de recibir actualizaciones a fines de septiembre de 2025, las brechas de funciones aumentarán y es posible que ya no se corrijan los errores potenciales.
El estado de compatibilidad de cada biblioteca heredada varía, como se detalla en la siguiente tabla:
Idioma | Biblioteca heredada | Estado de compatibilidad | Biblioteca recomendada |
---|---|---|---|
Python | google-generativeai |
Toda la asistencia, incluidas las correcciones de errores, finalizará a fines de septiembre de 2025. | google-genai |
JavaScript/TypeScript | @google/generativeai |
Toda la asistencia, incluidas las correcciones de errores, finalizará a fines de septiembre de 2025. | @google/genai |
Go | google.golang.org/generative-ai |
Toda la asistencia, incluidas las correcciones de errores, finalizará a fines de septiembre de 2025. | google.golang.org/genai |
Dart y Flutter | google_generative_ai |
Sin mantenimiento activo | Usa bibliotecas de terceros o de la comunidad de confianza, como firebase_ai, o accede con la API de REST. |
Swift | generative-ai-swift |
Sin mantenimiento activo | Usa Gemini en Firebase |
Android | generative-ai-android |
Sin mantenimiento activo | Usa Gemini en Firebase |
Nota para desarrolladores de Java: No había un SDK de Java heredado proporcionado por Google para la API de Gemini, por lo que no se requiere ninguna migración desde una biblioteca anterior de Google. Puedes comenzar directamente con la nueva biblioteca en la sección Compatibilidad con idiomas y la instalación.