Nesta página, você vai aprender a enviar solicitações com rapidez para a API Vertex AI Gemini usando o console do Google Cloud, um SDK de linguagem de programação ou a API REST.
Ainda não conhece o Google Cloud?
Configuração do Google Cloud
Se você começou a usar o Google Cloud agora, crie uma conta para avaliar o desempenho dos nossos produtos em situações reais. Clientes novos ganham US$ 300 em créditos para executar, testar e implantar cargas de trabalho. O processo de configuração tem apenas três etapas curtas:
Use o botão a seguir para criar uma conta. Depois, volte a esta página para concluir este tutorial para iniciantes. Para usar todos os recursos disponíveis neste site, faça login usando sua conta.
Crie uma contaPara mais informações sobre como configurar o Google Cloud, consulte Configurar no Google Cloud.
Enviar uma solicitação para a API Vertex AI Gemini
Para conferir as instruções de envio de uma solicitação à API Vertex AI Gemini, selecione uma das seguintes guias:
Python
- Para selecionar um projeto do Google Cloud, faça isto:
No console do Google Cloud, abra a página Painel.
Clique na lista de seleção de projetos na parte superior da página. Na janela Selecionar um recurso exibida, selecione um projeto.
- Anote o ID do projeto exibido na seção Informações do projeto. Você precisará do ID do projeto para as próximas etapas.
-
No Console do Google Cloud, ative o Cloud Shell.
Na parte inferior do Console do Google Cloud, uma sessão do Cloud Shell é iniciada e exibe um prompt de linha de comando. O Cloud Shell é um ambiente shell com a CLI do Google Cloud já instalada e com valores já definidos para o projeto atual. A inicialização da sessão pode levar alguns segundos.
No Cloud Shell, instale ou atualize o SDK da Vertex AI para Python executando o seguinte comando:
pip3 install "google-cloud-aiplatform>=1.38"
Envie uma solicitação. Substitua PROJECT_ID pelo ID do projeto do Google Cloud.
Para mais informações sobre como instalar, atualizar e usar o SDK da Vertex AI para Python, consulte Instalar o SDK da Vertex AI para Python e a documentação de referência da API do SDK da Vertex AI para Python.
Node.js
- Para selecionar um projeto do Google Cloud, faça isto:
No console do Google Cloud, abra a página Painel.
Clique na lista de seleção de projetos na parte superior da página. Na janela Selecionar um recurso exibida, selecione um projeto.
- Anote o ID do projeto exibido na seção Informações do projeto. Você precisará do ID do projeto para as próximas etapas.
-
No Console do Google Cloud, ative o Cloud Shell.
Na parte inferior do Console do Google Cloud, uma sessão do Cloud Shell é iniciada e exibe um prompt de linha de comando. O Cloud Shell é um ambiente shell com a CLI do Google Cloud já instalada e com valores já definidos para o projeto atual. A inicialização da sessão pode levar alguns segundos.
No Cloud Shell, instale ou atualize o SDK da Vertex AI para Node.js executando o seguinte comando:
npm install @google-cloud/vertexai
Envie uma solicitação. Substitua PROJECT_ID pelo ID do projeto do Google Cloud.
Para mais informações sobre como instalar e usar o SDK da Vertex AI para Node.js, consulte a documentação de referência do SDK da Vertex AI para Node.js.
Java
Para selecionar um projeto do Google Cloud, faça isto:
No Console do Google Cloud, abra a página Painel.
Clique na lista de seleção de projetos na parte superior da página. Na janela Selecionar um recurso exibida, selecione um projeto.
Anote o ID do projeto exibido na seção Informações do projeto. Você precisará do ID do projeto para as próximas etapas.
Execute o seguinte comando para autenticar. Substitua PROJECT_ID pelo ID do projeto do Google Cloud e ACCOUNT pelo nome de usuário do Google Cloud.
gcloud config set project PROJECT_ID && gcloud auth login ACCOUNT
Adicione
google-cloud-vertexai
como dependência:<!--If you are using Maven with BOM, add the following in your pom.xml--> <dependencyManagement> <dependencies> <dependency> <groupId>com.google.cloud</groupId> <artifactId>libraries-bom</artifactId> <version>26.32.0</version> <type>pom</type> <scope>import</scope> </dependency> </dependencies> </dependencyManagement> <dependencies> <dependency> <groupId>com.google.cloud</groupId> <artifactId>google-cloud-vertexai</artifactId> </dependency> </dependencies> <!--If you are using Maven without BOM, add the following to your pom.xml--> <dependency> <groupId>com.google.cloud</groupId> <artifactId>google-cloud-vertexai</artifactId> <version>0.4.0</version> </dependency> <!--If you are using Gradle without BOM, add the following to your build.gradle--> implementation 'com.google.cloud:google-cloud-vertexai:0.4.0'
Envie uma solicitação. Defina
projectID
como o ID do projeto do Google Cloud.Para mais informações sobre como instalar e usar o Kit de desenvolvimento em Java da Vertex AI (JDK), consulte a documentação de referência do Vertex AI JDK.
Go
- Para selecionar um projeto do Google Cloud, faça isto:
No console do Google Cloud, abra a página Painel.
Clique na lista de seleção de projetos na parte superior da página. Na janela Selecionar um recurso exibida, selecione um projeto.
- Anote o ID do projeto exibido na seção Informações do projeto. Você precisará do ID do projeto para as próximas etapas.
- Prepare seu ambiente para o desenvolvimento para Go.
Revise os pacotes disponíveis da API Vertex AI em Go para determinar qual pacote atende melhor às necessidades do seu projeto:
Pacote cloud.google.com/go/vertexai (recomendado)
vertexai
é um pacote criado por humanos que fornece acesso a recursos e capabilities comuns.Esse pacote é recomendado como ponto de partida para a maioria dos desenvolvedores que criam usando a API Vertex AI. Para acessar recursos e capabilities ainda não cobertos por esse pacote, use o
aiplatform
gerado automaticamente.Pacote cloud.google.com/go/aiplatform
aiplatform
é um pacote gerado automaticamente.Esse pacote é destinado a projetos que exigem acesso a recursos e capabilities da API Vertex AI ainda não fornecidos pelo pacote
vertexai
criado por humanos.
Instale o pacote Go desejado com base nas necessidades do seu projeto executando um dos seguintes comandos:
# Human authored package. Recommended for most developers. go get cloud.google.com/go/vertexai
# Auto-generated package. go get cloud.google.com/go/aiplatformEnvie uma solicitação. Substitua PROJECT_ID pelo ID do projeto do Google Cloud.
Para mais informações sobre como instalar e usar o SDK da Vertex AI para Go, consulte a documentação de referência do SDK da Vertex AI para Go.
C#
Antes de testar essa amostra, siga as instruções de configuração para C# Guia de início rápido da Vertex AI: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Vertex AI para C#.
Para autenticar na Vertex AI, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
REST
Para selecionar um projeto do Google Cloud, faça isto:
No Console do Google Cloud, abra a página Painel.
Clique na lista de seleção de projetos na parte superior da página. Na janela Selecionar um recurso exibida, selecione um projeto.
Anote o ID do projeto exibido na seção Informações do projeto. Você precisará do ID do projeto para as próximas etapas.
No Console do Google Cloud, ative o Cloud Shell.
Insira o comando abaixo para configurar as variáveis de ambiente. Substitua PROJECT_ID pelo ID do projeto do Google Cloud.
MODEL_ID="gemini-1.0-pro-vision" PROJECT_ID="PROJECT_ID"
Provisione o endpoint:
gcloud beta services identity create --service=aiplatform.googleapis.com --project=PROJECT_ID
Digite o seguinte comando curl para enviar uma solicitação de prompt:
curl \ -X POST \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ -H "Content-Type: application/json" \ https://us-central1-aiplatform.googleapis.com/v1/projects/${PROJECT_ID}/locations/us-central1/publishers/google/models/${MODEL_ID}:streamGenerateContent -d \ $'{ "contents": { "role": "user", "parts": [ { "fileData": { "mimeType": "image/jpeg", "fileUri": "gs://generativeai-downloads/images/scones.jpg" } }, { "text": "Describe this picture." } ] } }'
Se for preciso autorizar o Cloud Shell, clique em Autorizar.
O modelo retorna uma resposta. A resposta é gerada em seções, e cada uma delas é avaliada separadamente quanto à segurança.
Console
Use o Vertex AI Studio para criar e iterar rapidamente seus comandos. Depois que o comando estiver pronto, será possível acessá-lo em qualquer uma das linguagens de programação compatíveis.
- Para selecionar um projeto do Google Cloud, faça isto:
No console do Google Cloud, abra a página Painel.
Clique na lista de seleção de projetos na parte superior da página. Na janela Selecionar um recurso exibida, selecione um projeto.
No console do Google Cloud, acesse a página Vertex AI Studio.
Clique em Multimodal.
Em Exemplos de comandos, localize o comando Extrair texto das imagens e clique em Abrir.
A página de solicitação é aberta e o comando é preenchido no campo Prompt.
Envie o comando clicando em Enviar.
O modelo retorna uma resposta.
Confira o código equivalente a essa solicitação de solicitação clicando em
Ver código.
A seguir
- Consulte a referência da API Vertex AI Gemini.
- Consulte a referência do SDK para Python da API Vertex AI Gemini.
- Saiba mais sobre modelos multimodais.