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 es la primera vez que usas 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

A fines de 2024, cuando lanzamos Gemini 2.0, comenzamos a implementar el SDK de IA generativa de Google, un nuevo conjunto de bibliotecas para acceder a la API de Gemini.

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 técnica completa para su 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 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 proporcionan acceso a funciones recientes (como la API en vivo y Veo) y están en proceso de baja. Dejarán de recibir actualizaciones el 30 de noviembre de 2025, aumentarán las brechas de funciones 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á el 30 de noviembre de 2025. google-genai
JavaScript/TypeScript @google/generativeai Toda la asistencia, incluidas las correcciones de errores, finalizará el 30 de noviembre de 2025. @google/genai
Go google.golang.org/generative-ai Toda la asistencia, incluidas las correcciones de errores, finalizará el 30 de noviembre 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 Firebase AI Logic
Android generative-ai-android Sin mantenimiento activo Usa Firebase AI Logic

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 configuración.

Plantillas de instrucciones para la generación de código

Modelos generativos (p.ej., Gemini, Claude) y los IDE potenciados por IA (p.ej., Cursor) puede generar código para la API de Gemini con bibliotecas obsoletas o descontinuadas debido a la fecha límite de sus datos de entrenamiento. Para que el código generado use las bibliotecas más recientes y recomendadas, proporciona orientación sobre la versión y el uso directamente en tus instrucciones. Puedes usar las siguientes plantillas para proporcionar el contexto necesario: