---
title: "O que é uma chave de API de LLM? Como usar e proteger"
description: "Uma chave de API identifica e autoriza chamadas a uma API de LLM, e quem a tiver pode gastar o seu saldo. Como chaves bearer funcionam e como guardar e revogar."
url: https://broadrouter.com/pt/glossary/api-key/
lang: pt-BR
updated: 2026-11-14
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Traduzido do inglês com ajuda de IA. [Leia o original em inglês](https://broadrouter.com/glossary/api-key/) (atualizado em 2026-11-14).

# Chave de API (API key)

Atualizado em 2026-11-14

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:

```bash
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](https://broadrouter.com/pt/glossary/ip-allow-list/), 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](https://broadrouter.com/pt/glossary/flat-rate-llm-plan/) 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](https://broadrouter.com/pt/guides/api-keys-ip-allow-lists/), e os códigos de status em [erros e novas tentativas](https://broadrouter.com/pt/guides/errors-and-retries/).

## 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.

## Veja também

-   [Lista de IPs permitidos (IP allow list)](https://broadrouter.com/pt/glossary/ip-allow-list/) (termo)
-   [Base URL (URL base)](https://broadrouter.com/pt/glossary/base-url/) (termo)
-   [API compatível com a OpenAI](https://broadrouter.com/pt/glossary/openai-compatible-api/) (termo)
-   [Rate limit (limite de taxa)](https://broadrouter.com/pt/glossary/rate-limit/) (termo)
-   [Restrinja chaves de API aos seus servidores com lista de IPs](https://broadrouter.com/pt/guides/api-keys-ip-allow-lists/) (guia)
-   [Como usar o SDK Python da OpenAI com a BroadNet Inference](https://broadrouter.com/pt/guides/openai-python-sdk/) (guia)
-   [Códigos de erro da BroadNet Inference e quando tentar de novo](https://broadrouter.com/pt/guides/errors-and-retries/) (guia)
-   [API de LLM com retenção zero de dados: checklist de 10 perguntas](https://broadrouter.com/pt/blog/zero-data-retention-llm-api-checklist/) (artigo)

Teste com a sua carga de trabalho real. Contas novas começam com US$ 5 de crédito para Gemma e transcrição. DeepSeek, GLM e Qwen3.8 exigem uma recarga.

[Começar](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=pt-glossary-api-key&utm_content=page-cta) ·

**Fontes**

-   [RFC 6750: The OAuth 2.0 Authorization Framework, Bearer Token Usage](https://www.rfc-editor.org/rfc/rfc6750)
-   [OWASP Secrets Management Cheat Sheet](https://cheatsheetseries.owasp.org/cheatsheets/Secrets_Management_Cheat_Sheet.html)
-   [Referência da API da BroadNet Inference, chaves e listas de IPs permitidos (em inglês)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=pt-glossary-api-key&utm_content=sources)
