Quando gera recursos 3D através da Meshy API, cada tarefa e os respetivos resultados são armazenados nos servidores da Meshy durante um período limitado. O tempo durante o qual são conservados depende do plano da sua conta — não do tipo de tarefa. Descarregue os seus resultados antes de expirarem.
Retenção de recursos 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 aplica-se a todos os tipos de tarefa da API, incluindo os respetivos resultados — ficheiros de modelo, imagens de pré-visualização e texturas. Após o fim do período, a tarefa e todos os seus URLs de descarregamento são eliminados e não podem ser recuperados.
Pode comparar os planos na 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) 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 transfira os resultados antes de este prazo terminar.
Obter os seus recursos
Transfira imediatamente. Assim que uma tarefa atingir o estado
SUCCEEDED, transfira os ficheiros de saída (GLB, FBX, OBJ, etc.) para o seu próprio armazenamento.Utilize o endpoint de listagem de tarefas. Obtenha os IDs das tarefas recentes e os URLs de saída com o endpoint de listagem de cada tipo de tarefa.
Perguntas frequentes
1. Porque não encontro os recursos que gerei?
Se não os transferiu a tempo, os recursos foram eliminados quando o respetivo período de retenção terminou. Os recursos eliminados não podem ser recuperados — terá de submeter a tarefa novamente.
2. Se invocar DELETE numa tarefa, as imagens e os modelos que carreguei também são eliminados?
Eliminar uma tarefa elimina-a permanentemente, incluindo os respetivos modelos e dados. Não é possível anular uma eliminação, por isso transfira primeiro tudo o que precisar.
3. Porque não aparece o meu modelo gerado pela API no meu espaço de trabalho?
É o comportamento esperado. Os recursos gerados pela API não aparecem no espaço de trabalho da Meshy — a API e o espaço de trabalho têm ciclos de vida de recursos separados.
4. Porque é que os URLs das minhas tarefas devolvem 404?
O tempo expires_at da tarefa já passou, pelo que o recurso foi eliminado. Submeta a tarefa novamente e configure transferências automáticas para o seu próprio armazenamento assim que as tarefas forem concluídas com sucesso.