Quando gera ativos 3D através da API do Meshy, o resultado de cada tarefa é armazenado temporariamente nos servidores do Meshy. Compreender o período de retenção ajuda-o a planear a sua integração e garante que descarrega os resultados antes de expirarem.
Período de Retenção dos Ativos por Tipo de Tarefa
Os períodos de retenção variam consoante 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 os seus resultados — ficheiros de modelo, imagens de pré-visualização e texturas — são mantidos durante 3 dias a partir do momento em que a tarefa é concluída. Após este período, a tarefa e todos os URLs de download associados deixarão de estar acessíveis.
Cada resposta de tarefa da API inclui um campo expires_at (timestamp Unix em milissegundos) que indica exatamente quando a tarefa será eliminada:
{
"id": "01abc123-...",
"status": "SUCCEEDED",
"expires_at": 1777029052743,
"result": {
"model_urls": { ... }
}
}
Monitorize este valor na sua integração e acione os downloads antes de expirar.
Tarefas de Rigging
As tarefas de rigging são mantidas durante 2 meses após a conclusão. Este período prolongado permite-lhe continuar a adicionar novas animações ao mesmo personagem rigado usando o ID da tarefa de rig original — sem ter de rigar novamente a malha.
Para animar um rig existente, referencie o ID da tarefa de rig no seu pedido de animação em qualquer momento dentro do período de retenção de 2 meses.
Recuperar os Seus Ativos
Para aceder aos ativos gerados via API antes de expirarem:
Descarregue imediatamente. Assim que uma tarefa atingir o estado
SUCCEEDED, descarregue os ficheiros de resultado (GLB, FBX, OBJ, etc.) para o seu próprio armazenamento.Utilize o endpoint de listagem de tarefas. Obtenha os IDs de tarefas recentes e os URLs de resultado através dos endpoints da API de listagem de Texto para 3D ou Imagem para 3D.
FAQ
1.Por que motivo o meu modelo gerado via API não aparece no meu workspace?
Este é o comportamento esperado. Os ativos gerados via API não aparecem na interface do Workspace do Meshy. Isto é intencional — a API e o Workspace têm ciclos de vida de ativos separados, com regras de expiração diferentes.
2.Por que motivo os URLs da minha tarefa devolvem 404?
Se o timestamp expires_at da tarefa já tiver passado, o ativo foi eliminado dos servidores do Meshy. Terá de submeter novamente a tarefa de geração. Para evitar isto no futuro, configure downloads automáticos para o seu próprio armazenamento assim que as tarefas sejam 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 estão disponíveis durante 2 meses, dando-lhe um período generoso para continuar a adicionar animações. Se a tarefa de rig tiver expirado (com mais de 2 meses), terá de rigar novamente a malha original.
Nota: O Meshy não garante a compatibilidade de esqueletos entre execuções de rigging separadas.