Limites de Taxa

Os limites de taxa protegem a Pixapi e os provedores de modelos upstream de picos repentinos de tráfego. Os limites podem variar por plano, família de modelos e endpoint.

Sinais comuns

A Pixapi pode retornar 429 rate_limited quando a chave ou conta atual excede sua taxa de requisição permitida.

{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests. Please retry later."
  }
}

Comportamento do cliente

• Enfileire trabalhos em rajada no seu backend.
• Use backoff exponencial com jitter.
• Evite repetir a geração de mídia sem verificar o estado da tarefa.
• Divida o tráfego de produção, staging e desenvolvimento entre chaves de API separadas.

Backoff com jitter

function backoff(attempt: number) {
  const base = Math.min(8000, 500 * 2 ** attempt);
  return base + Math.floor(Math.random() * 250);
}

Aumentar limites

Se você executa cargas de trabalho de alto volume, entre em contato com o suporte com o volume esperado de requisições, mix de modelos e janela de pico de tráfego.