Limites de taxa

Verifique quantas requisições e tarefas seu plano permite, e o que fazer quando você atinge um limite.

Limites por plano

Para manter a API rápida e disponível para todos, a Meshy limita cada conta de duas formas:

Requisições por segundo: quantas requisições de API você pode enviar a cada segundo.
Tarefas simultâneas: quantas das suas tarefas podem estar PENDING ou IN_PROGRESS ao mesmo tempo.

Os limites dependem do seu plano:

Plano	Requisições por segundo	Tarefas simultâneas	Prioridade
Pro	20	10	Padrão
Premium	20	30	Maior que o Pro
Ultra	20	100	A mais alta
Studio	20	60, ou 20 em alguns planos Studio anteriores	Maior que o Pro
Enterprise	100	100 por padrão, ou um limite personalizado	A mais alta

Prioridade não é um limite. Quando a fila está ocupada, a Meshy inicia primeiro as tarefas com prioridade mais alta.

O que conta para cada limite

Toda requisição de API conta para as requisições por segundo, incluindo requisições que obtêm, listam ou transmitem tarefas. Requisições feitas a partir do aplicativo web da Meshy não contam.

O limite de tarefas simultâneas conta tarefas, não requisições. Todo endpoint que cria uma tarefa verifica esse limite antes de criar uma. Por exemplo, Texto para 3D, Imagem para 3D, Multi-imagem para 3D, Retexturizar, Remesh, Rigging, Animação, Texto para imagem, os endpoints de impressão 3D e o Creative Lab verificam esse limite.

Requisições que não criam uma tarefa não contam para esse limite. Por exemplo, Balance, Usage e requisições que obtêm, listam ou transmitem tarefas não contam.

De quem são os limites que se aplicam

A tabela a seguir mostra de quem são os limites que suas chaves de API, o Playground e o aplicativo web contabilizam:

Onde você trabalha	Conta pessoal	Equipe
Chaves de API	Seus limites	Os limites da equipe, compartilhados por todas as chaves de API da equipe
Playground	Seus limites	Seus próprios limites como membro autenticado
Aplicativo web	Suas tarefas simultâneas	Suas próprias tarefas simultâneas. As tarefas que o proprietário da equipe inicia também contam para os limites da equipe.

Quando você atinge um limite

Quando você ultrapassa um limite, a API retorna 429 Too Many Requests. A mensagem informa qual limite você atingiu:

Muitas requisições por segundo: a mensagem é Rate limit exceeded. Aguarde o número de segundos indicado no cabeçalho Retry-After e tente novamente.
Muitas tarefas simultâneas: a mensagem começa com NoMorePendingTasks. Em um plano ilimitado sem créditos restantes, ela começa com NoMoreConcurrentTasks. Esse 429 não tem cabeçalho Retry-After. Aguarde uma de suas tarefas terminar e, então, crie a próxima.

Cabeçalhos de limite de taxa

As respostas da API incluem estes cabeçalhos para ajudar você a controlar o ritmo das suas requisições:

Cabeçalho	Descrição
`X-RateLimit-Limit`	Requisições permitidas por segundo no seu plano.
`X-RateLimit-Remaining`	Requisições restantes no segundo atual.
`X-RateLimit-Reset`	Segundos até seu orçamento ficar cheio novamente.
`Retry-After`	Segundos a aguardar antes da sua próxima requisição. Enviado com um `429` para excesso de requisições por segundo, e quando você obtém uma tarefa que ainda está `PENDING` ou `IN_PROGRESS`.

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