Когда вы создаёте 3D-ресурсы через Meshy API, результат каждой задачи временно хранится на серверах Meshy. Понимание сроков хранения поможет вам спланировать интеграцию и guarantees, что вы скачаете результаты до истечения их срока действия.
Сроки хранения ресурсов по типам задач
Сроки хранения различаются в зависимости от типа задачи:
Тип задачи | Срок хранения |
Text to 3D | 3 дня после завершения задачи |
Image to 3D | 3 дня после завершения задачи |
Rigging | 2 месяца после завершения задачи |
Text to 3D и Image to 3D
Задачи и их результаты — файлы моделей, изображения предпросмотра и текстуры — хранятся в течение 3 дней с момента завершения задачи. По истечении этого срока задача и все связанные с ней ссылки для скачивания станут недоступными.
Каждый ответ API-задачи содержит поле expires_at (временная метка Unix в миллисекундах), указывающее точное время удаления задачи:
{
"id": "01abc123-...",
"status": "SUCCEEDED",
"expires_at": 1777029052743,
"result": {
"model_urls": { ... }
}
}
Отслеживайте это значение в своей интеграции и запускайте скачивание до его истечения.
Задачи Rigging
Задачи Rigging хранятся в течение 2 месяцев после завершения. Этот увеличенный срок позволяет добавлять новые анимации к тому же персонажу с настроенным скелетом, используя идентификатор исходной задачи Rigging — без необходимости заново настраивать скелет для полигональной сетки.
Чтобы добавить анимацию к существующему скелету, укажите идентификатор задачи Rigging в запросе на анимацию в любой момент в течение 2-месячного срока хранения.
Получение ваших ресурсов
Чтобы получить доступ к ресурсам, созданным через API, до истечения их срока хранения:
Скачивайте сразу же. Как только задача достигнет статуса
SUCCEEDED, скачайте файлы результатов (GLB, FBX, OBJ и т. д.) в своё хранилище.Используйте эндпоинт списка задач. Получайте идентификаторы недавних задач и ссылки на результаты через эндпоинты API списка Text to 3D или Image to 3D.
FAQ
1. Почему модель, созданная через API, не отображается в моём рабочем пространстве?
Это ожидаемое поведение. Ресурсы, созданные через API, не отображаются в интерфейсе Meshy Workspace. Это сделано намеренно — у API и Workspace разные жизненные циклы ресурсов с разными правилами истечения срока действия.
2. Почему ссылки на мою задачу возвращают 404?
Если временная метка expires_at задачи истекла, ресурс был удалён с серверов Meshy. Вам потребуется повторно отправить задачу генерации. Чтобы избежать этого в будущем, настройте автоматическое скачивание в собственное хранилище сразу после успешного выполнения задач.
3. Могу ли я добавить новые анимации к персонажу после истечения срока действия задачи Rigging?
Задачи Rigging доступны в течение 2 месяцев, что даёт вам достаточно времени для добавления анимаций. Если срок действия задачи Rigging истёк (прошло более 2 месяцев), вам потребуется заново настроить скелет для исходной полигональной сетки.
Примечание: Meshy не гарантирует совместимость скелетов между отдельными запусками Rigging.