zhenzhen-hyper3d-rodin-v2.5-fal
The most 'tunable' 3D node in the zhenzhen pack
- image1
- image2
- model_url
- response
- texture_urls
- model_3d
Where Hunyuan3D gives you "a" 3D model, Hyper3D Rodin v2.5 gives you a 3D model with a quality ladder. The schema is basically a mesh baker's control panel: a tier from Gen-2.5-Extreme-Low up to Gen-2.5-Extreme-High, a quality_mesh_option that goes from 4K Quad (four-sided quads at 4K texture) up to 2M Triangle, five export formats, and a texture-resolution mode. If you've ever been frustrated by a one-shot image-to-3D tool giving you no control over the output, this node is the antidote - it's Rodin (the Deemos product, wrapped here via Zhenzhen's fal proxy) with the knobs actually exposed.
The trade-off is that it's the most expensive and most fiddly 3D node in the pack. Every one of those quality choices is a billed line item. The good news is the pack's defaults are sane: Gen-2.5-Extreme-Low tier, 4K Quad mesh, All materials - which is plenty for a first pass.
How it works
mode is text_to_3d or image_to_3d (up to two reference images via image1/image2 or image_url1/image_url2). Submit to the fal proxy, poll, download, done. Outputs are model_url, response, texture_urls (STRING) and model_3d (FILE_3D), and it's a non-output node, so it can feed downstream graph nodes.
The inputs that actually matter
tier- the generation quality ladder (Extreme-Low → Extreme-High). This drives the big cost differences; iterate at Low/Medium, only reach for High when you're near done.quality_mesh_option-4K Quad/8K Quad/18K Quad/50K Quad/100K Quad/200K Quad(quad-based, cleaner topology) or2K/20K/150K/500K/1M/2M Triangle(raw triangle counts). Quads are the ones that might actually be usable in a game engine; triangles are for when you want raw density.geometry_file_format-glb,usdz,fbx,obj, orstl. Pick by downstream use: glb is the universal default, fbx if you're going into a DCC tool, stl if you're printing.material-PBR/Shaded/All/None.texture_mode-legacytohigh.hd_texture- on for 4K textures.geometry_instruct_mode-faithful(stay true to the source) vscreative.is_symmetric-symmetric/balanced/asymmetric/unknown; telling it the subject is symmetric is a real quality lever for characters and objects.seed- note this one's max is 65535 (the tooltip says FAL's seed cap), and0= random. Actual reproducibility, unlike the cache-only seeds elsewhere in the pack.
Installing it
Manager → search Comfyui-zhenzhen → install, or:
cd ComfyUI/custom_nodes
git clone https://github.com/T8mars/Comfyui-zhenzhen
Restart, paste your api_key into the widget. No model downloads.
Common issues
- Price shock at High/Extreme-High - expected, and the README's fal billing (pre-deduct, refund after) means the number you see at submit isn't final. Budget with the tier, not the final mesh.
- Slow jobs - a 2M-triangle 4K-texture run is a real render. Raise
max_poll_attempts; the default hour is usually enough but dense combos can scrape it. TAPose,texture_delight,is_micro- advanced Rodin features (pose control, delighting, micro-geometry). Leave them off unless you know what you're doing; they add cost.- The pack standard gotchas - empty key, 443/VPN-in-TUN-mode for overseas servers, vendor 500s needing a re-run.
If you want one knob that says "better," the other 3D nodes win. If you want to actually steer the mesh quality, texture resolution and export format of a generated model, Rodin is the one, and this node exposes all of it.
Inputs (24)
| Name | Type | Default | Description |
|---|---|---|---|
| prompt | STRING | — | |
| modeopt | COMBO | text_to_3d | 2 options: text_to_3d, image_to_3d |
| image1opt | IMAGE | — | |
| image2opt | IMAGE | — | |
| image_url1opt | STRING | — | |
| image_url2opt | STRING | — | |
| api_keyopt | STRING | — | |
| tieropt | COMBO | Gen-2.5-Extreme-Low | 5 options: Gen-2.5-Extreme-Low, Gen-2.5-Low, Gen-2.5-Medium, Gen-2.5-High, Gen-2.5-Extreme-High |
| geometry_file_formatopt | COMBO | glb | 5 options: glb, usdz, fbx, obj, stl |
| materialopt | COMBO | All | 4 options: PBR, Shaded, All, None |
| quality_mesh_optionopt | COMBO | 4K Quad | 12 options: 4K Quad, 8K Quad, 18K Quad, 50K Quad, 100K Quad, 200K Quad, +6 |
| texture_modeopt | COMBO | extreme-low | 5 options: legacy, extreme-low, low, medium, high |
| geometry_instruct_modeopt | COMBO | faithful | 2 options: faithful, creative |
| is_symmetricopt | COMBO | unknown | 4 options: symmetric, balanced, asymmetric, unknown |
| use_original_alphaopt | BOOLEAN | false | — |
| hd_textureopt | BOOLEAN | false | — |
| texture_delightopt | BOOLEAN | false | — |
| is_microopt | BOOLEAN | false | — |
| TAPoseopt | BOOLEAN | false | — |
| seedopt | INT | 00–65535 | 0 = random seed. FAL seed max is 65535. |
| image_wayopt | COMBO | base64 | 2 options: base64, image_url |
| poll_intervalopt | INT | 61–60 | — |
| max_poll_attemptsopt | INT | 60010–3600 | Default 600*6s = 3600s timeout. |
| skip_erroropt | BOOLEAN | false | — |
Outputs (4)
| Name | Type | Description |
|---|---|---|
| model_url | STRING | — |
| response | STRING | — |
| texture_urls | STRING | — |
| model_3d | FILE_3D | — |