Quando você gera ativos 3D pela API do Meshy, cada tarefa e seus resultados são armazenados nos servidores do Meshy por um tempo limitado. Quanto tempo eles são mantidos depende do seu plano de conta — não do tipo de tarefa. Baixe seus resultados antes que expirem.
Retenção de ativos por plano
Plano | Período de retenção |
Pro, Premium, Ultra | 3 dias |
Studio | 14 dias |
Enterprise | Mantidos permanentemente |
O período de retenção se aplica a todos os tipos de tarefa da API, incluindo seus resultados — arquivos de modelo, imagens de visualização e texturas. Após o término do período, a tarefa e todas as suas URLs de download são excluídas e não podem ser recuperadas.
Você pode comparar planos em nossa página de preços.
Verificar quando uma tarefa expira
Cada resposta de tarefa da API inclui um campo expires_at (timestamp Unix em milissegundos) mostrando exatamente quando a tarefa será excluída:
{
"id": "01abc123-...",
"status": "SUCCEEDED",
"expires_at": 1777029052743,
"result": {
"model_urls": { ... }
}
}Monitore este valor na sua integração e baixe os outputs antes que expire.
Recuperando seus ativos
Baixe imediatamente. Assim que uma tarefa atinge o status
SUCCEEDED, baixe os arquivos de output (GLB, FBX, OBJ, etc.) para seu próprio armazenamento.Use o endpoint de listar tarefas. Recupere IDs de tarefas recentes e URLs de output com o endpoint de listagem para cada tipo de tarefa.
FAQ
1. Por que não consigo encontrar os ativos que gerei?
Se você não os baixou a tempo, os ativos foram excluídos quando o período de retenção terminou. Ativos excluídos não podem ser recuperados — você precisará enviar a tarefa novamente.
2. Se eu chamar DELETE em uma tarefa, as imagens e modelos que enviei também são excluídos?
Excluir uma tarefa exclui permanentemente a tarefa, incluindo seus modelos e dados. Você não pode desfazer uma exclusão, então baixe primeiro tudo o que precisar.
3. Por que meu modelo gerado pela API não aparece no meu workspace?
Isso é esperado. Os ativos gerados pela API não aparecem no Meshy Workspace — a API e o Workspace têm ciclos de vida de ativos separados.
4. Por que minhas URLs de tarefa retornam 404?
O tempo expires_at da tarefa passou, então o ativo foi excluído. Envie a tarefa novamente e configure downloads automáticos para seu próprio armazenamento assim que as tarefas forem concluídas com sucesso.