Gerar uma chave de API Gemini

Para usar a API Gemini, você precisa de uma chave de API. Você pode 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 de terminal comum 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 de 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 proteger a chave da API Gemini.

    • NÃO registre as chaves da API Gemini no controle da origem.
    • Os aplicativos do lado do cliente (Android, Swift, Web e Dart/Flutter) correm o risco de expor as 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.