Limites de taxa

Limites de taxa são restrições que nossa API impõe ao número de vezes que um usuário ou cliente pode acessar nossos serviços dentro de um período especificado.

Por que existem limites

Implementamos limites de taxa em nossa API para ajudar a criar a melhor experiência para todos. Veja por que eles são importantes:

  • Para manter nosso serviço seguro e em ordem! Pense nos limites de taxa como seguranças amigáveis — eles garantem que ninguém sobrecarregue nossa API com muitas requisições de uma só vez. Isso ajuda a proteger nosso serviço contra possíveis usos indevidos e mantém tudo funcionando sem problemas.

  • Para garantir que todos recebam sua parte justa. Assim como ao compartilhar brinquedos em um parquinho, queremos garantir que todos os nossos usuários tenham acesso igual à API. Ao limitar cuidadosamente quantas requisições cada usuário pode fazer, garantimos que ninguém precise esperar muito pela sua vez.

  • Para manter o desempenho rápido e confiável. Ao gerenciar o fluxo geral de requisições, conseguimos manter tempos de resposta rápidos e um serviço estável para todos os nossos usuários incríveis. É como garantir que uma rodovia não fique cheia demais — o tráfego flui melhor quando evitamos congestionamentos!

Como os limites funcionam

Limites de taxa são medidos de 2 formas:

  • requisições por segundo: Este é o número de requisições de rede que você pode fazer por segundo.
  • tarefas na fila: Este é o número de tarefas de geração simultâneas que você pode executar na fila em 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 saldo não estão incluídos nesse limite.

Os limites são aplicados por conta. Isso significa que os limites são compartilhados entre todas as suas chaves de API.

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

Cada nível do usuário tem limites de taxa e níveis de prioridade específicos, projetados para atender às suas necessidades. Veja os limites atuais por nível:

Nível do usuáriorequisições por segundotarefas na filaNível de prioridade
Pro2010Padrão
Studio2020Mais alta que Pro
Enterprise100Padrão de 50, pode ser personalizadoMais alta

Se você exceder esses limites, receberá uma resposta 429 Too Many Requests da nossa API. Há dois tipos de ocorrências que podem acionar isso, cada uma com uma resposta diferente:

  • Ocorrência de requisição: Isso acontece quando você faz muitas requisições por segundo. Você receberá uma resposta 429 Too Many Requests com uma mensagem RateLimitExceeded.
  • Ocorrência de fila: Isso acontece quando você tem muitas tarefas de geração simultâneas em execução. Você receberá uma resposta 429 Too Many Requests com uma mensagem NoMoreConcurrentTasks.