Когда вы создаёте 3D-ассеты через Meshy API, каждая задача и её результаты хранятся на серверах Meshy ограниченное время. Срок хранения зависит от тарифа вашей учётной записи, а не от типа задачи. Скачайте результаты до истечения срока.
Сроки хранения ассетов по тарифам
Тариф | Срок хранения |
Pro, Premium, Ultra | 3 дня |
Studio | 14 дней |
Enterprise | Хранятся бессрочно |
Срок хранения применяется ко всем типам задач API, включая их результаты — файлы моделей, изображения предпросмотра и текстуры. По окончании срока задача и все её URL-адреса для скачивания удаляются без возможности восстановления.
Сравнить тарифы можно на нашей странице цен.
Как узнать, когда истекает срок задачи
Каждый ответ задачи API содержит поле expires_at (временная метка Unix в миллисекундах), которое показывает, когда именно задача будет удалена:
{
"id": "01abc123-...",
"status": "SUCCEEDED",
"expires_at": 1777029052743,
"result": {
"model_urls": { ... }
}
}Отслеживайте это значение в вашей интеграции и скачайте результаты до наступления этого срока.
Получение ваших ассетов
Скачивайте сразу. Как только задача достигает статуса
SUCCEEDED, скачайте выходные файлы (GLB, FBX, OBJ и т. д.) в собственное хранилище.Используйте endpoint списка задач. Получайте идентификаторы недавних задач и URL результатов с помощью endpoint списка для каждого типа задач.
Частые вопросы
1. Почему я не могу найти созданные мной ассеты?
Если вы не скачали их вовремя, ассеты были удалены по окончании срока хранения. Удалённые ассеты восстановить нельзя — потребуется заново отправить задачу.
2. Если я вызываю DELETE для задачи, удаляются ли загруженные мной изображения и модели?
Удаление задачи безвозвратно удаляет задачу, включая её модели и данные. Отменить удаление нельзя, поэтому сначала скачайте всё необходимое.
3. Почему модель, созданная через API, не отображается в моём рабочем пространстве?
Это ожидаемо. Ассеты, созданные через API, не отображаются в Meshy Workspace — у API и рабочего пространства разные жизненные циклы ассетов.
4. Почему URL моих задач возвращают 404?
Срок expires_at задачи истёк, поэтому ассет был удалён. Отправьте задачу снова и настройте автоматическое скачивание в собственное хранилище сразу после успешного выполнения задач.