Limites de Taxa

Os limites de taxa são restrições que a nossa API impõe ao número de vezes que um utilizador ou cliente pode aceder aos nossos serviços dentro de um período de tempo especificado.

Porquê os Limites

Implementámos limites de taxa na nossa API para ajudar a criar a melhor experiência para todos. Aqui está o porquê de serem importantes:

Para manter o nosso serviço seguro e são! Pense nos limites de taxa como seguranças simpáticos - garantem que ninguém consegue sobrecarregar a nossa API com demasiados pedidos ao mesmo tempo. Isto ajuda a proteger o nosso serviço de potenciais utilizações abusivas e mantém tudo a funcionar sem problemas.
Para garantir que todos recebem a sua parte justa. Tal como partilhar brinquedos num parque infantil, queremos garantir que todos os nossos utilizadores têm acesso igual à API. Ao limitar suavemente quantos pedidos cada utilizador pode fazer, garantimos que ninguém tem de esperar demasiado tempo pela sua vez.
Para manter o desempenho rápido e fiável. Ao gerir o fluxo geral de pedidos, conseguimos manter tempos de resposta rápidos e um serviço estável para todos os nossos maravilhosos utilizadores. É como garantir que uma autoestrada não fica demasiado congestionada - o trânsito flui melhor quando evitamos o congestionamento!

Como Funcionam os Limites

Os limites de taxa são medidos de 2 formas:

Pedidos por segundo: Este é o número de pedidos de rede que pode fazer por segundo.
tarefas na fila: Este é o número de tarefas de geração simultâneas que pode executar na fila em qualquer momento.

As tarefas na fila incluem os endpoints de Texto para 3D, Imagem para 3D, Texto para textura e Remesh. Outros endpoints como Upload e Balance não estão incluídos neste limite.

Os limites são aplicados numa base por conta. Isto significa que os limites são partilhados entre todas as suas API keys.

Além dos limites de taxa, a prioridade de processamento de tarefas também afetará a velocidade das suas tarefas.

Cada nível do utilizador tem limites de taxa e níveis de prioridade específicos concebidos para corresponder às suas necessidades. Aqui estão os limites atuais por nível:

Nível do Utilizador	Pedidos por Segundo	tarefas na fila	Nível de Prioridade
Pro	20	10	Padrão
Premium	20	30	Superior ao Pro
Ultra	20	100	O mais elevado
Studio	20	20	Superior ao Pro
Enterprise	100	Padrão de 100, pode ser personalizado	O mais elevado

Se exceder estes limites, receberá uma resposta 429 Too Many Requests da nossa API. Existem dois tipos de ocorrências que podem desencadear isto, cada uma com uma resposta diferente:

Ocorrência de Pedido: Isto acontece quando faz demasiados pedidos por segundo. Receberá uma resposta 429 Too Many Requests com uma mensagem Rate limit exceeded.
Ocorrência de Fila: Isto acontece quando tem demasiadas tarefas de geração simultâneas em execução. Receberá uma resposta 429 Too Many Requests com uma mensagem NoMorePendingTasks (ou, quando os seus créditos se esgotarem, NoMoreConcurrentTasks). Este 429 não tem Retry-After: aguarde que uma das suas tarefas termine antes de criar outra.

Cabeçalhos de Limite de Taxa

As respostas da API trazem estes cabeçalhos para que possa gerir o ritmo dos seus pedidos:

Cabeçalho	Descrição
`X-RateLimit-Limit`	Pedidos permitidos por segundo no seu nível.
`X-RateLimit-Remaining`	Pedidos restantes no segundo atual.
`X-RateLimit-Reset`	Segundos até o seu orçamento estar completo novamente.
`Retry-After`	Segundos a aguardar antes do seu próximo pedido. Enviado com uma Ocorrência de Pedido `429`, e quando obtém uma tarefa que ainda está `PENDING` ou `IN_PROGRESS`.

Quando Retry-After está presente, aguarde esse número de segundos antes de enviar o próximo pedido.