Receber uma chave de API do Google Cloud

Para usar o Gemini na Vertex AI, faça a autenticação usando uma Google Cloud chave de API ou Application Default Credentials. Recomendamos usar uma chave de API para testes e Application Default Credentials para produção.

Nesta página, mostramos como gerar uma chave de Google Cloud API com base no seu tipo de novo ou existente Google Cloud usuário.

Selecione seu tipo de usuário:

Criar uma chave de API do modo expresso

A maneira mais rápida de gerar uma chave de API é usando uma conta do modo expresso no Google Cloud console. Essa experiência simplificada foi projetada para integração rápida, criando uma chave de API automaticamente, independente de você ser novo na Google Cloud ou um Google Cloud usuário atual:

  • Se você é novo na Google Cloud, será guiado por uma configuração rápida e sem custo financeiro que oferece um ambiente de teste sem custo financeiro de 90 dias.
  • Se você já é um Google Cloud usuário, pode vincular sua conta de faturamento atual para gerar uma chave de API imediatamente na experiência simplificada da Vertex AI no modo expresso.

Para saber mais sobre a Vertex AI no modo expresso, consulte a página de visão geral do modo expresso.

Gerar uma chave de API com o modo expresso:

Gerar uma chave de API com o modo expresso

Para visualizar e gerenciar suas chaves de API, abra APIs e serviços > Credenciais:

Ir para Credenciais

Fazer sua primeira solicitação de API

Depois de gerar uma chave de API, aprenda a usá-la para fazer sua primeira solicitação no início rápido da API.

Opcional: configurar a chave de API localmente

Para testes iniciais, você pode codificar uma chave de API, mas isso só deve ser temporário, já que não é seguro. O restante desta seção explica como configurar sua chave de API localmente como uma variável de ambiente com diferentes sistemas operacionais.

Clique para abrir as instruções

Linux/macOS

  1. Execute o comando a seguir para saber qual shell de linha de comando você está usando:

    echo $SHELL

    O resultado será assim:

    /bin/bash

  2. Adicione uma variável de exportação de shell para sua chave de API, fazendo uma das seguintes ações:

    • Se a saída da etapa anterior for /bin/bash:

      1. Abra .bashrc:

        touch ~/.bashrc
        open ~/.bashrc

      2. Adicione a seguinte linha a .bashrc:

        export GOOGLE_API_KEY=YOUR_API_KEY

      3. Salve o arquivo e execute o seguinte para aplicar as alterações:

        source ~/.bashrc

    • Se a saída da etapa anterior for /bin/zsh:

      1. Abra .zshrc:

        touch ~/.zshrc
        open ~/.zshrc

      2. Adicione a seguinte linha a .zshrc:

        export GOOGLE_API_KEY= YOUR_API_KEY

      3. Salve o arquivo e execute o seguinte para aplicar as alterações:

        source ~/.zshrc

Windows

  1. Pesquise "Variáveis de ambiente" nas configurações do sistema.
  2. Edite "Variáveis de usuário" (para o usuário atual) ou "Variáveis de sistema" (para todos os usuários, use com cuidado).
  3. Crie a variável e adicione export GOOGLE_API_KEY=YOUR_API_KEY
  4. Aplique as alterações