Limites de requisição
Token bucket compartilhado, cabeçalhos e tratamento de 429.
O limiar de proteção padrão da API pública é 1.000 solicitações a cada 10 segundos por conta (cerca de 100 RPS sustentados). Esse limite protege contra abuso e clientes que enviam requisições sem controle; ele não representa a concorrência disponível. Criar mais chaves não o aumenta.
X-RateLimit-Limit: 20
X-RateLimit-Remaining: 7
Retry-After: 2Token bucket compartilhado
Todos os endpoints /api/v1 consomem o mesmo bucket open_api: capacidade 1.000 e reposição de cerca de 100 tokens por segundo. upload-url tem ainda um limite de proteção independente de 1.000 solicitações a cada 10 segundos. usage tem um limite independente bem mais rígido, de 30 solicitações por minuto, e não libera nada quando a decisão de limite fica indisponível: responde 429.
Cabeçalhos de resposta
Monitore X-RateLimit-Limit e X-RateLimit-Remaining. Em HTTP 429, aguarde os segundos de Retry-After. Solicitações acima do limite são recusadas imediatamente, não entram em fila.
Não é limite de concorrência
O limite controla a frequência de chamadas, não quantas tarefas estão em execução. Saldo, tetos de gasto e disponibilidade do serviço aparecem separadamente como 40201, 40202 e 50301. Webhooks evitam que o polling esgote o bucket.
Consulte o contrato OpenAPI 3.1 para ver a definição completa dos campos.