Resposta direta
Um 429 indica que a requisição foi limitada por frequência ou concorrência. Registre status, headers e horário, procure o header Retry-After na resposta e reduza a cadência no cliente antes de tentar de novo.
O que verificar primeiro
- Registre o horário exato em UTC e a concorrência do seu cliente no momento do erro: o padrão de repetição importa mais que um evento isolado.
- Procure o header
Retry-Afterna resposta; quando presente, ele indica o tempo sugerido antes da próxima tentativa. - Reduza a cadência no cliente — espaçamento entre chamadas e paralelismo — antes de repetir a chamada.
Exemplo copiável
date -u +%FT%TZ
curl -sS -D h -o b -w 'HTTP %{http_code}\n' https://api.mandapi.com/v1/chat/completions \
-H "Authorization: Bearer ${MANDAPI_API_KEY}" \
-H 'Content-Type: application/json' \
-d '{"model":"deepseek-v4-flash","messages":[{"role":"user","content":"ok"}]}'
O comando imprime o horário em UTC, salva os headers completos em h (procure Retry-After neles) e o corpo em b.
Como diferenciar de outros erros
- 429 não é falha de autenticação: com header ausente ou inválido, o caso registrado é HTTP 401, que exige correção de credencial, não de cadência.
- Compare com uma chamada de controle: uma chamada isolada em
GET /v1/modelsque responde normalmente ajuda a separar limite por frequência de indisponibilidade. - Não confunda com timeout: timeout é ausência de resposta no prazo configurado do cliente; 429 é uma resposta recebida.
Como registrar o teste
Anote data, ambiente, método, URL final, status e corpo sanitizado — sem a API key. Registre também o intervalo entre tentativas e o resultado de cada uma; essa sequência é o que permite distinguir limite transitório de limite persistente.