Trải nghiệm khi dùng Hunyuan3D 2.0
Với người không rành lập trình, cách dễ nhất là vào trang web chính thức của Hunyuan3D để thử ngay mà không cần cài gì (README gọi là Official Site). Tại đó bạn đưa ảnh vào và nhận mô hình 3D. Chạy trên máy bạn thì khác: cần cài PyTorch, thư viện của repo, biên dịch thêm hai phần cho texture rồi mới mở được giao diện.
Khi chạy được giao diện Gradio trên máy, bạn mở trình duyệt, thả một ảnh vật thể (nền càng sạch càng tốt), chọn chế độ có tạo texture hay không rồi chờ. Sau vài phút bạn xoay được mô hình 3D ngay trên trang, rồi tải file về để mở trong Blender hoặc phần mềm khác.
Nếu bạn dùng Blender, repo còn có addon: bật một máy chủ API cục bộ, rồi gửi ảnh từ trong Blender sang để nhận mô hình về. Cách này tiện cho người làm đồ hoạ vì không phải xuất nhập file qua lại.
Tính năng nổi bật
Hình khối từ ảnh
Mô hình Hunyuan3D-DiT tạo hình học có chi tiết, bám theo ảnh đầu vào. Có nhiều phiên bản như mini, turbo cho nhẹ và nhanh hơn.
Tô màu và texture
Mô hình Hunyuan3D-Paint vẽ texture lên khối vừa tạo, hoặc lên chính khối bạn tự dựng sẵn.
Nhiều ảnh cho một vật
Bản multiview (2mv) nhận nhiều ảnh nhìn từ các góc khác nhau để dựng chính xác hơn.
Giao diện web và API
Chạy giao diện Gradio trên máy để dùng bằng chuột, hoặc bật API server để các chương trình khác gọi vào.
Addon Blender
Kết nối trực tiếp Blender với máy chủ Hunyuan3D để tạo vật thể ngay trong phần mềm 3D.
Cộng đồng bổ sung
README liệt kê nhiều dự án cộng đồng: gói chạy cho Windows, node cho ComfyUI, bản tối ưu cho card yếu.
Tận dụng Hunyuan3D 2.0 vào việc gì?
Chủ shop, người làm quảng cáo
Tạo nhanh mô hình 3D từ ảnh sản phẩm
Biến ảnh một món đồ thành mô hình 3D thô để xem, đặt vào cảnh dựng hoặc làm nền cho bước chỉnh sửa tiếp.
Người làm game, hoạ sĩ 3D
Dựng vật thể phụ cho game và cảnh 3D
Tạo nhanh đạo cụ, đồ vật trang trí để làm bản nháp trước khi tinh chỉnh bằng tay.
Người chơi in 3D, sinh viên thiết kế
Chuẩn bị mô hình in 3D
Lấy mô hình sinh ra từ ảnh, chỉnh sửa lại trong phần mềm 3D rồi in thử.
Hoạ sĩ 3D, lập trình viên
Đưa AI vào quy trình Blender
Dùng addon Blender và API server để tự động sinh vật thể trong quy trình sản xuất.
Cần chuẩn bị gì?
- Theo README: khoảng 6 GB VRAM cho riêng phần tạo hình khối và khoảng 16 GB cho tạo cả hình khối lẫn texture.
- README nói hỗ trợ macOS, Windows và Linux; thực tế card NVIDIA là lựa chọn phổ biến nhất cho PyTorch.
- Python và PyTorch cài theo trang chính thức pytorch.org, cộng thêm khả năng biên dịch hai thành phần texture (cần trình biên dịch C++ trên máy).
- Ổ cứng trống cho các mô hình tải từ Hugging Face.
Hướng dẫn cài đặt chi tiết
Cài trên Cài từ mã nguồn
Tải mã nguồn về và vào thư mục dự án. Cài PyTorch theo trang chính thức pytorch.org cho đúng card đồ hoạ của bạn.
git clone https://github.com/Tencent-Hunyuan/Hunyuan3D-2.git cd Hunyuan3D-2Cài các thư viện của repo.
pip install -r requirements.txt pip install -e .Nếu muốn dùng chức năng texture, biên dịch thêm hai thành phần theo README.
cd hy3dgen/texgen/custom_rasterizer python3 setup.py install cd ../../.. cd hy3dgen/texgen/differentiable_renderer python3 setup.py install
Cài trên Giao diện web
Sau khi cài xong, chạy giao diện Gradio. Lệnh dưới dùng bản mini nhẹ kèm chế độ ít VRAM, theo đúng ví dụ trong README.
python3 gradio_app.py --model_path tencent/Hunyuan3D-2mini --subfolder hunyuan3d-dit-v2-mini --texgen_model_path tencent/Hunyuan3D-2 --low_vram_modeMở địa chỉ hiện ra trong Terminal để dùng giao diện. Lần đầu mô hình sẽ tự tải về nên cần chờ.
Cài trên Dùng không cần cài
Truy cập trang web chính thức của Hunyuan3D để thử trực tiếp, không cần cài gì.
https://3d.hunyuan.tencent.comNếu dùng Windows và không muốn tự biên dịch, README liệt kê các gói cộng đồng như Hunyuan3D-2-WinPortable. Đây là dự án của bên thứ ba, hãy tự đánh giá độ tin cậy trước khi dùng.
Dùng thử lần đầu
Chuẩn bị một ảnh rõ vật thể, nền sạch (nền trắng hoặc đơn giản), vật nằm giữa khung hình.
Chạy lệnh mở giao diện Gradio như ở phần cài đặt, mở địa chỉ hiện trong Terminal.
Thả ảnh vào, tạo hình khối trước. Xem hình khối có đúng ý chưa trước khi bật phần texture vì phần texture nặng VRAM hơn nhiều.
Tải file mô hình về (README nói đầu ra là mesh có thể lưu thành glb hoặc obj) và mở bằng Blender để kiểm tra, xoay xem các mặt.
Muốn gọi bằng API, chạy máy chủ cục bộ rồi gửi ảnh lên, theo ví dụ trong README.
python api_server.py --host 0.0.0.0 --port 8080
Mẹo dùng hay
- Máy yếu thì dùng bản 2mini hoặc bản turbo, thêm tuỳ chọn --low_vram_mode như trong ví dụ README.
- Ảnh đầu vào càng gọn (một vật, nền đơn giản, ánh sáng đều) thì kết quả càng đáng tin.
- Đừng mở cổng API ra Internet; nếu chỉ dùng trên máy của mình, hãy giữ ở mạng nội bộ.
- Hunyuan3D 2.1 và 2.5 là các bản mới hơn cùng nhóm; xem phần tin tức trong README nếu cần chất lượng cao hơn.
Lưu ý và hạn chế
- Giấy phép của repo không được GitHub nhận diện tự động. Hãy đọc kỹ file LICENSE trong repo, đặc biệt nếu định dùng cho mục đích thương mại hoặc ở một số khu vực địa lý, trước khi dùng.
- Cài đặt tự biên dịch khá khó với người không quen Python, và README chỉ cung cấp hướng dẫn kiểu nhà phát triển.
- Mô hình 3D sinh ra từ ảnh có thể sai ở mặt khuất, chi tiết mảnh hoặc topology (cách chia lưới), thường cần chỉnh lại trước khi dùng cho game hoặc in 3D.
Câu hỏi thường gặp
Có miễn phí không?
Mã nguồn và mô hình tải về miễn phí, nhưng hãy đọc kỹ giấy phép trong repo trước khi dùng thương mại. Trang web chính thức của Tencent có điều khoản và giới hạn riêng.
Máy không có card rời có dùng được không?
README nêu yêu cầu VRAM cụ thể, nên cách thực tế là dùng trang web chính thức hoặc dịch vụ đám mây thay vì chạy trên máy văn phòng không có card đồ hoạ.
Xuất ra định dạng nào?
Kết quả là đối tượng mesh (trimesh), README nói bạn có thể lưu thành glb, obj hoặc định dạng khác, mở được bằng Blender.
Tải mã nguồn về máy
Nếu bạn muốn xem hoặc sửa mã nguồn, mở Terminal (trên Windows là PowerShell) và chạy lệnh dưới. Máy cần cài sẵn Git.
git clone https://github.com/Tencent-Hunyuan/Hunyuan3D-2.gitRepo tương tự nên xem
TRELLIS
microsoft / TRELLIS
Mô hình 3D của Microsoft tạo vật thể 3D chất lượng cao từ một ảnh hoặc câu mô tả
MCP for Blender (blender-mcp)
ahujasid / mcp-for-blender
Nối Claude hay AI khác vào Blender để dựng cảnh 3D, đổi vật liệu và tải mô hình bằng lời dặn
ComfyUI
Comfy-Org / ComfyUI
Tạo ảnh, video, âm thanh bằng AI ngay trên máy bằng cách nối các khối (node) thành quy trình