3D Generation node
The 3D Generation node generates a 3D model (.glb) from a text prompt
and/or a reference image through Replicate.
Handles
| Handle | Purpose |
|---|---|
prompt | The text prompt (text-to-3D models) |
image | The reference image (image-to-3D models) |
Configuration
- Model — a Replicate reference (
owner/name, optionally:version). - Seed — deterministic output.
- Timeout — generation timeout in milliseconds.
Model input support
3D models differ in what they accept:
| Model | Text | Image |
|---|---|---|
ndreca/hunyuan3d-2 | ✗ | ✓ |
ndreca/hunyuan3d-2.1 | ✗ | ✓ |
firtoz/trellis | ✗ | ✓ |
camenduru/lgm | ✓ | ✓ |
The node warns when you wire text into an image-only model, or when an image-only model has no image source.
Output
The generated mesh is copied to Vercel Blob and returned as:
{ "url": "https://…/model.glb", "mime": "model/gltf-binary", "format": "glb" }The URL is stable (Replicate’s own delivery URLs expire after ~1 hour).
Example
Wire an Upload File (image) into image, pick ndreca/hunyuan3d-2, and run.
The node looks up the model’s input schema, sends only accepted fields,
polls the prediction to completion, and returns the GLB.
Notes
- Runs through Replicate (the AI gateway has no 3D modality), so it needs a
REPLICATE_API_KEY. - The card embeds an interactive GLB viewer and artifact history.
Related
- Upload File — the reference image.