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 de tempo especificado.

---

Por Que Limites

Implementamos limites de taxa em nossa API para ajudar a criar a melhor experiência para todos. Aqui está o motivo de sua importância:

• Para manter nosso serviço seguro e estável! Pense nos limites de taxa como seguranças amigáveis - eles garantem que ninguém possa sobrecarregar nossa API com requisições demais 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 parcela justa. Assim como compartilhar brinquedos em um playground, queremos garantir que todos os nossos usuários tenham acesso igualitário à API. Ao limitar gentilmente quantas requisições cada usuário pode fazer, garantimos que ninguém precise esperar muito tempo por sua vez.

• Para manter o desempenho ágil e confiável. Ao gerenciar o fluxo geral de requisições, podemos manter tempos de resposta rápidos e um serviço estável para todos os nossos maravilhosos usuários. É como garantir que uma rodovia não fique muito congestionada - o tráfego flui melhor quando evitamos engarrafamentos!

---

Como os Limites Funcionam

Os 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 a 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 por conta. Isso significa que os limites são compartilhados entre todas as suas API keys.

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

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

Se você exceder esses limites, receberá uma resposta 429 Too Many Requests de nossa API. Existem 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 requisições demais por segundo. Você receberá uma resposta 429 Too Many Requests com uma mensagem Rate limit exceeded.
• Ocorrência de Fila: Isso acontece quando você tem tarefas de geração simultâneas demais em execução. Você receberá uma resposta 429 Too Many Requests com uma mensagem NoMorePendingTasks (ou, quando seus créditos se esgotarem, NoMoreConcurrentTasks). Este 429 não possui Retry-After: aguarde uma de suas tarefas terminar antes de criar outra.

---

Cabeçalhos de Limite de Taxa

As respostas da API trazem estes cabeçalhos para que você possa controlar o ritmo de suas requisições:

Quando Retry-After estiver presente, aguarde essa quantidade de segundos antes de enviar a próxima requisição.