Bibliotecas da API Gemini

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

Se você não conhece a API Gemini, siga nosso guia de início rápido para começar.

Suporte a idiomas e instalação

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 isto às dependências:

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

C#

  • Biblioteca: Google.GenAI

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

  • Instalação: dotnet add package Google.GenAI

Disponibilidade geral

Em maio de 2025, o SDK da IA generativa do Google atingiu a disponibilidade geral (GA, na sigla em inglês) 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. Elas 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 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 você migre para as novas bibliotecas.

As bibliotecas legadas não oferecem acesso a recursos recentes (como a API Live e Veo) e foram descontinuadas em 30 de novembro de 2025.

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

Idioma Biblioteca legada Status de suporte Biblioteca recomendada
Python google-generativeai Não é mantida ativamente google-genai
JavaScript/TypeScript @google/generativeai Não é mantida ativamente @google/genai
Go google.golang.org/generative-ai Não é mantida ativamente google.golang.org/genai
Dart e Flutter google_generative_ai Não é mantida ativamente Use o Genkit Dart ou o Firebase AI Logic
Swift generative-ai-swift Não é mantida ativamente Use o Firebase AI Logic
Android generative-ai-android Não é mantida ativamente Use 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ária a migração de uma biblioteca anterior do Google. Você pode começar diretamente com a nova biblioteca na seção Suporte a idiomas e instalação.