Bibliotecas da API Gemini

Ao criar com a API Gemini, recomendamos usar o SDK da IA generativa do Google. São as bibliotecas oficiais e prontas para produção que desenvolvemos e mantemos para as linguagens mais usadas. Elas estão em disponibilidade geral e são usadas em toda a documentação e exemplos oficiais.

Se você nunca usou a API Gemini, siga nosso guia de início rápido para começar.

Suporte e instalação de idiomas

O SDK da IA generativa do Google está disponível para as linguagens Python, JavaScript/TypeScript, Go e Java. É possível instalar a biblioteca de cada linguagem usando gerenciadores de pacotes ou acessar os repositórios do GitHub para mais informações:

Python

JavaScript

Go

Java

  • Biblioteca: google-genai

  • Repositório do GitHub: googleapis/java-genai

  • Instalação: se você estiver usando o Maven, adicione o seguinte às dependências:

<dependencies>
  <dependency>
    <groupId>com.google.genai</groupId>
    <artifactId>google-genai</artifactId>
    <version>1.0.0</version>
  </dependency>
</dependencies>

Disponibilidade geral

Começamos a lançar o SDK da IA generativa do Google, um novo conjunto de bibliotecas para acessar a API Gemini, no final de 2024, quando lançamos o Gemini 2.0.

Em maio de 2025, elas alcançaram a disponibilidade geral (GA) em todas as plataformas compatíveis e são as bibliotecas recomendadas para acessar a API Gemini. Elas são estáveis, têm suporte total para uso em produção e são mantidas ativamente. Eles oferecem acesso aos recursos mais recentes e o melhor desempenho ao trabalhar com o Gemini.

Se você estiver usando uma das nossas bibliotecas legadas, recomendamos migrar para ter acesso aos recursos mais recentes e aproveitar o melhor desempenho ao trabalhar com o Gemini. Consulte a seção bibliotecas legadas para mais informações.

Bibliotecas legadas e migração

Se você estiver usando uma das nossas bibliotecas legadas, recomendamos que migre para as novas bibliotecas.

As bibliotecas legadas não oferecem acesso a recursos recentes, como a API Live e o Veo, e estão em um caminho de descontinuação. Eles vão parar de receber atualizações no fim de setembro de 2025, as lacunas de recursos vão aumentar e possíveis bugs não serão mais corrigidos.

O status de suporte de cada biblioteca legada varia, conforme detalhado na tabela a seguir:

Idioma Biblioteca legada Status de compatibilidade Biblioteca recomendada
Python google-generativeai Todo o suporte, incluindo correções de bugs, será encerrado no fim de setembro de 2025. google-genai
JavaScript/TypeScript @google/generativeai Todo o suporte, incluindo correções de bugs, será encerrado no fim de setembro de 2025. @google/genai
Go google.golang.org/generative-ai Todo o suporte, incluindo correções de bugs, será encerrado no fim de setembro de 2025. google.golang.org/genai
Dart e Flutter google_generative_ai Não mantido ativamente Use bibliotecas confiáveis da comunidade ou de terceiros, como firebase_ai, ou acesse usando a API REST.
Swift generative-ai-swift Não mantido ativamente Usar o Gemini no Firebase
Android generative-ai-android Não mantido ativamente Usar o Gemini no Firebase

Observação para desenvolvedores Java:não havia um SDK Java legado fornecido pelo Google para a API Gemini. Portanto, não é necessário migrar de uma biblioteca anterior do Google. Você pode começar diretamente com a nova biblioteca na seção Suporte a idiomas e instalação.