Bibliotecas de la API de Gemini

Cuando compiles con la API de Gemini, te recomendamos que uses nuestra colección oficial de bibliotecas en los principales lenguajes: el SDK de Google GenAI. Están listos para la producción en la Disponibilidad general. Nuestros ejemplos y documentación en todo este sitio se compilan con estas bibliotecas.

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

JavaScript

Go

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 a finales de 2024. En mayo de 2025, alcanzó la disponibilidad general (DG) en todas las plataformas compatibles. Esto significa que las bibliotecas son estables y se admiten por completo para su uso en producción. Se mantienen de forma activa, brindan acceso a las funciones más recientes y ofrecen el mejor rendimiento cuando se trabaja con Gemini.

Si no usas el SDK de GenAI de Google y utilizas una de nuestras bibliotecas heredadas, te recomendamos que migres. 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.