Saltar para o conteúdo principal

Como Corrigir Erros 429 e Limites de Taxa da Meshy API

Limites de Taxa da Meshy API: Corrigir Erros 429

Índice

Se a sua integração estiver a receber erros 429, RateLimitExceeded ou NoMoreConcurrentTasks ao chamar a Meshy API, este guia explica por que existem estes limites e como conceber a sua integração para funcionar dentro deles.

Por que existem limites de taxa

A Meshy API está à frente de recursos de GPU partilhados utilizados para gerar modelos 3D, texturas e recursos relacionados. Os limites de taxa e os limites de concorrência protegem essa infraestrutura partilhada para que a qualidade da geração e o tempo de resposta se mantenham consistentes para todos os utilizadores da plataforma. Cada conta, com base no seu plano atual, tem um número máximo de pedidos que pode efetuar num determinado intervalo de tempo e um número máximo de tarefas de geração que pode ter em execução (em fila ou em curso) em simultâneo.

Limite de pedidos vs. limite de fila/concorrência

Existem dois limites distintos, e as falhas que provocam são diferentes:

  • Limite de taxa de pedidos (429 / RateLimitExceeded): define quantas chamadas à API (por exemplo, criação de tarefas, consulta de estado) pode fazer por minuto. Ultrapassá-lo significa que está a chamar a API com demasiada frequência, independentemente de quantas tarefas estão realmente a ser executadas.

  • Limite de concorrência / fila (NoMoreConcurrentTasks): define quantas tarefas de geração pode ter em fila ou em processamento ao mesmo tempo. Ultrapassá-lo significa que já atingiu o número máximo de tarefas ativas e tem de aguardar que uma termine antes de submeter outra.

Consulte os limites atuais de pedidos e de concorrência do seu plano no painel da Meshy, uma vez que podem variar consoante o nível do plano.

Estratégia de recuo para erros 429

Quando receber uma resposta 429 ou RateLimitExceeded, não repita imediatamente o mesmo pedido. Em vez disso:

  • Utilize o recuo exponencial: aguarde um curto intervalo e, depois, duplique-o em cada falha subsequente, até um máximo razoável.

  • Adicione jitter (um pequeno desvio aleatório) ao intervalo de recuo, para que os vários workers do seu sistema não repitam todos no mesmo instante.

  • Respeite quaisquer cabeçalhos Retry-After ou de limite de taxa devolvidos na resposta, se existirem, em vez de estimar um tempo de espera.

  • Limite o número de repetições por pedido para que uma falha persistente não entre num ciclo indefinido.

Planear em torno dos limites de concorrência

Um erro NoMoreConcurrentTasks significa que já atingiu o limite de tarefas ativas da sua conta. Para evitar atingi-lo em produção:

  • Mantenha uma fila local ou um agendador de tarefas na sua própria aplicação que só submeta uma nova tarefa de geração quando a anterior estiver concluída ou a sua contagem de tarefas ativas descer abaixo do limite.

  • Consulte o estado da tarefa (ou utilize webhooks, se forem suportados no seu fluxo de trabalho) para saber quando é libertada uma vaga, em vez de submeter especulativamente.

  • Agrupe e limite os trabalhos de geração em massa em vez de disparar todos os pedidos de uma só vez — isto suaviza tanto a sua taxa de pedidos como a contagem de tarefas concorrentes.

  • Implemente monitorização/alertas do seu lado para que um pico de erros 429/NoMoreConcurrentTasks seja visível antes de afetar os seus utilizadores.

Repetir gerações falhadas ou insatisfatórias

A Meshy API não suporta atualmente um "retry" incorporado de uma geração existente para os planos individual ou studio — se um resultado não corresponder às suas expectativas, submete um novo pedido de geração, o que consome créditos normalmente. Quando o seu pipeline automatizado lida com erros transitórios (como um 429), certifique-se de que a sua lógica de repetição apenas reenvia o pedido original após um período de recuo, e não cria tarefas de geração duplicadas de cada vez.

Quando considerar atualizar o seu plano

Se implementou o recuo e o enfileiramento que tem em conta a concorrência e continua a atingir sistematicamente os limites de taxa ou de concorrência, isso é normalmente um sinal de que as necessidades de débito da sua integração ultrapassaram os limites do seu plano atual. Consulte o seu dashboard para ver os limites de pedidos e de concorrência do plano atual e considere atualizar o plano ou contactar a equipa de vendas da Meshy para obter acesso à API de nível empresarial, caso necessite de um débito mais elevado de forma sustentada.

FAQ

1. O que significa um erro 429 ou RateLimitExceeded?

Significa que excedeu o número de pedidos à API permitidos num determinado intervalo de tempo para o seu plano. Reduza a taxa de pedidos e utilize recuo exponencial antes de tentar novamente.

2. O que significa NoMoreConcurrentTasks?

Significa que já atingiu o número máximo de tarefas de geração em fila ou em curso para a sua conta. Aguarde que uma tarefa existente termine, ou reduza o número de tarefas que submete de uma só vez, antes de submeter mais.

3. Como sei os limites de taxa e concorrência da minha conta?

Consulte o seu dashboard da Meshy para ver os limites associados ao seu plano atual, uma vez que estes podem variar entre níveis de plano.

4. A Meshy suporta repetições automáticas para tarefas de geração?

Não, nem para planos individuais nem para planos studio — uma geração falhada ou insatisfatória tem de ser submetida novamente como um novo pedido, o que consome créditos normalmente. Os clientes Enterprise devem contactar a equipa de vendas sobre a funcionalidade de repetição.

5. Qual é a melhor forma de evitar estes erros num pipeline de produção?

Implemente uma fila local que limite as submissões para se manter abaixo do seu limite de concorrência, adicione recuo exponencial com jitter para quaisquer respostas 429 e monitorize as taxas de erro para poder reagir antes de afetarem os seus utilizadores.

6. Quando devo atualizar o meu plano devido a limites de taxa?

Se já implementou recuo e uma fila que tem em conta a concorrência e continua a atingir regularmente estes limites, a sua utilização provavelmente já ultrapassou o seu plano atual — consulte o seu dashboard ou contacte a equipa de vendas sobre um plano com maior débito.


Artigos relacionados

Isto respondeu à sua pergunta?