Chuyển đến nội dung

Tencent-Hunyuan / Hunyuan3D-2

Hunyuan3D 2.0

Mô hình AI của Tencent tạo vật thể 3D có màu sắc từ một tấm ảnh, chạy trên máy của bạn

Hunyuan3D 2.0 là hệ thống tạo mô hình 3D của Tencent, làm việc theo hai bước: trước tiên tạo hình khối (mesh) từ ảnh, sau đó vẽ texture (lớp màu và hoạ tiết) lên khối đó. Kết quả là file 3D dùng được trong Blender, game hoặc in 3D. Repo có mã nguồn, mô hình, giao diện web Gradio, API và addon cho Blender.

  • 15.433 sao
  • 1.601 fork
  • Python
  • Cập nhật 1 năm trước
  • Giấy phép riêng, xem trên GitHub
Độ khó
Khó Dành cho người biết lập trình
Dạng
Mô hình AI
Chạy trên
Windows, macOS, Linux, Python
Chi phí
Miễn phí hoàn toàn

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

  1. 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.

    Terminal
    git clone https://github.com/Tencent-Hunyuan/Hunyuan3D-2.git
    cd Hunyuan3D-2
  2. Cài các thư viện của repo.

    Terminal
    pip install -r requirements.txt
    pip install -e .
  3. Nếu muốn dùng chức năng texture, biên dịch thêm hai thành phần theo README.

    Terminal
    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

  1. 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.

    Terminal
    python3 gradio_app.py --model_path tencent/Hunyuan3D-2mini --subfolder hunyuan3d-dit-v2-mini --texgen_model_path tencent/Hunyuan3D-2 --low_vram_mode
  2. Mở đị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

  1. Truy cập trang web chính thức của Hunyuan3D để thử trực tiếp, không cần cài gì.

    Văn bản
    https://3d.hunyuan.tencent.com
  2. Nế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

  1. 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.

  2. Chạy lệnh mở giao diện Gradio như ở phần cài đặt, mở địa chỉ hiện trong Terminal.

  3. 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.

  4. 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.

  5. 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.

    Terminal
    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.

Terminal
git clone https://github.com/Tencent-Hunyuan/Hunyuan3D-2.git

Repo tương tự nên xem

Tạo ảnh & video bằng AI14,3K

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ả

KhóLinuxPython
MCP: nối AI với công cụ34,6K

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

VừaWindowsmacOSLinuxPython
Tạo ảnh & video bằng AI147K

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

VừaWindowsmacOSLinuxPython

Nội dung được biên soạn bằng tiếng Việt dựa trên tài liệu chính thức của dự án, cập nhật lần cuối 16/11/2026. Lệnh cài có thể thay đổi theo phiên bản mới; nếu có khác biệt, hãy làm theo README trên GitHub.

Cùng chủ đề: Tạo ảnh & video bằng AI

Tạo ảnh & video bằng AI165K

Stable Diffusion web UI (AUTOMATIC1111)

AUTOMATIC1111 / stable-diffusion-webui

Giao diện web kinh điển để tạo ảnh bằng Stable Diffusion ngay trên máy tính của bạn

VừaWindowsLinuxmacOSPython
Tạo ảnh & video bằng AI144K

MoneyPrinterTurbo

harry0703 / MoneyPrinterTurbo

Nhập chủ đề, tự có video ngắn: kịch bản, giọng đọc, cảnh quay, phụ đề và nhạc

VừaWindowsmacOSLinuxDocker+1
Tạo ảnh & video bằng AI53,9K

Fooocus

lllyasviel / Fooocus

Tạo ảnh AI kiểu Midjourney ngay trên máy bạn, chỉ cần gõ mô tả, ít phải chỉnh thông số

DễWindowsLinuxmacOSPython
Tạo ảnh & video bằng AI52,7K

Upscayl

upscayl / upscayl

Phóng to ảnh mờ, ảnh nhỏ lên nét hơn bằng AI, cài như phần mềm thường, bấm vài nút

DễWindowsmacOSLinux
Tạo ảnh & video bằng AI37,7K

GFPGAN

TencentARC / GFPGAN

AI khôi phục khuôn mặt trong ảnh cũ, ảnh mờ, ảnh do AI tạo ra cho rõ nét hơn

KhóPythonLinuxWindows
Tạo ảnh & video bằng AI37,5K

Real-ESRGAN

xinntao / Real-ESRGAN

Mô hình AI phóng to và làm nét ảnh, video; có bản chạy ngay không cần cài Python

VừaWindowsmacOSLinuxPython

Xem cả 26 repo Tạo ảnh & video bằng AI Về Kho Repo