# Por Quanto Tempo a Meshy Mantém Ativos Gerados via API

> URL: https://help.meshy.ai/pt-BR/articles/15643844-how-long-does-meshy-keep-api-generated-assets
> Language: pt-BR
> Last updated: 2026-09-09T10:02:09Z

Quando você gera ativos 3D por meio da API da Meshy, cada resultado de tarefa é armazenado temporariamente nos servidores da Meshy. Entender a janela de retenção ajuda você a planejar sua integração e garante que você baixe os resultados antes que eles expirem.

## Retenção de Ativos por Tipo de Tarefa

Os períodos de retenção variam conforme 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 seus resultados — arquivos de modelo, imagens de pré-visualização e texturas — são mantidos por **3 dias** a partir do momento em que a tarefa é concluída. Após esse período, a tarefa e todos os URLs de download associados não estarão mais acessíveis.

Toda resposta de tarefa da API inclui um campo `expires_at` (timestamp Unix em milissegundos) que indica exatamente quando a tarefa será excluída:

```
{
  "id": "01abc123-...",
  "status": "SUCCEEDED",
  "expires_at": 1777029052743,
  "result": {
    "model_urls": { ... }
  }
}
```

Monitore esse valor em sua integração e acione os downloads antes que ele expire.

### Tarefas de Rigging

As tarefas de rigging são mantidas por **2 meses** após a conclusão. Essa janela estendida permite que você continue adicionando novas animações ao mesmo personagem rigado usando o ID original da tarefa de rig — sem precisar rigar a malha novamente.

Para animar um rig existente, referencie o ID da tarefa de rig em sua solicitação de animação a qualquer momento dentro da janela de retenção de 2 meses.

## Recuperando Seus Ativos

Para acessar ativos gerados via API antes que eles expirem:

- **Baixe imediatamente.** Assim que uma tarefa atingir o status `SUCCEEDED`, baixe os arquivos de saída (GLB, FBX, OBJ, etc.) para o seu próprio armazenamento.

- **Use o endpoint de listagem de tarefas.** Recupere IDs de tarefas recentes e URLs de saída por meio dos endpoints da API de listagem de Texto para 3D ou Imagem para 3D.

## FAQ

**1.Por que meu modelo gerado via API não está aparecendo no meu workspace?**

Este é o comportamento esperado. Ativos gerados via API *não* aparecem na interface do Workspace da Meshy. Isso é por design — a API e o Workspace possuem ciclos de vida de ativos separados, com regras de expiração diferentes.

**2.Por que os URLs da minha tarefa retornam 404?**

Se o timestamp `expires_at` da tarefa já tiver passado, o ativo foi excluído dos servidores da Meshy. Será necessário reenviar a tarefa de geração. Para evitar isso no futuro, configure downloads automáticos para o seu próprio armazenamento assim que as tarefas forem 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 ficam disponíveis por 2 meses, oferecendo uma janela generosa para continuar adicionando animações. Se a tarefa de rig tiver expirado (com mais de 2 meses), será necessário rigar a malha original novamente.

Observação: a Meshy não garante a compatibilidade de esqueleto entre execuções de rigging separadas.