Nodes/Comfyui-zhenzhen/zhenzhen-hyper3d-rodin-v2.5-fal
ComfyUI Node

zhenzhen-hyper3d-rodin-v2.5-fal

The most 'tunable' 3D node in the zhenzhen pack

By T8mars·Created about a year ago·Updated 2 days ago· 740
zhenzhen-hyper3d-rodin-v2.5-fal
  • image1
  • image2
  • model_url
  • response
  • texture_urls
  • model_3d
prompt
modetext_to_3d
image_url1
image_url2
api_key
tierGen-2.5-Extreme-Low
geometry_file_formatglb
materialAll
quality_mesh_option4K Quad
texture_modeextreme-low
geometry_instruct_modefaithful
is_symmetricunknown
use_original_alphafalse
hd_texturefalse
texture_delightfalse
is_microfalse
TAPosefalse
seed0
image_waybase64
poll_interval6
max_poll_attempts600
skip_errorfalse

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) or 2K / 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, or stl. 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 - legacy to high. hd_texture - on for 4K textures.
  • geometry_instruct_mode - faithful (stay true to the source) vs creative. 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), and 0 = 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.

Categoryzhenzhen/FAL

Inputs (24)

NameTypeDefaultDescription
promptSTRING
modeoptCOMBOtext_to_3d2 options: text_to_3d, image_to_3d
image1optIMAGE
image2optIMAGE
image_url1optSTRING
image_url2optSTRING
api_keyoptSTRING
tieroptCOMBOGen-2.5-Extreme-Low5 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_formatoptCOMBOglb5 options: glb, usdz, fbx, obj, stl
materialoptCOMBOAll4 options: PBR, Shaded, All, None
quality_mesh_optionoptCOMBO4K Quad12 options: 4K Quad, 8K Quad, 18K Quad, 50K Quad, 100K Quad, 200K Quad, +6
texture_modeoptCOMBOextreme-low5 options: legacy, extreme-low, low, medium, high
geometry_instruct_modeoptCOMBOfaithful2 options: faithful, creative
is_symmetricoptCOMBOunknown4 options: symmetric, balanced, asymmetric, unknown
use_original_alphaoptBOOLEANfalse
hd_textureoptBOOLEANfalse
texture_delightoptBOOLEANfalse
is_microoptBOOLEANfalse
TAPoseoptBOOLEANfalse
seedoptINT00–655350 = random seed. FAL seed max is 65535.
image_wayoptCOMBObase642 options: base64, image_url
poll_intervaloptINT61–60
max_poll_attemptsoptINT60010–3600Default 600*6s = 3600s timeout.
skip_erroroptBOOLEANfalse

Outputs (4)

NameTypeDescription
model_urlSTRING
responseSTRING
texture_urlsSTRING
model_3dFILE_3D