API docs / 3D models
hunyuan3d-2mv API
Generates 3D assets from multiple view images with multiview controlled shape generation. Takes front, back, left, and right view images as input and produces textured 3D models in GLB, OBJ, PLY, or STL format. Finetuned from Hunyuan3D-2 specifically to support multiview-controlled 3D generation, allowing precise control over the generated 3D shape through multiple perspective images. Includes automatic background removal and mesh simplification options for optimized 3D models.
- Model id
tencent/hunyuan3d-2mv- Provider
- tencent
- Output
- 3D
- Price
- From 42 credits per run, the same as on voor.ai. Options such as length or resolution can change it.
Request
POST https://voor.ai/v1/generations with "model": "tencent/hunyuan3d-2mv". Poll GET /v1/tasks/{id} or receive the signed webhook. See the overview for keys, idempotency, webhooks and errors.
curl https://voor.ai/v1/generations \
-H "Authorization: Bearer $VOOR_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"model": "tencent/hunyuan3d-2mv",
"input": {
"front_image": [
"https://example.com/input.png"
]
},
"callback_url": "https://example.com/webhooks/voor"
}'
# Then poll the task (or wait for the webhook):
curl https://voor.ai/v1/tasks/TASK_ID \
-H "Authorization: Bearer $VOOR_API_KEY"Input parameters
| Name | Type | Details |
|---|---|---|
seed | number | Random seed Default: |
guidance | number | Guidance scale Default: |
steps | number | Number of inference steps Default: Min 1 · Max 100 |
output_format | string | Default: One of: glb, obj, ply, stl |
back_image | array of URLs | Back view image Up to 1 files · Accepts image/* |
front_imagerequired | array of URLs | Front view image Up to 1 files · Accepts image/* |
left_image | array of URLs | Left view image Up to 1 files · Accepts image/* |
num_chunks | number | Number of chunks Default: Min 1000 · Max 5000000 |
octree_resolution | number | Octree resolution Default: Min 16 · Max 512 |
randomize_seed | boolean | Randomize seed Default: |
remove_background | boolean | Remove image background Default: |
right_image | array of URLs | Right view image Up to 1 files · Accepts image/* |
target_face_num | number | Target number of faces for mesh simplification Default: Min 100 · Max 1000000 |