Bibliotecas de la API de Gemini

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

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, 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.