Limites de taxa

Verifique quantos pedidos e tarefas o seu plano permite, e o que fazer quando 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:

Pedidos por segundo: quantos pedidos de API pode enviar por segundo.
Tarefas simultâneas: quantas das suas tarefas podem estar PENDING ou IN_PROGRESS ao mesmo tempo.

Os limites dependem do seu plano:

Plano	Pedidos por segundo	Tarefas simultâneas	Prioridade
Pro	20	10	Padrão
Premium	20	30	Superior ao Pro
Ultra	20	100	Mais alta
Studio	20	60, ou 20 em alguns planos Studio anteriores	Superior ao Pro
Enterprise	100	100 por defeito, ou um limite personalizado	Mais alta

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

O que conta para cada limite

Todos os pedidos de API contam para os pedidos por segundo, incluindo pedidos que obtêm, listam ou transmitem tarefas. Os pedidos feitos a partir da aplicação web da Meshy não contam.

O limite de tarefas simultâneas conta tarefas, não pedidos. Todos os endpoints que criam uma tarefa verificam este limite antes de a criar. 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-no.

Os pedidos que não criam uma tarefa não contam para este limite. Por exemplo, Balance, Utilização, e pedidos que obtêm, listam ou transmitem tarefas não contam.

A quem se aplicam os limites

A tabela seguinte mostra para quem contam os limites das suas chaves de API, do Playground e da aplicação web:

Onde trabalha	Conta pessoal	Equipa
Chaves de API	Os seus limites	Os limites da equipa, partilhados por todas as chaves de API da equipa
Playground	Os seus limites	Os seus próprios limites enquanto membro com sessão iniciada
Aplicação web	As suas tarefas simultâneas	As suas próprias tarefas simultâneas. As tarefas iniciadas pelo proprietário da equipa também contam para os limites da equipa.

Quando atinge um limite

Quando ultrapassa um limite, a API devolve 429 Too Many Requests. A mensagem indica qual o limite que atingiu:

Demasiados pedidos por segundo: a mensagem é Rate limit exceeded. Aguarde o número de segundos indicado no cabeçalho Retry-After e tente novamente.
Demasiadas tarefas simultâneas: a mensagem começa por NoMorePendingTasks. Num plano ilimitado sem créditos restantes, começa por NoMoreConcurrentTasks. Este 429 não tem cabeçalho Retry-After. Aguarde que uma das suas tarefas termine e, depois, crie a seguinte.

Cabeçalhos de limite de taxa

As respostas da API incluem estes cabeçalhos para o ajudar a ritmar os seus pedidos:

Cabeçalho	Descrição
`X-RateLimit-Limit`	Pedidos permitidos por segundo no seu plano.
`X-RateLimit-Remaining`	Pedidos restantes no segundo atual.
`X-RateLimit-Reset`	Segundos até o seu limite voltar a estar totalmente disponível.
`Retry-After`	Segundos a aguardar antes do seu próximo pedido. Enviado com um `429` por demasiados pedidos por segundo, e quando obtém uma tarefa que ainda está `PENDING` ou `IN_PROGRESS`.

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