Коли ви створюєте 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 — API і робочий простір мають окремі життєві цикли активів.
4. Чому мої URL-адреси завдань повертають 404?
Час expires_at завдання минув, тому актив видалено. Надішліть завдання повторно та налаштуйте автоматичне завантаження у власне сховище, щойно завдання успішно завершаться.