Receber uma chave de API do Google Cloud

Para usar o Gemini na Vertex AI, faça a autenticação usando uma chave de APIGoogle Cloud ou credenciais padrão de aplicativo. Recomendamos usar uma chave de API para testes e credenciais padrão do aplicativo para produção. Nesta página, mostramos como conseguir uma chave de API Google Cloud , dependendo se você é um usuário Google Cloud novo ou atual.

Selecione se você tem uma Conta do Google com um projeto Google Cloud :

Criar uma chave de API do Google Cloud

Se você já tiver um projeto Google Cloud , siga estas instruções para receber uma chave de API Google Cloud padrão. Como alternativa, use credenciais padrão de aplicativo em vez de uma chave de API.

Antes de começar

Selecionar um projeto, ativar o faturamento e a API Vertex AI

  1. Sign in to your Google Account.

    If you don't already have one, sign up for a new account.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. Enable the Vertex AI API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

  5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  6. Verify that billing is enabled for your Google Cloud project.

  7. Enable the Vertex AI API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

    8.

Ativar a criação de chaves de API da conta de serviço

  1. Abra IAM e administrador > Políticas da organização.
  2. Na lista de políticas, filtre as chamadas iam.managed.disableServiceAccountApiKeyCreation.
  3. Clique em Ações > Editar política.
  4. Em Origem da política, selecione Substituir política principal e clique em Adicionar uma regra.
  5. Em Aplicação, selecione Desativada.
  6. Clique em Concluído.
  7. Clique em Definir política. Na caixa de diálogo exibida, clique em Definir política novamente.

Criar uma nova conta de serviço

  1. Abra IAM e administrador > Contas de serviço.
  2. Clique em Criar conta de serviço.
  3. Configure a conta de serviço da seguinte maneira:
    • Nome da conta de serviço: vertex-ai-runner
    • ID da conta de serviço: vertexairunner
  4. Clique em Criar e continuar.
  5. Em Permissões, clique em Selecionar um papel e escolha Usuário do Vertex AI Platform Express no menu.
  6. Clique em Continuar.
  7. Clique em Concluído.

crie uma chave de API

  1. Abra APIs e serviços > Credenciais.
  2. Clique em Criar credenciais > Chave de API.
  3. Configure a chave de API da seguinte maneira:
    • Nome: vertexaiapikey
    • Autenticar chamadas de API por uma conta de serviço: selecionada.
  4. Clique em Selecionar conta de serviço.
  5. Selecione a conta de serviço que você criou na etapa anterior e clique em Selecionar.
  6. Clique em Criar.

Fazer sua primeira solicitação de API

Depois de receber uma chave de API, saiba como usá-la para fazer sua primeira solicitação no guia de 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 mostra 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 ver 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 do 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 GEMINI_API_KEY=YOUR_API_KEY

      3. Salve o arquivo e execute o seguinte para aplicar as mudanças:

        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 GEMINI_API_KEY= YOUR_API_KEY

      3. Salve o arquivo e execute o seguinte para aplicar as mudanças:

        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 GEMINI_API_KEY=YOUR_API_KEY
  4. Aplique as alterações