Criar uma chave de API
Crie chaves no console com limite de gastos e expiração opcionais; a chave completa é exibida apenas uma vez.
Você precisa de uma chave de API antes de chamar a API. As chaves são criadas e gerenciadas na página "Chaves de API" do console; uma conta pode ter várias chaves para finalidades diferentes.
Como criar uma chave
- Faça login e abra o console, depois escolha Chaves de API na navegação lateral.
- Clique em "Criar chave" e preencha:
| Campo | Obrigatório | Descrição |
|---|---|---|
| Nome | Sim | Nomeie conforme a finalidade para facilitar a identificação, por exemplo production, test. |
| Limite de gastos (USD) | Opcional | Teto de gasto acumulado desta chave. Deixe vazio para ilimitado. |
| Data de expiração | Opcional | A chave deixa de funcionar automaticamente após essa data. Deixe vazio para não expirar. |
- Envie para criar. A janela mostra a chave completa exatamente uma vez — copie e guarde em local seguro imediatamente.
Como as chaves são exibidas
- A chave completa é exibida somente uma vez, no momento da criação. Depois de fechar a janela, não é possível visualizá-la novamente.
- A lista de chaves sempre mostra uma forma mascarada (prefixo e últimos 4 caracteres) para proteger contra olhares curiosos.
- Perdeu uma chave? Exclua-a e crie outra — a nova chave funciona imediatamente.
Recomendações de segurança
- Nunca coloque uma chave em código de front-end, repositório público ou mensagem de chat — qualquer pessoa com a chave pode gastar o seu saldo.
- Separe as chaves por ambiente (uma para produção, uma para testes) e defina um limite de gastos na chave de produção para manter o impacto sob controle.
- Se suspeitar de vazamento, exclua a chave e crie outra imediatamente. A exclusão tem efeito imediato — chamadas com a chave antiga recebem 401.
- Para conceder acesso temporário a alguém, crie uma chave separada com limite pequeno e exclua-a depois, em vez de compartilhar sua chave principal.