> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-docs-comfy-router-docs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Pixal3D Image to Model ComfyUI Workflow Example

> Generate high-fidelity 3D models with full PBR textures from a single image using Pixal3D, a pixel-aligned image-to-3D model from Tencent ARC.

**Pixal3D** is an open-source image-to-3D model from Tencent ARC, presented at SIGGRAPH 2026. It turns a single image into a high-fidelity 3D asset with full PBR materials.

Most 3D-native generators synthesize shapes in a canonical space and inject image cues through attention, which leaves pixel-to-3D associations ambiguous. Pixal3D instead uses pixel-aligned generation: it establishes direct pixel-to-3D correspondence through back-projection, so the front of the generated model matches your input image 1:1, with no warped or misaligned textures.

<h3 id="pixal3d">
  Pixal3D: Image to Model
</h3>

Upload a single image. Generate a high-fidelity 3D model with full PBR textures, aligned to your input view.

This workflow also includes the TRELLIS.2 pipeline. The `Boolean (Switch to Trellis2)` node defaults to `false`, which runs the Pixal3D pipeline and loads the Pixal3D model automatically.

<img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/3d_pixal3d_trellis2_image_to_model-1.webp" alt="Pixal3D workflow preview" />

<Tip>
  <Tabs>
    <Tab title="Local users">
      Make sure your ComfyUI is updated.

      * [Download ComfyUI](https://www.comfy.org/download)
      * [Update Guide](/installation/update_comfyui)

      Workflows in this guide can be found in the [Workflow Templates](/interface/features/template).
      If you can't find them in the template, your ComfyUI may be outdated.

      If nodes are missing when loading a workflow, possible reasons:

      1. You are not using the latest ComfyUI version (Nightly version)
      2. Some nodes failed to import at startup
    </Tab>

    <Tab title="Cloud users">
      * [Cloud](https://cloud.comfy.org) will update after ComfyUI stable release.

      So, if you find any core node missing in this document, it might be because the new core nodes have not yet been released in the latest stable version. Please wait for the next stable release.
    </Tab>
  </Tabs>
</Tip>

<CardGroup cols={2}>
  <Card title="Run on Comfy Cloud" icon="cloud" href="https://cloud.comfy.org/?template=3d_pixal3d_trellis2_image_to_model&utm_source=docs&utm_medium=referral&utm_campaign=pixal3d">
    Run this workflow instantly on Comfy Cloud
  </Card>

  <Card title="Download Workflow" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/3d_pixal3d_trellis2_image_to_model.json">
    Download JSON or search "Pixal3D & TRELLIS.2: Image to Model" in Template Library
  </Card>
</CardGroup>

**Input materials**

Upload this file to the `LoadImage` node:

<CardGroup cols={1}>
  <Card title="viking_wolf_rune_axe.png" icon="image" href="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/viking_wolf_rune_axe.png">
    `LoadImage` node 122 · `viking_wolf_rune_axe.png`
  </Card>
</CardGroup>

<div style={{display: 'grid', gridTemplateColumns: 'repeat(2, minmax(0, 1fr))', gap: '1rem', alignItems: 'start'}}>
  <img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/viking_wolf_rune_axe.png" alt="Input image" style={{width: '100%', height: 'auto', objectFit: 'contain'}} />
</div>

## How it works

Pixal3D combines camera-aware, pixel-aligned generation with a complete mesh post-processing pipeline:

1. **Background removal**: BiRefNet removes the background from the input image, and the workflow crops the subject to a centered canvas. A switch lets you skip background removal
2. **Camera estimation**: MoGe estimates geometry and the camera field of view from the image. The FOV drives the pixel-aligned conditioning
3. **Structure generation**: a sparse structure latent is sampled and decoded into voxels, then converted into a rough mesh
4. **Shape refinement**: the shape stage and the upsampling stage refine the mesh up to the target resolution (1536)
5. **Texture generation**: a texture diffusion stage produces PBR material voxels (base color, metallic, roughness)
6. **Post-processing**: DC remesh, QEM decimation, UV unwrapping, and baking of base color, normal, and ambient occlusion maps into the final textured mesh

## Steps to run

1. **Load an image**: use the `LoadImage` node to load a single image of the object
2. **Queue the workflow**: press Ctrl (Cmd on macOS) + Enter
3. **Wait for the pipeline**: the structure, shape, and texture stages run in sequence, followed by post-processing
4. **View the result**: inspect the mesh in the `Preview3DAdvanced` node. The 3D model is saved to `ComfyUI/output/3d/ComfyUI/`

## Model downloads

Download the models used by this workflow. Both diffusion checkpoints are required: the switch selects which one runs. Place them in the corresponding `models/` subdirectories.

<CardGroup cols={2}>
  <Card title="Pixal3D UNet" icon="download" href="https://huggingface.co/Comfy-Org/Pixal3D/blob/main/diffusion_models/pixal3d_int8_convrot.safetensors">
    pixal3d\_int8\_convrot.safetensors: Pixal3D diffusion model, loaded by default
  </Card>

  <Card title="TRELLIS.2 UNet" icon="download" href="https://huggingface.co/Comfy-Org/TRELLIS.2/blob/main/diffusion_models/trellis_2_int8_convrot.safetensors">
    trellis\_2\_int8\_convrot.safetensors: TRELLIS.2 diffusion model, loaded when the switch is set to `true`
  </Card>

  <Card title="Shape VAE" icon="download" href="https://huggingface.co/Comfy-Org/Pixal3D/blob/main/vae/trellis_2_shape_vae_bf16.safetensors">
    trellis\_2\_shape\_vae\_bf16.safetensors: VAE for structure and shape decoding
  </Card>

  <Card title="Texture VAE" icon="download" href="https://huggingface.co/Comfy-Org/Pixal3D/blob/main/vae/trellis_2_texture_vae_bf16.safetensors">
    trellis\_2\_texture\_vae\_bf16.safetensors: VAE for texture decoding
  </Card>

  <Card title="DINOv3 CLIP vision" icon="download" href="https://huggingface.co/Comfy-Org/Pixal3D/blob/main/clip_vision/dino_v3_L_naf_fp32.safetensors">
    dino\_v3\_L\_naf\_fp32.safetensors: CLIP vision encoder for image conditioning
  </Card>

  <Card title="MoGe geometry" icon="download" href="https://huggingface.co/Comfy-Org/MoGe/blob/main/geometry_estimation/moge_2_vitl_normal_fp16.safetensors">
    moge\_2\_vitl\_normal\_fp16.safetensors: depth and camera estimation for pixel-aligned conditioning
  </Card>

  <Card title="BiRefNet background removal" icon="download" href="https://huggingface.co/Comfy-Org/BiRefNet/blob/main/background_removal/birefnet.safetensors">
    birefnet.safetensors: background removal model for preprocessing
  </Card>
</CardGroup>

### Model storage location

```
📂 ComfyUI/
├── 📂 models/
│   ├── 📂 diffusion_models/
│   │      ├── pixal3d_int8_convrot.safetensors
│   │      └── trellis_2_int8_convrot.safetensors
│   ├── 📂 vae/
│   │      ├── trellis_2_shape_vae_bf16.safetensors
│   │      └── trellis_2_texture_vae_bf16.safetensors
│   ├── 📂 clip_vision/
│   │      └── dino_v3_L_naf_fp32.safetensors
│   ├── 📂 geometry_estimation/
│   │      └── moge_2_vitl_normal_fp16.safetensors
│   └── 📂 background_removal/
│          └── birefnet.safetensors
```