Hunyuan3D — семейство Tencent для генерации 3D-ассетов. Наиболее практичная открытая ветка Hunyuan3D 2.1 строит процесс в два этапа: сначала создаёт геометрию объекта, затем накладывает физически более правдоподобную PBR-текстуру. Tencent публикует model weights, inference и training code, локальный API server и примеры интеграции. Это делает Hunyuan3D интересным не только пользователю готового Studio, но и разработчикам 3D-pipeline, Blender/ComfyUI workflow и исследовательским командам.
Двухэтапная архитектура: shape и texture
Hunyuan3D разделяет построение формы и генерацию текстуры. Shape model отвечает за mesh, а Paint model — за визуальный материал. Такое разделение позволяет отдельно оценивать геометрию и внешний вид.
Если mesh уже плохой, красивая texture не исправит силуэт и topology. В production полезно сначала проверить untextured geometry и только потом тратить время на paint.
Image-to-3D
Основной публичный workflow принимает изображение объекта и превращает его в 3D mesh. Перед генерацией background может удаляться автоматически.
Лучшие исходники имеют понятный объект, хороший контраст и минимум перекрытий. Вид только с одной стороны неизбежно заставляет модель угадывать скрытые поверхности.
PBR-текстуры в 2.1
Версия 2.1 добавила PBR-oriented texture pipeline, рассчитанный на более реалистичное взаимодействие материала со светом: metallic, roughness и другие свойства выглядят убедительнее обычной плоской RGB-текстуры.
Это особенно важно для игровых и product visualization сцен, где asset рассматривается под разным освещением, а не только в одном render.
Полные weights и training code
Tencent заявляет 2.1 как fully open-sourced framework в смысле опубликованных weights и training code. Это позволяет исследователям fine-tune и расширять систему, а не только запускать готовый inference.
При этом лицензия — не MIT и не Apache. Используется Tencent Hunyuan Community License, поэтому коммерческие и масштабные сценарии нужно проверять по её условиям.
VRAM: сколько нужно локально
В официальном README указаны ориентиры: около 10 GB VRAM для shape generation, 21 GB для texture generation и примерно 29 GB для полного shape+texture pipeline.
Это делает локальный запуск доступным не любой consumer GPU. Low-VRAM режимы и оптимизации помогают, но throughput и время генерации меняются.
Windows, Linux и macOS
В README перечислены Windows, Linux и macOS как поддерживаемые направления запуска, но реальная setup-процедура существенно зависит от CUDA и выбранной части pipeline.
Для полного GPU workflow проще всего воспроизводить официальную протестированную environment с указанными PyTorch/CUDA versions.
Локальный API server
В репозитории есть FastAPI server для image-to-3D. Он умеет принимать изображение, автоматически убирать фон, генерировать shape, опционально texture и возвращать задачу синхронно или асинхронно.
Это удобный способ встроить Hunyuan3D в собственную очередь генерации без ручного Gradio.
GLB, OBJ, PLY и STL
Инструменты проекта поддерживают несколько распространённых 3D-форматов, включая GLB, OBJ, PLY и STL в соответствующих workflow.
Перед дальнейшим использованием в игре или печати mesh всё равно может потребовать cleanup, decimation, UV-check и проверку normals.
Blender и ComfyUI
Экосистема Hunyuan3D включает Blender add-on и community-интеграции с ComfyUI. Это позволяет поместить генерацию прямо в привычный 3D или node-based pipeline.
Community extension следует фиксировать по версии: обновление Hunyuan или ComfyUI может временно нарушить совместимость wrapper.
Hunyuan3D 2.5 и соседние исследования
Tencent публиковала technical report Hunyuan3D 2.5 и развивает более широкие направления вроде HunyuanWorld. Это показывает активное продолжение исследований, но не означает, что каждая новая research-модель заменяет стабильный 2.1 workflow.
Для production лучше выбирать конкретный repository и version, а не абстрактно «самый новый Hunyuan».
Кому подходит Hunyuan3D
Система полезна game artists, 3D-прототипированию, e-commerce visualization и разработчикам, которым нужен собственный image-to-3D pipeline. Открытый код особенно ценен для автоматизации и research.
Для готового high-end hero asset художник всё ещё должен проверять topology, материалы и скрытые стороны. Генерация ускоряет основу, но не гарантирует production-ready mesh без контроля.
Вопросы по Hunyuan3D
Сколько VRAM требуется?
Официальный README приводит примерно 10 GB для shape, 21 GB для texture и 29 GB для полного pipeline.
Есть локальный API?
Да, в репозитории опубликован FastAPI server с synchronous и asynchronous generation.
Лицензия полностью свободная?
Код и weights опубликованы, но используется специальная Tencent Hunyuan Community License; условия конкретного использования нужно читать отдельно.
