Chaves de API
Crie, restrinja o escopo e rotacione as chaves com que seu código se autentica. Uma chave é a única credencial de que o gateway precisa: a mesma chave para todos os modelos e todos os endpoints.
Na barra lateral do console (aparece quando o recurso se aplica à sua conta): API keys Abrir ↗
Passos
- Abra API keys e pressione Create key.
- Dê um nome que você reconheça em seis meses: o nome é como você diferencia as chaves ao rotacionar.
- Defina os limites que ela deve carregar: uma cota de gasto com intervalo de reinício, uma lista de modelos permitidos, uma allowlist de IPs e uma data de expiração. Todos são opcionais: uma chave sem nenhum deles pode chamar qualquer modelo a que seu workspace tenha acesso.
- Copie a chave imediatamente e guarde-a no seu gerenciador de segredos. Depois envie-a como
Authorization: Bearer <key>.
Limites e ressalvas
- Uma chave é exibida exatamente uma vez. Não há como revelá-la de novo: se for perdida, exclua-a e crie outra.
- A exclusão de uma chave entra em vigor imediatamente. Rotacione criando a nova chave, implantando-a e só então excluindo a antiga, nessa ordem.
- As chaves pertencem a um workspace. Trocar de workspace troca quais chaves você vê, e uma chave nunca vale em outro.
- Uma allowlist de IPs é uma lista fixa que você define na chave. Para aprovar endereços novos à medida que aparecem, ative IPs confiáveis no workspace; uma chave com allowlist continua usando só a própria lista.
Referência da API para o mesmo recurso: Chaves de API