Pular para o conteúdo principal

Por quanto tempo o Meshy mantém os ativos gerados pela API

Guia de retenção e download de ativos da API do Meshy

Sumário

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.


Artigos relacionados

Isso respondeu à sua pergunta?