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
Biblioteca:
google-genai
Repositório do GitHub: googleapis/python-genai
Instalação:
pip install google-genai
JavaScript
Biblioteca:
@google/genai
Repositório do GitHub: googleapis/js-genai
Instalação:
npm install @google/genai
Go
Biblioteca:
google.golang.org/genai
Repositório do GitHub: googleapis/go-genai
Instalação:
go get google.golang.org/genai
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.