Saltar para o conteúdo principal

Durante quanto tempo a Meshy mantém os recursos gerados pela API

Guia de retenção e transferência de recursos da API Meshy

Índice

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.


Artigos relacionados

Isto respondeu à sua pergunta?