Limites de Taxa

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

Porquê Limites

Implementámos limites de taxa na nossa API para ajudar a criar a melhor experiência para todos. Eis porque são importantes:

  • Para manter o nosso serviço seguro e protegido! Pense nos limites de taxa como seguranças amigáveis - eles garantem que ninguém pode sobrecarregar a nossa API com demasiados pedidos de uma só vez. Isto ajuda a proteger o nosso serviço de potenciais abusos e mantém tudo a funcionar sem problemas.

  • Para garantir que todos têm 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 o número de pedidos que cada utilizador pode fazer, asseguramos 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, podemos 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áfego flui melhor quando evitamos congestionamentos!

Como Funcionam os Limites

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

  • 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 a qualquer momento.

As tarefas na fila incluem os endpoints 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 por todas as suas API keys.

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

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

Nível do UtilizadorPedidos por SegundoTarefas na FilaNível de Prioridade
Pro2010Padrão
Premium2030Superior ao Pro
Ultra20100Mais alto
Studio2020Superior ao Pro
Enterprise100Padrão para 50, pode ser personalizadoMais alto

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 RateLimitExceeded.
  • 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 NoMoreConcurrentTasks.