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

É possível usar 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 proteger sua chave de API Gemini. Aqui estão alguns pontos a serem considerados em mente 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, poderão fazer chamadas usando a cota do seu projeto, o que poderia resultar em perda de cota ou cobranças adicionais de faturamento (se o faturamento for ativado). As chaves de API também protegem o acesso a modelos e arquivos ajustados.

  • Ao clicar em Gerar chave de API no Google AI Studio, você escolhe se quer provisionar uma chave de API Gemini em um projeto novo ou atual do Google Cloud. O Lista de chaves de API no Google AI Studio mostra todas as chaves de API que o AI Studio provisionou para uso com o API Gemini da AI, com 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 Gemini da IA do Google. É possível visualizar e gerenciar todos os as chaves de API do projeto na APIs e Serviços > Painel de credenciais no console do Google Cloud.

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

    • Se houver chaves de API no seu projeto do Google Cloud que não tenham API restrições ou quaisquer chaves de API que colocaram o Generative Language na lista de permissões essas chaves poderão ser usadas com a API Gemini da IA do Google. É melhor restringir cada chave de API apenas às APIs que você chama usando esse de dados.
    • Mesmo com restrições de chave de API, se um usuário malicioso conseguir chave de API, eles poderão usá-la para fazer chamadas usando a cota do projeto para todos as APIs na lista de permissões para essa chave de API.

  • Você é responsável por proteger sua chave de API Gemini.

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

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

Próximas etapas