BroadRouter
Começar

Chave de API (API key)

Atualizado em

Uma chave de API é uma string secreta que identifica e autoriza um cliente que chama uma API. As APIs de LLM normalmente a esperam em um cabeçalho Authorization: Bearer, e qualquer pessoa que tenha a chave pode fazer requisições cobradas da conta dona dela.

Também chamado de: chave de API, API key, chave secreta, token de API, chave de inferência, API token, secret key, bearer token, inference key

Uma chave de API funciona como uma senha para um programa. Ela também é uma autorização de gasto: quem a tem pode usar o seu saldo.

Como funciona

As APIs de LLM tratam a chave como um bearer token. O cliente a envia em toda requisição:

curl https://inference.broadnet.ai/v1/models \
  -H "Authorization: Bearer $BROADNET_API_KEY"

A RFC 6750 define um bearer token como aquele que “any party in possession of the token” (tradução: qualquer parte que esteja de posse do token) pode usar. Não existe um segundo fator. Por isso a mesma RFC diz que os clientes devem sempre enviar bearer tokens por TLS (https://).

O provedor procura a chave, encontra a conta, verifica limites e políticas e então atende ou recusa a requisição. Uma chave ausente ou errada costuma retornar 401; uma chave recusada por uma política, como uma lista de IPs permitidos, costuma retornar 403.

Por que importa

Uma chave vazada é uma das formas mais comuns de uma conta de API disparar, porque bots varrem código público em busca de segredos. Ela também pode expor dados se alcançar endpoints que retornam detalhes da conta. Boas práticas, alinhadas às orientações da OWASP sobre segredos:

  • Carregue as chaves de variáveis de ambiente ou de um gerenciador de segredos. Nunca faça commit delas nem as embuta em imagens de contêiner.
  • Dê a cada app ou agente a sua própria chave, para poder revogar uma sem parar tudo.
  • Faça rotação das chaves periodicamente e logo depois de qualquer suspeita de vazamento.
  • Limite onde a chave funciona, por exemplo com uma lista de IPs de servidores permitidos.

Na BroadNet Inference

A BroadNet separa duas credenciais. Uma chave de inferência chama os modelos em /v1/*. Uma credencial do portal automatiza a conta: chaves, IPs permitidos e compras. Trate a segunda como autoridade total sobre a conta.

As duas aparecem uma única vez. A BroadNet guarda apenas um hash SHA-256, então não consegue mostrar a chave de novo. Uma chave de pagamento por uso vale por um ano, e uma conta pode ter até dez chaves ativas. Cada chave pode ter a sua própria lista de IPs permitidos. Depois de uma revogação ou de uma mudança na lista de IPs permitidos, as novas requisições param em até cinco segundos.

As chaves dos planos de preço fixo são separadas e nunca descontam do seu saldo. Os passos de configuração estão em chaves de API e listas de IPs permitidos, e os códigos de status em erros e novas tentativas.

Erros comuns

  • Registrar em log os cabeçalhos completos das requisições. Isso grava a chave nos seus logs.
  • Compartilhar uma única chave com o time todo. Você perde a possibilidade de revogar o acesso de uma pessoa só.
  • Enviar a chave para o suporte. Envie o valor do cabeçalho X-Request-ID.

Perguntas frequentes

Posso colocar uma chave de API de LLM em um app web ou de celular?

Não. Tudo o que vai para o cliente pode ser extraído. Mantenha a chave em um servidor e faça o seu app chamar o seu servidor, que então chama a API de LLM.

O que fazer se uma chave vazar?

Revogue-a na hora, crie uma nova e confira o uso no período em que ela ficou exposta. Depois descubra como ela vazou, por exemplo um commit, uma linha de log ou um print de tela.

Quantas chaves posso ter na BroadNet Inference?

Até dez chaves de pagamento por uso ativas por conta. Cada uma vale por um ano a partir da criação. As chaves de plano são separadas.

Ler em MarkdownPerguntar ao ChatGPTPerguntar ao ClaudePerguntar ao Perplexity