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 dão acesso aos recursos mais recentes e oferecem a melhor performance 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 em 30 de novembro 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, termina em 30 de novembro de 2025. google-genai
JavaScript/TypeScript @google/generativeai Todo o suporte, incluindo correções de bugs, termina em 30 de novembro de 2025. @google/genai
Go google.golang.org/generative-ai Todo o suporte, incluindo correções de bugs, termina em 30 de novembro 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 Firebase AI Logic
Android generative-ai-android Não mantido ativamente Usar o Firebase AI Logic

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.

Modelos de comando para geração de código

Modelos generativos (por exemplo, Gemini, Claude) e IDEs com tecnologia de IA (por exemplo, Cursor) pode produzir código para a API Gemini usando bibliotecas desatualizadas ou obsoletas devido ao corte dos dados de treinamento. Para que o código gerado use as bibliotecas mais recentes e recomendadas, forneça orientações de versão e uso diretamente nos comandos. Use os modelos abaixo para fornecer o contexto necessário: