Gerar uma chave de API Gemini

Para usar a API Gemini, você precisa de uma chave de API. É possível criar uma chave com apenas alguns cliques no Google AI Studio.

Conseguir uma chave da API Gemini no Google AI Studio

Configurar a chave de API

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

Linux/macOS: Bash

O Bash é uma configuração comum de terminal para Linux e macOS. Para verificar se você tem um arquivo de configuração, execute o seguinte comando:

~/.bashrc

Se a resposta for "No such file or directory", você vai precisar criar esse arquivo e abri-lo executando os comandos a seguir ou usando zsh:

touch ~/.bashrc
open ~/.bashrc

Em seguida, defina a chave da API adicionando o seguinte comando de exportação:

export GEMINI_API_KEY=<YOUR_API_KEY_HERE>

Depois de salvar o arquivo, aplique as mudanças executando:

source ~/.bashrc

macOS: Zsh

O Zsh é uma configuração comum de terminal para Linux e macOS. Para verificar se você tem um arquivo de configuração, execute o seguinte comando:

~/.zshrc

Se a resposta for "No such file or directory", você vai precisar criar esse arquivo e abri-lo executando os comandos a seguir ou usando bash:

touch ~/.zshrc
open ~/.zshrc

Em seguida, defina a chave da API adicionando o seguinte comando de exportação:

export GEMINI_API_KEY=<YOUR_API_KEY_HERE>

Depois de salvar o arquivo, aplique as mudanças executando:

source ~/.zshrc

Windows

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

Enviar sua primeira solicitação da API Gemini

Use um comando curl para verificar a configuração:

  curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-1.5-flash:generateContent?key=${GEMINI_API_KEY}" \
    -H 'Content-Type: application/json' \
    -X POST \
    -d '{
      "contents": [{
        "parts":[{"text": "Write a story about a magic backpack."}]
        }]
       }'

Proteger a chave de API

É importante manter a chave da API Gemini segura. Confira alguns pontos importantes ao usar sua chave da API Gemini:

  • A API Gemini da IA do Google usa chaves de API para autorização. Se outras pessoas tiverem acesso à sua chave de API Gemini, elas poderão fazer chamadas usando a cota do seu projeto, o que pode resultar na perda da cota ou em cobranças adicionais para projetos faturados, além de acessar modelos e arquivos ajustados.

  • Adicionar restrições de chave de API pode ajudar a limitar a área utilizável em cada chave de API.

  • Você é responsável por manter a chave da API Gemini segura.

    • NÃO registre as chaves da API Gemini no controle da origem.
    • Os aplicativos do lado do cliente (Android, Swift, Web e Dart/Flutter) podem exportar chaves de API. Não recomendamos usar os SDKs de cliente da IA do Google em apps de produção para chamar a API Gemini da IA do Google diretamente dos seus apps para dispositivos móveis e da Web.

Para conferir algumas práticas recomendadas gerais, consulte este artigo de suporte.