Guia de início rápido: gerar texto usando a API Gemini na Vertex AI
Neste guia de início rápido, você envia as seguintes solicitações multimodais para a API Gemini na Vertex AI e confere as respostas:
- Um comando de texto
- Um comando e uma imagem
- Um comando e um arquivo de vídeo (com uma faixa de áudio)
É possível concluir este guia de início rápido usando um SDK de linguagem de programação no seu ambiente local ou a API REST.
Pré-requisitos
Para concluir este guia de início rápido, você precisa:
- Configurar um projeto Google Cloud e ativar a API Vertex AI
- Na sua máquina local:
- Instalar, inicializar e autenticar com a Google Cloud CLI
- Instalar o SDK da sua linguagem
Configurar um projeto do Google Cloud
Configure seu projeto Google Cloud e ative a API Vertex AI.
- Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Vertex AI API.
-
Make sure that you have the following role or roles on the project: Vertex AI Platform Express User
Check for the roles
-
In the Google Cloud console, go to the IAM page.
Go to IAM - Select the project.
-
In the Principal column, find all rows that identify you or a group that you're included in. To learn which groups you're included in, contact your administrator.
- For all rows that specify or include you, check the Role column to see whether the list of roles includes the required roles.
Grant the roles
-
In the Google Cloud console, go to the IAM page.
Acessar o IAM - Selecionar um projeto.
- Clique em CONCEDER ACESSO.
-
No campo Novos principais, insira seu identificador de usuário. Normalmente, é o endereço de e-mail de uma Conta do Google.
- Na lista Selecionar um papel, escolha um.
- Para conceder outros papéis, clique em Adicionar outro papel e adicione cada papel adicional.
- Clique em Salvar.
-
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Vertex AI API.
-
Make sure that you have the following role or roles on the project: Vertex AI Platform Express User
Check for the roles
-
In the Google Cloud console, go to the IAM page.
Go to IAM - Select the project.
-
In the Principal column, find all rows that identify you or a group that you're included in. To learn which groups you're included in, contact your administrator.
- For all rows that specify or include you, check the Role column to see whether the list of roles includes the required roles.
Grant the roles
-
In the Google Cloud console, go to the IAM page.
Acessar o IAM - Selecionar um projeto.
- Clique em CONCEDER ACESSO.
-
No campo Novos principais, insira seu identificador de usuário. Normalmente, é o endereço de e-mail de uma Conta do Google.
- Na lista Selecionar um papel, escolha um.
- Para conceder outros papéis, clique em Adicionar outro papel e adicione cada papel adicional.
- Clique em Salvar.
-
-
Instale e inicialize a Google Cloud CLI.
-
Se você já instalou a CLI gcloud, execute este comando para garantir que os componentes
gcloud
estejam atualizados.gcloud components update
-
Para autenticar com a CLI gcloud, gere um arquivo local de Application Default Credentials (ADC) executando este comando. O fluxo da Web iniciado pelo comando é usado para fornecer suas credenciais de usuário.
gcloud auth application-default login
Para mais informações, consulte Configurar o Application Default Credentials.
Insira o comando abaixo para configurar as variáveis de ambiente. Substitua
PROJECT_ID
pelo ID do seu Google Cloud projeto.MODEL_ID="gemini-2.0-flash-001" PROJECT_ID="PROJECT_ID"
Use a Google Cloud CLI para provisionar o endpoint executando este comando.
gcloud beta services identity create --service=aiplatform.googleapis.com --project=${PROJECT_ID}
- Saiba mais sobre a API Gemini na Vertex AI.
- Confira a referência do SDK da IA generativa do Google.
- Saiba como chamar modelos da Vertex AI usando a biblioteca da OpenAI.
Instalar e autenticar com a Google Cloud CLI
Para usar a API Gemini na Vertex AI, configure e autentique a Google Cloud CLI na sua máquina local. Ao contrário da API Gemini no Google AI Studio, que usa chaves de API, a API Gemini na Vertex AI gerencia o acesso com o Identity and Access Management.
Configurar o SDK para sua linguagem de programação
Na máquina local, clique em uma das seguintes guias para instalar o SDK da linguagem de programação.
SDK da IA generativa para Python
Instale e atualize o SDK de IA generativa para Python executando este comando.
pip install --upgrade google-genai
SDK de IA generativa para Go
Instale e atualize o SDK da IA generativa para Go executando este comando.
go get google.golang.org/genai
SDK da IA generativa para Node.js
Instale e atualize o SDK da IA generativa para Node.js executando este comando.
npm install @google/genai
SDK de IA generativa para Java
Instale e atualize o SDK da IA generativa para Java:
Maven
Adicione o seguinte ao seu pom.xml
:
<dependencies>
<dependency>
<groupId>com.google.genai</groupId>
<artifactId>google-genai</artifactId>
<version>0.7.0</version>
</dependency>
</dependencies>
C#
Instale o pacote Google.Cloud.AIPlatform.V1
pelo NuGet. Use seu método preferido para adicionar pacotes ao projeto. Por exemplo, clique com o botão direito do mouse no projeto no Visual Studio e escolha Gerenciar pacotes NuGet....
REST
Enviar um comando para a API Gemini na Vertex AI
Use o código a seguir para enviar um comando à API Gemini na Vertex AI. Este exemplo retorna uma lista de possíveis nomes para uma floricultura especializada.
É possível executar o código na linha de comando, usando um ambiente de desenvolvimento integrado ou incluindo o código no aplicativo.
Gen AI SDK for Python
Instalar
pip install --upgrade google-genai
Para saber mais, consulte a documentação de referência do SDK.
Defina variáveis de ambiente para usar o SDK de IA generativa com a Vertex AI:
# 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
Gen AI SDK for Go
Saiba como instalar ou atualizar o Gen AI SDK for Go.
Para saber mais, consulte a documentação de referência do SDK.
Defina variáveis de ambiente para usar o SDK de IA generativa com a Vertex AI:
# 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
Gen AI SDK for Node.js
Instalar
npm install @google/genai
Para saber mais, consulte a documentação de referência do SDK.
Defina variáveis de ambiente para usar o SDK de IA generativa com a Vertex AI:
# 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
Gen AI SDK for Java
Saiba como instalar ou atualizar o Gen AI SDK for Java.
Para saber mais, consulte a documentação de referência do SDK.
Defina variáveis de ambiente para usar o SDK de IA generativa com a Vertex AI:
# 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
C#
Para enviar uma solicitação de prompt, crie um arquivo C# (.cs
) e copie o
código a seguir no arquivo. Defina your-project-id
como o ID do projeto Google Cloud . Depois de atualizar os valores, execute o código.
REST
Para enviar essa solicitação de comando, execute o comando curl na linha de comando ou inclua a chamada REST no seu aplicativo.
curl -X POST \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ https://aiplatform.googleapis.com/v1/projects/${PROJECT_ID}/locations/global/publishers/google/models/${MODEL_ID}:generateContent -d \ $'{ "contents": { "role": "user", "parts": [ { "text": "What\'s a good name for a flower shop that specializes in selling bouquets of dried flowers?" } ] } }'
Enviar um comando e uma imagem para a API Gemini na Vertex AI
Use o código a seguir para enviar um comando que inclua texto e uma imagem para a API Gemini na Vertex AI. Este exemplo retorna uma descrição da imagem fornecida (imagem para amostra Java).
Gen AI SDK for Python
Instalar
pip install --upgrade google-genai
Para saber mais, consulte a documentação de referência do SDK.
Defina variáveis de ambiente para usar o SDK de IA generativa com a Vertex AI:
# 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
Gen AI SDK for Go
Saiba como instalar ou atualizar o Gen AI SDK for Go.
Para saber mais, consulte a documentação de referência do SDK.
Defina variáveis de ambiente para usar o SDK de IA generativa com a Vertex AI:
# 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
Gen AI SDK for Node.js
Instalar
npm install @google/genai
Para saber mais, consulte a documentação de referência do SDK.
Defina variáveis de ambiente para usar o SDK de IA generativa com a Vertex AI:
# 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
Gen AI SDK for Java
Saiba como instalar ou atualizar o Gen AI SDK for Java.
Para saber mais, consulte a documentação de referência do SDK.
Defina variáveis de ambiente para usar o SDK de IA generativa com a Vertex AI:
# 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
C#
Para enviar uma solicitação de prompt, crie um arquivo C# (.cs
) e copie o
código a seguir no arquivo. Defina your-project-id
como o ID do projeto Google Cloud . Depois de atualizar os valores, execute o código.
REST
É possível enviar essa solicitação de prompt do seu ambiente de desenvolvimento integrado ou incorporar a chamada REST ao aplicativo quando apropriado.
curl -X POST \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ https://aiplatform.googleapis.com/v1/projects/${PROJECT_ID}/locations/global/publishers/google/models/${MODEL_ID}:generateContent -d \ $'{ "contents": { "role": "user", "parts": [ { "fileData": { "mimeType": "image/jpeg", "fileUri": "gs://generativeai-downloads/images/scones.jpg" } }, { "text": "Describe this picture." } ] } }'
O modelo retorna uma resposta. A resposta é gerada em seções, e cada uma delas é avaliada separadamente quanto à segurança.
Enviar um comando e um vídeo para a API Gemini na Vertex AI
Use o código a seguir para enviar um comando que inclua texto, áudio e vídeo para a API Gemini na Vertex AI. Essa amostra retorna uma descrição do vídeo fornecido, incluindo qualquer coisa importante da faixa de áudio.
É possível enviar essa solicitação de comando usando a linha de comando, o ambiente de desenvolvimento integrado ou incluindo a chamada REST no aplicativo.
Gen AI SDK for Python
Instalar
pip install --upgrade google-genai
Para saber mais, consulte a documentação de referência do SDK.
Defina variáveis de ambiente para usar o SDK de IA generativa com a Vertex AI:
# 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
Gen AI SDK for Go
Saiba como instalar ou atualizar o Gen AI SDK for Go.
Para saber mais, consulte a documentação de referência do SDK.
Defina variáveis de ambiente para usar o SDK de IA generativa com a Vertex AI:
# 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
Gen AI SDK for Node.js
Instalar
npm install @google/genai
Para saber mais, consulte a documentação de referência do SDK.
Defina variáveis de ambiente para usar o SDK de IA generativa com a Vertex AI:
# 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
Gen AI SDK for Java
Saiba como instalar ou atualizar o Gen AI SDK for Java.
Para saber mais, consulte a documentação de referência do SDK.
Defina variáveis de ambiente para usar o SDK de IA generativa com a Vertex AI:
# 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
C#
Para enviar uma solicitação de prompt, crie um arquivo C# (.cs
) e copie o
código a seguir no arquivo. Defina your-project-id
como o ID do projeto Google Cloud . Depois de atualizar os valores, execute o código.
REST
curl -X POST \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ https://aiplatform.googleapis.com/v1/projects/${PROJECT_ID}/locations/global/publishers/google/models/${MODEL_ID}:generateContent -d \ $'{ "contents": { "role": "user", "parts": [ { "fileData": { "mimeType": "video/mp4", "fileUri": "gs://cloud-samples-data/generative-ai/video/pixel8.mp4" } }, { "text": "Provide a description of the video. The description should also contain anything important which people say in the video." } ] } }'
O modelo retorna uma resposta. A resposta é gerada em seções, e cada uma delas é avaliada separadamente quanto à segurança.