Hunyuan 3D 2.5, Explained: What Changed From 2.0
Hunyuan 3D 2.5 is Tencent's April 2025 upgrade to its image-to-3D system, with a 10B shape model and PBR materials; this page covers what is new and how to use it. Want a textured model today? Try SupaVoxel's generator: typically 3 to 5 minutes, nothing to install.
- SupaVoxel: 3 free credits
- No GPU or install
- STL, OBJ, USDZ, 3MF on paid plans
By SupaVoxel Team·Updated

Drop in a picture, get a 3D model
3 free credits · Google sign-in · no card
What is Hunyuan 3D 2.5?
Hunyuan 3D 2.5 is a version of Tencent's Hunyuan3D image-to-3D system that turns a picture into a detailed, textured 3D model. Tencent launched it on April 23, 2025 as an upgrade to its online 3D creation engine and opened an API on Tencent Cloud the same day. A technical report followed on June 19, 2025.
It keeps the two-stage design of Hunyuan 3D 2.0: first a shape model builds an untextured mesh from your image, then a texture model paints it. What changed is the scale and the materials. The shape stage uses a new foundation model called LATTICE, whose largest version has 10 billion parameters, and the texture stage now outputs physically based (PBR) materials instead of a plain color map.
Tencent offered Hunyuan3D 2.5 on its own platform and API. Unlike 2.0 and 2.1, it lists no downloadable 2.5 checkpoint. Our Hunyuan3D overview covers the whole family; this page sticks to 2.5.
Hunyuan 3D 2.5 vs 2.0: what changed
The short answer: 2.5 has a much larger shape model, accepts four views, adds PBR materials and rigging, and is offered hosted, with no open checkpoint listed. Here is the comparison side by side.
Released
- Hunyuan3D 2.0
- Jan 21, 2025
- Hunyuan 3D 2.5
- Apr 23, 2025 (report Jun 19, 2025)
Shape model
- Hunyuan3D 2.0
- Hunyuan3D-DiT, 1.1B
- Hunyuan 3D 2.5
- LATTICE, largest version 10B
Shape input
- Hunyuan3D 2.0
- One image (multi-view via the separate 2mv model)
- Hunyuan 3D 2.5
- One image or four multi-view images
Materials
- Hunyuan3D 2.0
- Color texture
- Hunyuan 3D 2.5
- PBR: albedo plus metallic and roughness
Extras
- Hunyuan3D 2.0
- Local Gradio app; Blender add-on (Jan 27, 2025)
- Hunyuan 3D 2.5
- Automatic rigging and skin weights, mesh reduction templates on Tencent's platform
Weights
- Hunyuan3D 2.0
- Open, run it yourself
- Hunyuan 3D 2.5
- Hosted by Tencent; no 2.5 checkpoint listed
VRAM to run locally
- Hunyuan3D 2.0
- 16 GB for shape plus texture
- Hunyuan 3D 2.5
- Not applicable
| Hunyuan3D 2.0 | Hunyuan 3D 2.5 | |
|---|---|---|
| Released | Jan 21, 2025 | Apr 23, 2025 (report Jun 19, 2025) |
| Shape model | Hunyuan3D-DiT, 1.1B | LATTICE, largest version 10B |
| Shape input | One image (multi-view via the separate 2mv model) | One image or four multi-view images |
| Materials | Color texture | PBR: albedo plus metallic and roughness |
| Extras | Local Gradio app; Blender add-on (Jan 27, 2025) | Automatic rigging and skin weights, mesh reduction templates on Tencent's platform |
| Weights | Open, run it yourself | Hosted by Tencent; no 2.5 checkpoint listed |
| VRAM to run locally | 16 GB for shape plus texture | Not applicable |
The full 2.0 model zoo, VRAM figures and license are on our Hunyuan 3D 2.0 page.
Hunyuan 3D 2.5 specs
What Tencent published about Hunyuan 3D 2.5 in its launch announcement and technical report. The last row shows SupaVoxel's generator for comparison.
- Maker
- Tencent Hunyuan team
- Input
- One image or four multi-view images; text prompts on Tencent's platform
- Shape model
- LATTICE, a large diffusion model with guidance and step distillation for speed; largest version 10B
- Geometry
- Tencent advertises 1024-resolution geometry and 10 times the mesh faces of the previous version
- Texture
- Multi-view PBR maps (albedo, metallic-roughness) at up to 768 × 768 per view
- Access
- Tencent's online 3D creation engine and Tencent Cloud API; no open weights listed
- Alternative: SupaVoxel's generator
- Works in the browser, textured model in typically 3 to 5 minutes, downloads and STL / OBJ / USDZ / 3MF exports on paid plans
How the Hunyuan 3D 2.5 pipeline works
Tencent's technical report describes four steps from picture to textured asset. The structure is the same as 2.0; the models inside are new.
- 01
Clean up the input image
An image processor removes the background and resizes the picture so the object sits centered for the shape model. - 02
Generate the shape with LATTICE
The LATTICE shape model, conditioned on one image or four views, produces an untextured mesh with sharp edges and smooth surfaces. - 03
Prepare the mesh for painting
The mesh is processed to extract normals, a UV map and other geometry signals that the texture model uses as conditions. - 04
Paint PBR materials
The texture model generates multi-view albedo and metallic-roughness maps, using normal and position maps rendered from the mesh plus your reference image.
Hunyuan3D 2.5 shape benchmarks
Tencent measured how closely each model's shapes match the input images (-I) and text prompts generated from those images (-T). Higher is better in every column.
Hunyuan 3D 2.5
- ULIP-T
- 0.07853
- ULIP-I
- 0.1306
- Uni3D-T
- 0.2542
- Uni3D-I
- 0.3151
Hunyuan3D 2.0
- ULIP-T
- 0.0771
- ULIP-I
- 0.1303
- Uni3D-T
- 0.2519
- Uni3D-I
- 0.3151
TRELLIS
- ULIP-T
- 0.0769
- ULIP-I
- 0.1267
- Uni3D-T
- 0.2496
- Uni3D-I
- 0.3116
Commercial model 1
- ULIP-T
- 0.0741
- ULIP-I
- 0.1308
- Uni3D-T
- 0.2464
- Uni3D-I
- 0.3106
Commercial model 2
- ULIP-T
- 0.0746
- ULIP-I
- 0.1284
- Uni3D-T
- 0.2516
- Uni3D-I
- 0.3131
| Model | ULIP-T | ULIP-I | Uni3D-T | Uni3D-I |
|---|---|---|---|---|
| Hunyuan 3D 2.5 | 0.07853 | 0.1306 | 0.2542 | 0.3151 |
| Hunyuan3D 2.0 | 0.0771 | 0.1303 | 0.2519 | 0.3151 |
| TRELLIS | 0.0769 | 0.1267 | 0.2496 | 0.3116 |
| Commercial model 1 | 0.0741 | 0.1308 | 0.2464 | 0.3106 |
| Commercial model 2 | 0.0746 | 0.1284 | 0.2516 | 0.3131 |
Tencent's own numbers; the commercial models are not named and we have not reproduced them. Version 2.5 leads on ULIP-T and Uni3D-T, ties 2.0 on Uni3D-I and trails Commercial model 1 on ULIP-I. Two older open baselines, Michelangelo and Craftsman 1.5, are left out here. The report itself says these metrics do not fully show the jump in detail.
Hunyuan3D 2.5 texture benchmarks
For textures Tencent compared against published texturing methods. Lower is better for CLIP-FID, FID, CMMD and LPIPS; higher is better for CLIP-I. Three text-only methods (Text2Tex, SyncMVD, Paint-it) are left out; 2.5 also beats them on every metric they report.
Hunyuan 3D 2.5
- CLIP-FID
- 23.97
- FID
- 165.8
- CMMD
- 2.064
- CLIP-I
- 0.9281
- LPIPS
- 0.1231
Paint3D
- CLIP-FID
- 26.86
- FID
- 176.9
- CMMD
- 2.400
- CLIP-I
- 0.8871
- LPIPS
- 0.1261
TexGen
- CLIP-FID
- 28.23
- FID
- 178.6
- CMMD
- 2.447
- CLIP-I
- 0.8818
- LPIPS
- 0.1331
| Method | CLIP-FID | FID | CMMD | CLIP-I | LPIPS |
|---|---|---|---|---|---|
| Hunyuan 3D 2.5 | 23.97 | 165.8 | 2.064 | 0.9281 | 0.1231 |
| Paint3D | 26.86 | 176.9 | 2.400 | 0.8871 | 0.1261 |
| TexGen | 28.23 | 178.6 | 2.447 | 0.8818 | 0.1331 |
In a user study ranking textured results against three unnamed commercial models, Tencent reports a 72% win rate for image to 3D, which it says is nine times the win rate of its Commercial Model 1.
What is new in Hunyuan 3D 2.5
These are the upgrades Tencent highlights over the 2.0 release, in its launch post and report.
A much bigger shape model
Finer detail, cleaner surfaces
Four-view input
PBR materials
Sharper texture alignment
Rigging on the platform
Hunyuan 3D 2.5 limits to know
Hunyuan 3D 2.5 was a big step up by Tencent's own measures, but Tencent lists no downloadable 2.5 checkpoint, and its API now lists newer 3.x versions.
- Use 2.0 or 2.1 if you need weights you can run yourself
- Treat the benchmark tables as Tencent's own figures
- Plan time for retopology before animation or games
- Check a mesh in a slicer before you 3D print it
- Search Hugging Face for 2.5 weights; Tencent lists none
- Expect to pick 2.5 in Tencent's international API today; its Pro endpoint lists only versions 3.0 and 3.1
- Expect clean quad topology; Tencent said in April 2025 it was still improving mesh decimation
- Confuse the 10B figure with VRAM; Tencent lists no local hardware requirements for 2.5
Can you still use Hunyuan 3D 2.5? An alternative
Tencent lists no open Hunyuan 3D 2.5 weights, so there is nothing to install. At launch you used it on Tencent's 3D creation platform, with 20 free generations a day, or through the Tencent Cloud API. Tencent has since moved on: its international Pro 3D API lists only model versions 3.0 and 3.1, and the nearest open releases you can run yourself are Hunyuan 3D 2.0 and 2.1.
If you just want a textured model from a picture, SupaVoxel's image to 3D generator runs online with nothing to install. Upload one image, add up to 4 extra angles if the back matters, and get a textured model in typically 3 to 5 minutes. Most new accounts get 3 free credits with no card, enough for one textured model, and failed generations refund their credits.
View your model free in the browser; downloads, including STL, OBJ, USDZ and multi-color 3MF exports, come with a paid plan from $25 a year. Whatever made your mesh, the free STL repair tool fixes print errors, and the mesh simplifier slims a heavy mesh for a game engine.
What SupaVoxel's generator makes from one picture
These six models come from SupaVoxel's gallery, each made from one image with SupaVoxel's generator, so you can judge the result.
More on Hunyuan3D and what to do with a mesh
Other Hunyuan3D versions, plus free tools and next steps for any generated model.
Frequently asked questions
What is Hunyuan 3D 2.5?
Is Hunyuan3D 2.5 open source?
What is the difference between Hunyuan3D 2.5 and 2.0?
Is Hunyuan 2.5 better than 2.1?
Can I still use Hunyuan3D-2.5?
Was Hunyuan 3D 2.5 free?
Does Hunyuan 3D 2.5 support text to 3D?
Is Hunyuan 3D 2.5 good for 3D printing?
No Hunyuan 3D 2.5 download? Make a 3D model online
Upload one picture and get a textured 3D model in typically 3 to 5 minutes, with nothing to install. Start with 3 free credits, no card needed.
No credit card required · 3 free credits to start