Quando você gera ativos 3D por meio da API da Meshy, cada resultado de tarefa é armazenado temporariamente nos servidores da Meshy. Entender a janela de retenção ajuda você a planejar sua integração e garante que você baixe os resultados antes que eles expirem.
Retenção de Ativos por Tipo de Tarefa
Os períodos de retenção variam conforme o tipo de tarefa:
Tipo de Tarefa | Período de Retenção |
Texto para 3D | 3 dias após a conclusão da tarefa |
Imagem para 3D | 3 dias após a conclusão da tarefa |
Rigging | 2 meses após a conclusão da tarefa |
Texto para 3D e Imagem para 3D
As tarefas e seus resultados — arquivos de modelo, imagens de pré-visualização e texturas — são mantidos por 3 dias a partir do momento em que a tarefa é concluída. Após esse período, a tarefa e todos os URLs de download associados não estarão mais acessíveis.
Toda resposta de tarefa da API inclui um campo expires_at (timestamp Unix em milissegundos) que indica exatamente quando a tarefa será excluída:
{
"id": "01abc123-...",
"status": "SUCCEEDED",
"expires_at": 1777029052743,
"result": {
"model_urls": { ... }
}
}
Monitore esse valor em sua integração e acione os downloads antes que ele expire.
Tarefas de Rigging
As tarefas de rigging são mantidas por 2 meses após a conclusão. Essa janela estendida permite que você continue adicionando novas animações ao mesmo personagem rigado usando o ID original da tarefa de rig — sem precisar rigar a malha novamente.
Para animar um rig existente, referencie o ID da tarefa de rig em sua solicitação de animação a qualquer momento dentro da janela de retenção de 2 meses.
Recuperando Seus Ativos
Para acessar ativos gerados via API antes que eles expirem:
Baixe imediatamente. Assim que uma tarefa atingir o status
SUCCEEDED, baixe os arquivos de saída (GLB, FBX, OBJ, etc.) para o seu próprio armazenamento.Use o endpoint de listagem de tarefas. Recupere IDs de tarefas recentes e URLs de saída por meio dos endpoints da API de listagem de Texto para 3D ou Imagem para 3D.
FAQ
1.Por que meu modelo gerado via API não está aparecendo no meu workspace?
Este é o comportamento esperado. Ativos gerados via API não aparecem na interface do Workspace da Meshy. Isso é por design — a API e o Workspace possuem ciclos de vida de ativos separados, com regras de expiração diferentes.
2.Por que os URLs da minha tarefa retornam 404?
Se o timestamp expires_at da tarefa já tiver passado, o ativo foi excluído dos servidores da Meshy. Será necessário reenviar a tarefa de geração. Para evitar isso no futuro, configure downloads automáticos para o seu próprio armazenamento assim que as tarefas forem concluídas com sucesso.
3.Posso adicionar novas animações a um personagem após a expiração da tarefa de rig?
As tarefas de rigging ficam disponíveis por 2 meses, oferecendo uma janela generosa para continuar adicionando animações. Se a tarefa de rig tiver expirado (com mais de 2 meses), será necessário rigar a malha original novamente.
Observação: a Meshy não garante a compatibilidade de esqueleto entre execuções de rigging separadas.