Коли ви створюєте 3D-ресурси через Meshy API, результат кожного завдання тимчасово зберігається на серверах Meshy. Розуміння терміну зберігання допоможе вам спланувати інтеграцію та вчасно завантажити результати до закінчення їхнього строку дії.
Термін зберігання ресурсів за типом завдання
Терміни зберігання відрізняються залежно від типу завдання:
Тип завдання | Термін зберігання |
Text to 3D | 3 дні після завершення завдання |
Image to 3D | 3 дні після завершення завдання |
Ригінг | 2 місяці після завершення завдання |
Text to 3D та Image to 3D
Завдання та їхні результати — файли моделей, зображення попереднього перегляду й текстури — зберігаються протягом 3 днів з моменту завершення завдання. Після цього завдання та всі пов'язані URL-адреси для завантаження стануть недоступними.
Кожна відповідь API на завдання містить поле expires_at (мітка часу Unix у мілісекундах), яке вказує точний час видалення завдання:
{
"id": "01abc123-...",
"status": "SUCCEEDED",
"expires_at": 1777029052743,
"result": {
"model_urls": { ... }
}
}
Відстежуйте це значення у своїй інтеграції та запускайте завантаження до закінчення цього строку.
Завдання ригінгу
Завдання ригінгу зберігаються протягом 2 місяців після завершення. Цей подовжений термін дозволяє вам продовжувати додавати нові анімації до того самого персонажа з ригом, використовуючи оригінальний ID завдання ригінгу — без необхідності створювати риг для мешу заново.
Щоб анімувати наявний риг, вкажіть ID завдання ригінгу у своєму запиті на анімацію в будь-який момент протягом 2-місячного терміну зберігання.
Отримання ваших ресурсів
Щоб отримати доступ до ресурсів, створених через API, до закінчення їхнього строку дії:
Завантажуйте негайно. Щойно завдання набуде статусу
SUCCEEDED, завантажте файли результатів (GLB, FBX, OBJ тощо) у власне сховище.Використовуйте ендпоінт списку завдань. Отримуйте нещодавні ID завдань та URL-адреси результатів через ендпоінти API списку Text to 3D або Image to 3D.
FAQ
1. Чому моя модель, створена через API, не з'являється в робочому просторі?
Це очікувана поведінка. Ресурси, створені через API, не з'являються в інтерфейсі робочого простору Meshy. Так задумано — API та робочий простір мають окремі життєві цикли ресурсів з різними правилами закінчення строку дії.
2. Чому URL-адреси мого завдання повертають 404?
Якщо мітка часу expires_at завдання минула, ресурс було видалено з серверів Meshy. Вам потрібно повторно надіслати завдання генерації. Щоб уникнути цього в майбутньому, налаштуйте автоматичне завантаження у власне сховище щойно завдання завершиться успішно.
3. Чи можу я додати нові анімації до персонажа після закінчення строку дії завдання ригінгу?
Завдання ригінгу доступні протягом 2 місяців, що дає вам достатньо часу, щоб продовжувати додавати анімації. Якщо строк дії завдання ригінгу минув (понад 2 місяці), вам потрібно буде створити риг для оригінального мешу заново.
Примітка: Meshy не гарантує сумісності скелетів між окремими запусками ригінгу.