{
  "seed": 1234,
  "image": "https://replicate.delivery/pbxt/MVC2B2XKgv4X13qIpW6t2m59EVfY2CqaS9e2CSsWNHPJjQAd/image.png",
  "steps": 50,
  "num_chunks": 200000,
  "max_facenum": 40000,
  "guidance_scale": 5.5,
  "octree_resolution": 512,
  "remove_background": false
}

Install Replicate’s Node.js client library:

npm install replicate

Import and set up the client:

import Replicate from "replicate";

const replicate = new Replicate({
  auth: process.env.REPLICATE_API_TOKEN,
});

Run ndreca/hunyuan3d-2 using Replicate’s API. Check out the model's schema for an overview of inputs and outputs.

const output = await replicate.run(
  "ndreca/hunyuan3d-2:0602bae6db1ce420f2690339bf2feb47e18c0c722a1f02e9db9abd774abaff5d",
  {
    input: {
      seed: 1234,
      image: "https://replicate.delivery/pbxt/MVC2B2XKgv4X13qIpW6t2m59EVfY2CqaS9e2CSsWNHPJjQAd/image.png",
      steps: 50,
      num_chunks: 200000,
      max_facenum: 40000,
      guidance_scale: 5.5,
      octree_resolution: 512,
      remove_background: false
    }
  }
);

console.log(output);

To learn more, take a look at the guide on getting started with Node.js.

Install Replicate’s Python client library:

pip install replicate

Import the client:

import replicate

Run ndreca/hunyuan3d-2 using Replicate’s API. Check out the model's schema for an overview of inputs and outputs.

output = replicate.run(
    "ndreca/hunyuan3d-2:0602bae6db1ce420f2690339bf2feb47e18c0c722a1f02e9db9abd774abaff5d",
    input={
        "seed": 1234,
        "image": "https://replicate.delivery/pbxt/MVC2B2XKgv4X13qIpW6t2m59EVfY2CqaS9e2CSsWNHPJjQAd/image.png",
        "steps": 50,
        "num_chunks": 200000,
        "max_facenum": 40000,
        "guidance_scale": 5.5,
        "octree_resolution": 512,
        "remove_background": False
    }
)

print(output)

To learn more, take a look at the guide on getting started with Python.

Run ndreca/hunyuan3d-2 using Replicate’s API. Check out the model's schema for an overview of inputs and outputs.

curl -s -X POST \
  -H "Authorization: Bearer $REPLICATE_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Prefer: wait" \
  -d $'{
    "version": "ndreca/hunyuan3d-2:0602bae6db1ce420f2690339bf2feb47e18c0c722a1f02e9db9abd774abaff5d",
    "input": {
      "seed": 1234,
      "image": "https://replicate.delivery/pbxt/MVC2B2XKgv4X13qIpW6t2m59EVfY2CqaS9e2CSsWNHPJjQAd/image.png",
      "steps": 50,
      "num_chunks": 200000,
      "max_facenum": 40000,
      "guidance_scale": 5.5,
      "octree_resolution": 512,
      "remove_background": false
    }
  }' \
  https://api.replicate.com/v1/predictions

To learn more, take a look at Replicate’s HTTP API reference docs.

Output

lighting

Lobby

brightness

contrast

Use your mouse to zoom and rotate the model

Loading 0.00%

{
  "completed_at": "2025-06-21T14:45:03.270182Z",
  "created_at": "2025-06-21T14:42:44.137000Z",
  "data_removed": false,
  "error": null,
  "id": "rn38psrv55rmc0cqjbrvkst8er",
  "input": {
    "seed": 1234,
    "image": "https://replicate.delivery/pbxt/MVC2B2XKgv4X13qIpW6t2m59EVfY2CqaS9e2CSsWNHPJjQAd/image.png",
    "steps": 50,
    "num_chunks": 200000,
    "max_facenum": 40000,
    "guidance_scale": 5.5,
    "octree_resolution": 512,
    "remove_background": false
  },
  "logs": "Diffusion Sampling::   0%|          | 0/50 [00:00<?, ?it/s]\nDiffusion Sampling::   2%|▏         | 1/50 [00:00<00:08,  6.06it/s]\nDiffusion Sampling::   6%|▌         | 3/50 [00:00<00:04, 10.66it/s]\nDiffusion Sampling::  10%|█         | 5/50 [00:00<00:03, 13.09it/s]\nDiffusion Sampling::  14%|█▍        | 7/50 [00:00<00:03, 13.17it/s]\nDiffusion Sampling::  18%|█▊        | 9/50 [00:00<00:03, 13.18it/s]\nDiffusion Sampling::  22%|██▏       | 11/50 [00:00<00:02, 13.18it/s]\nDiffusion Sampling::  26%|██▌       | 13/50 [00:01<00:02, 13.18it/s]\nDiffusion Sampling::  30%|███       | 15/50 [00:01<00:02, 13.16it/s]\nDiffusion Sampling::  34%|███▍      | 17/50 [00:01<00:02, 13.16it/s]\nDiffusion Sampling::  38%|███▊      | 19/50 [00:01<00:02, 13.15it/s]\nDiffusion Sampling::  42%|████▏     | 21/50 [00:01<00:02, 13.13it/s]\nDiffusion Sampling::  46%|████▌     | 23/50 [00:01<00:02, 13.13it/s]\nDiffusion Sampling::  50%|█████     | 25/50 [00:01<00:01, 13.12it/s]\nDiffusion Sampling::  54%|█████▍    | 27/50 [00:02<00:01, 13.11it/s]\nDiffusion Sampling::  58%|█████▊    | 29/50 [00:02<00:01, 13.11it/s]\nDiffusion Sampling::  62%|██████▏   | 31/50 [00:02<00:01, 13.09it/s]\nDiffusion Sampling::  66%|██████▌   | 33/50 [00:02<00:01, 13.10it/s]\nDiffusion Sampling::  70%|███████   | 35/50 [00:02<00:01, 13.11it/s]\nDiffusion Sampling::  74%|███████▍  | 37/50 [00:02<00:00, 13.11it/s]\nDiffusion Sampling::  78%|███████▊  | 39/50 [00:03<00:00, 13.10it/s]\nDiffusion Sampling::  82%|████████▏ | 41/50 [00:03<00:00, 13.11it/s]\nDiffusion Sampling::  86%|████████▌ | 43/50 [00:03<00:00, 13.11it/s]\nDiffusion Sampling::  90%|█████████ | 45/50 [00:03<00:00, 13.09it/s]\nDiffusion Sampling::  94%|█████████▍| 47/50 [00:03<00:00, 13.10it/s]\nDiffusion Sampling::  98%|█████████▊| 49/50 [00:03<00:00, 13.09it/s]\nDiffusion Sampling:: 100%|██████████| 50/50 [00:03<00:00, 12.98it/s]\n2025-06-21 14:44:29,999 - hy3dgen.shapgen - INFO - FlashVDMVolumeDecoding Resolution: [63, 126, 252, 504]\n\nFlashVDM Volume Decoding:   0%|          | 0/2 [00:00<?, ?it/s]\nFlashVDM Volume Decoding: 100%|██████████| 2/2 [00:00<00:00, 29.59it/s]\nDecimating mesh... Deleting 993434 faces\nDecimation done. Resulting mesh has 40000 faces",
  "metrics": {
    "predict_time": 37.718471538,
    "total_time": 139.133182
  },
  "output": {
    "mesh": "https://replicate.delivery/xezq/YBBMnm3RV7LRCx8hF6e57V0c1zJZfFjYPLzmK9eNyIwf2dkTB/mesh.glb"
  },
  "started_at": "2025-06-21T14:44:25.551711Z",
  "status": "succeeded",
  "urls": {
    "get": "https://api.replicate.com/v1/predictions/rn38psrv55rmc0cqjbrvkst8er",
    "cancel": "https://api.replicate.com/v1/predictions/rn38psrv55rmc0cqjbrvkst8er/cancel"
  },
  "version": "0602bae6db1ce420f2690339bf2feb47e18c0c722a1f02e9db9abd774abaff5d"
}

