Obter uma chave de API

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

Gerar uma chave de API

Verificar sua chave de API com um comando curl

Use um comando curl para verificar a configuração. É possível transmitir a chave de API no URL:

API_KEY="YOUR_API_KEY"
curl -H 'Content-Type: application/json' \
     -d '{"contents":[
            {"role": "user",
              "parts":[{"text": "Give me five subcategories of jazz?"}]}]}' \
     "https://generativelanguage.googleapis.com/v1/models/gemini-pro:generateContent?key=${API_KEY}"

Ou no cabeçalho x-goog-api-key:

API_KEY="YOUR_API_KEY"
curl -H 'Content-Type: application/json' \
     -H "x-goog-api-key: ${API_KEY}" \
     -d '{"contents":[
            {"role": "user",
              "parts":[{"text": "Give me five subcategories of jazz?"}]}]}' \
     "https://generativelanguage.googleapis.com/v1/models/gemini-pro:generateContent"

Proteja sua chave de API

É importante manter sua chave de API do Gemini segura. Veja alguns pontos a serem considerados ao usar a chave de API do Gemini:

  • A API Google AI Gemini usa chaves de API para autorização. Se outras pessoas tiverem acesso à sua chave de API do Gemini, elas poderão fazer chamadas usando a cota do seu projeto, o que pode resultar na perda de cota ou em outras cobranças de faturamento (se o faturamento estiver ativado). As chaves de API também protegem o acesso a modelos e arquivos ajustados.

  • Ao clicar em Receber chave de API no Google AI Studio, você escolhe se quer provisionar uma chave de API do Gemini em um projeto novo ou atual do Google Cloud. A lista de chaves de API no Google AI Studio mostra todas as chaves de API que o AI Studio provisionou para uso com a API Google AI Gemini, além de todos os projetos associados do Google Cloud.

    • No entanto, qualquer chave de API no projeto do Google Cloud pode ser usada para chamar a API Google AI Gemini. É possível ver e gerenciar todas as chaves de API do projeto no painel "APIs e serviços > Credenciais " no console do Google Cloud.

  • Adicionar restrições de chave de API pode ajudar a limitar a área de superfície utilizável por meio de cada chave de API. Por padrão, a chave da API Genmini gerada pelo Google AI Studio só pode ser usada com a API Generative Language do Google (chamada oficialmente de "API Generative Language" ou generativelanguage.googleapis.com).

    • Se houver alguma chave de API no projeto do Google Cloud que não tenha restrições de API ou que tenha a API Generative Language na lista de permissões, essas chaves poderão ser usadas com a API Google AI Gemini. Recomendamos restringir cada chave apenas às APIs que você chama usando essa chave.
    • Mesmo com restrições de chave de API, se uma pessoa mal-intencionada conseguir sua chave de API, ela poderá usá-la para fazer chamadas usando a cota do seu projeto para todas as APIs permitidas para essa chave.

  • Você é responsável por manter sua chave de API do Gemini protegida.

    • NÃO verifique as chaves de API do Gemini no controle de origem.
    • Aplicativos do lado do cliente (Android, Swift, Web e Dart/Flutter) correm o risco de expor chaves de API. Por isso, não recomendamos o uso de SDKs do cliente de IA do Google em aplicativos de produção para chamar a API Google AI Gemini diretamente dos apps da Web e para dispositivos móveis. Confira os guias de início rápido do SDK para conhecer as práticas recomendadas específicas para cada linguagem e proteger sua chave de API.

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

Próximas etapas