Este guia mostra como começar a usar o SDK da IA generativa do Google, abordando os seguintes tópicos:
O SDK da IA generativa do Google oferece uma interface unificada para os modelos Gemini 2.5 Pro e Gemini 2.0 pela API Gemini Developer e pela API Gemini na Vertex AI. Com algumas exceções, o código
que é executado em uma plataforma será executado nas duas. Isso significa que você pode criar um protótipo de
aplicativo usando a API Gemini para desenvolvedores e migrar o
aplicativo para a Vertex AI sem reescrever o código. Para saber mais sobre as diferenças entre a API Gemini Developer
e o Gemini na Vertex AI, consulte
Migrar da API Gemini Developer para a API Gemini na Vertex AI. O SDK de IA generativa do Google para Python está disponível no PyPI e no GitHub: Para saber mais, consulte a referência do SDK para Python.
Defina variáveis de ambiente para usar o SDK de IA generativa com a Vertex AI:
O SDK do Google Gen AI para Python pode ser usado com a plataforma completa da Vertex AI ou com a Vertex AI no modo rápido. A tabela a seguir resume as principais diferenças. Este exemplo usa a autenticação padrão do Google Cloud para se conectar à API Vertex AI. Este exemplo usa uma chave de API para se conectar à API Vertex AI no modo rápido. O SDK da IA generativa do Google para Go está disponível em go.dev e no GitHub:
Defina variáveis de ambiente para usar o SDK de IA generativa com a Vertex AI:
O SDK da IA generativa do Google para TypeScript e JavaScript está disponível no npm e no GitHub:
Defina variáveis de ambiente para usar o SDK de IA generativa com a Vertex AI:
O SDK da IA generativa do Google para Java está disponível no Maven Central e no GitHub:
Defina variáveis de ambiente para usar o SDK de IA generativa com a Vertex AI:
Python
Instalar
pip install --upgrade google-genai
# Replace the `GOOGLE_CLOUD_PROJECT` and `GOOGLE_CLOUD_LOCATION` values
# with appropriate values for your project.
export GOOGLE_CLOUD_PROJECT=GOOGLE_CLOUD_PROJECT
export GOOGLE_CLOUD_LOCATION=global
export GOOGLE_GENAI_USE_VERTEXAI=True
Guia de início rápido
Opção
Descrição
Autenticação
Caso de uso
Vertex AI
Oferece acesso a todos os recursos e serviços do Google Cloud , incluindo segurança, governança e recursos de MLOps de nível empresarial.
Usa a autenticação padrão do Google Cloud (por exemplo, Application Default Credentials).
Aplicativos de produção, ambientes empresariais e fluxos de trabalho que exigem integração com outros serviços do Google Cloud.
Vertex AI (modo Express)
Uma experiência simplificada baseada em chaves de API para prototipagem e desenvolvimento rápidos, semelhante à API Gemini Developer.
Usa uma chave de API para autenticação.
Prototipagem rápida, tutoriais e início rápido sem configuração completa do Google Cloud projeto. Para mais informações, consulte [Modo rápido da Vertex AI](/vertex-ai/generative-ai/docs/start/express-mode/overview#workflow).
Escolha a guia que corresponde ao seu caso de uso.Vertex AI
Vertex AI (modo Express)
Go
Instalar
go get google.golang.org/genai
# Replace the `GOOGLE_CLOUD_PROJECT` and `GOOGLE_CLOUD_LOCATION` values
# with appropriate values for your project.
export GOOGLE_CLOUD_PROJECT=GOOGLE_CLOUD_PROJECT
export GOOGLE_CLOUD_LOCATION=global
export GOOGLE_GENAI_USE_VERTEXAI=True
Guia de início rápido
Node.js
Instalar
npm install @google/genai
# Replace the `GOOGLE_CLOUD_PROJECT` and `GOOGLE_CLOUD_LOCATION` values
# with appropriate values for your project.
export GOOGLE_CLOUD_PROJECT=GOOGLE_CLOUD_PROJECT
export GOOGLE_CLOUD_LOCATION=global
export GOOGLE_GENAI_USE_VERTEXAI=True
Guia de início rápido
Java
Instalação do Maven
<dependencies>
<dependency>
<groupId>com.google.genai</groupId>
<artifactId>google-genai</artifactId>
<version>1.4.1</version>
</dependency>
</dependencies>
# Replace the `GOOGLE_CLOUD_PROJECT` and `GOOGLE_CLOUD_LOCATION` values
# with appropriate values for your project.
export GOOGLE_CLOUD_PROJECT=GOOGLE_CLOUD_PROJECT
export GOOGLE_CLOUD_LOCATION=global
export GOOGLE_GENAI_USE_VERTEXAI=True
Guia de início rápido
SDK do Google Gen AI
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-08-19 UTC.