Generated in

37.7 seconds

Tweak it ShareReport

Diffusion Sampling::   0%|          | 0/50 [00:00<?, ?it/s]
Diffusion Sampling::   2%|▏         | 1/50 [00:00<00:08,  6.06it/s]
Diffusion Sampling::   6%|▌         | 3/50 [00:00<00:04, 10.66it/s]
Diffusion Sampling::  10%|█         | 5/50 [00:00<00:03, 13.09it/s]
Diffusion Sampling::  14%|█▍        | 7/50 [00:00<00:03, 13.17it/s]
Diffusion Sampling::  18%|█▊        | 9/50 [00:00<00:03, 13.18it/s]
Diffusion Sampling::  22%|██▏       | 11/50 [00:00<00:02, 13.18it/s]
Diffusion Sampling::  26%|██▌       | 13/50 [00:01<00:02, 13.18it/s]
Diffusion Sampling::  30%|███       | 15/50 [00:01<00:02, 13.16it/s]
Diffusion Sampling::  34%|███▍      | 17/50 [00:01<00:02, 13.16it/s]
Diffusion Sampling::  38%|███▊      | 19/50 [00:01<00:02, 13.15it/s]
Diffusion Sampling::  42%|████▏     | 21/50 [00:01<00:02, 13.13it/s]
Diffusion Sampling::  46%|████▌     | 23/50 [00:01<00:02, 13.13it/s]
Diffusion Sampling::  50%|█████     | 25/50 [00:01<00:01, 13.12it/s]
Diffusion Sampling::  54%|█████▍    | 27/50 [00:02<00:01, 13.11it/s]
Diffusion Sampling::  58%|█████▊    | 29/50 [00:02<00:01, 13.11it/s]
Diffusion Sampling::  62%|██████▏   | 31/50 [00:02<00:01, 13.09it/s]
Diffusion Sampling::  66%|██████▌   | 33/50 [00:02<00:01, 13.10it/s]
Diffusion Sampling::  70%|███████   | 35/50 [00:02<00:01, 13.11it/s]
Diffusion Sampling::  74%|███████▍  | 37/50 [00:02<00:00, 13.11it/s]
Diffusion Sampling::  78%|███████▊  | 39/50 [00:03<00:00, 13.10it/s]
Diffusion Sampling::  82%|████████▏ | 41/50 [00:03<00:00, 13.11it/s]
Diffusion Sampling::  86%|████████▌ | 43/50 [00:03<00:00, 13.11it/s]
Diffusion Sampling::  90%|█████████ | 45/50 [00:03<00:00, 13.09it/s]
Diffusion Sampling::  94%|█████████▍| 47/50 [00:03<00:00, 13.10it/s]
Diffusion Sampling::  98%|█████████▊| 49/50 [00:03<00:00, 13.09it/s]
Diffusion Sampling:: 100%|██████████| 50/50 [00:03<00:00, 12.98it/s]
2025-06-21 14:44:29,999 - hy3dgen.shapgen - INFO - FlashVDMVolumeDecoding Resolution: [63, 126, 252, 504]

FlashVDM Volume Decoding:   0%|          | 0/2 [00:00<?, ?it/s]
FlashVDM Volume Decoding: 100%|██████████| 2/2 [00:00<00:00, 29.59it/s]
Decimating mesh... Deleting 993434 faces
Decimation done. Resulting mesh has 40000 faces

Want to make some of these yourself?

Run this model