---
title: "O que é limite de gastos na API? Orçamentos, tetos e 429"
description: "Um limite de gastos define quanto uma conta ou projeto de API pode gastar em um período. Tetos, alertas, os erros que retornam e o modelo da BroadNet."
url: https://broadrouter.com/pt/glossary/spend-limit/
lang: pt-BR
updated: 2026-11-16
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/spend-limit/) (atualizado em 2026-11-16).

# Limite de gastos (spend limit)

Atualizado em 2026-11-16

Limite de gastos é um teto para quanto uma conta, um projeto ou uma chave de API pode gastar em um período, em geral um mês. Quando o uso chega nele, o provedor rejeita as próximas requisições, muitas vezes com erro HTTP 429 ou 400, até o período reiniciar ou o limite ser aumentado.

Também chamado de: limite de gastos, teto de gastos, orçamento de API, limite de uso, spend limit, spending limit, spend cap, budget cap, usage cap

Um [rate limit](https://broadrouter.com/pt/glossary/rate-limit/) controla a velocidade com que você gasta. Um limite de gastos controla quanto.

## Como funciona

Os provedores empilham vários tetos. Dois exemplos documentados:

| Provedor | Controle | O que acontece quando é atingido |
| --- | --- | --- |
| Anthropic | Teto de gastos do tier por mês-calendário (Start, Build, Scale; Custom não tem) | O uso fica pausado até 00:00 UTC do primeiro dia do mês seguinte; HTTP 429 `rate_limit_error` com `error.details.error_code` `enforced_spend_limit_reached`, sem `retry-after` |
| Anthropic | Um limite menor definido por você, na organização ou no workspace | HTTP 400 `invalid_request_error`, com mensagem que começa com “You have reached your specified API usage limits” |
| OpenAI | Limite de uso mensal por tier | Não descrito no guia |
| OpenAI | Alerta de gastos | Envia uma notificação; o tráfego continua |
| OpenAI | Limite rígido de gastos, na organização ou no projeto | As requisições afetadas retornam 429 |

Os tetos por tier da Anthropic são USD 500 (Start), USD 1.000 (Build) e USD 200.000 (Scale) por mês. O guia da OpenAI lista limites de uso mensais por tier, de USD 100 no Free a USD 200.000 no Grow, e diz que os tiers sobem à medida que o total de compras de crédito passa de certos patamares.

A parte traiçoeira é que um 429 de limite de gastos parece um 429 de rate limit. Na API da Anthropic, o código de erro separa os dois, e a resposta do teto de gastos não tem o header `retry-after`:

```python
err = resp.json().get("error", {})
if resp.status_code == 429 and err.get("details", {}).get("error_code") == "enforced_spend_limit_reached":
    stop_job_and_alert()      # retrying will not help
elif resp.status_code == 429:
    backoff_and_retry()
```

## Por que isso importa

-   **Alertas chegam tarde.** Um loop rápido pode gastar muito antes de um e-mail chegar. Um teto rígido o interrompe.
-   **Retries pioram tudo.** Um cliente que faz backoff e repete todo 429 vai martelar um teto de gastos à toa. Diferencie os dois casos.
-   **Tetos compartilhados.** Um teto no nível da conta, compartilhado por vários apps, deixa um job descontrolado bloquear os outros. Orçamentos por projeto, ou um orçamento controlado no seu código, mantêm tudo separado.

## Na BroadNet Inference

A referência da API da BroadNet lista seis limites em uma chave de pagamento por uso. Os três que limitam custo e throughput são 30 requisições por minuto, 4 em andamento e o gasto, definido como “the native budget shared by the account’s pay-as-you-go keys” (tradução: o orçamento nativo compartilhado pelas chaves de pagamento por uso da conta); os outros são os modelos permitidos, validade de um ano por chave e até dez chaves ativas por conta. A conta é [pré-paga](https://broadrouter.com/pt/glossary/prepaid-credit/), então o saldo é o teto externo. Dois códigos de status importam:

-   **429**: “A rate, concurrency, token-rate or spending limit was reached.” (tradução: foi atingido um limite de taxa, de concorrência, de tokens por tempo ou de gastos.)
-   **401**: chave ausente, inválida ou expirada, ou uma conta cujo orçamento compartilhado de pagamento por uso está bloqueado (a documentação usa a expressão “a blocked native PAYG budget holder”), “including exhausted PAYG allowance” (tradução: incluindo saldo PAYG esgotado).

A página de privacidade da BroadNet diz que as chaves têm escopo por modelo, taxa e gasto, mas a referência da API não mostra configuração de orçamento por chave ou por projeto, então coloque no seu código uma verificação de orçamento antes de cada requisição, como em [controle de gastos com APIs de LLM](https://broadrouter.com/pt/blog/llm-api-spend-control/). Para um pior caso fixo, um [plano de preço fixo](https://broadrouter.com/pt/plans/) ou uma chave por hora a $0.50 limitam o gasto por definição. O tratamento de retries está no [guia de erros e retries](https://broadrouter.com/pt/guides/errors-and-retries/).

## Perguntas frequentes

### Devo repetir uma requisição que bateu no limite de gastos?

Não. A Anthropic diz que o 429 do teto de gastos não traz header retry-after e que os retries falham até o acesso voltar. Avise uma pessoa ou pare o job.

### Alerta de gastos é a mesma coisa que limite de gastos?

Não. A OpenAI diferencia o alerta de gastos, que só notifica e deixa o tráfego seguir, do limite rígido de gastos, que faz as requisições retornarem 429.

### Posso definir um orçamento separado por chave da BroadNet?

A página de privacidade da BroadNet diz que chaves de API com escopo controlam o acesso por modelo, taxa e gasto, mas a referência da API documenta o gasto de uma chave de pagamento por uso como o orçamento nativo compartilhado pelas chaves da conta e não mostra configuração de orçamento por chave. Confira os detalhes da sua chave e aplique orçamentos por app no seu código.

## Veja também

-   [Crédito pré-pago (prepaid credit)](https://broadrouter.com/pt/glossary/prepaid-credit/) (termo)
-   [Rate limit (limite de taxa)](https://broadrouter.com/pt/glossary/rate-limit/) (termo)
-   [Pagamento por uso (pay-as-you-go)](https://broadrouter.com/pt/glossary/pay-as-you-go/) (termo)
-   [Chave de API (API key)](https://broadrouter.com/pt/glossary/api-key/) (termo)
-   [Backoff exponencial (exponential backoff)](https://broadrouter.com/pt/glossary/exponential-backoff/) (termo)
-   [Códigos de erro da BroadNet Inference e quando tentar de novo](https://broadrouter.com/pt/guides/errors-and-retries/) (guia)
-   [Controle de gastos com API de LLM: orçamentos, limites e loops](https://broadrouter.com/pt/blog/llm-api-spend-control/) (artigo)
-   [Erro 429 em API de LLM: backoff, jitter e limitadores](https://broadrouter.com/pt/blog/handle-llm-api-429-rate-limits/) (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-spend-limit&utm_content=page-cta) ·

**Fontes**

-   [Documentação da Claude API da Anthropic, rate limits: limites de gastos, tetos por tier, 429 enforced\_spend\_limit\_reached (conferido em 2026-11-15)](https://platform.claude.com/docs/en/api/rate-limits)
-   [Documentação da API da OpenAI, guia de rate limits: tiers de uso, alertas de gastos e limites rígidos de gastos (conferido em 2026-11-15)](https://developers.openai.com/api/docs/guides/rate-limits)
-   [Referência da API da BroadNet Inference: limites PAYG, orçamento nativo compartilhado, significado de 401 e 429 (conferido em 2026-11-15) (em inglês)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=pt-glossary-spend-limit&utm_content=sources)
