Hunyuan 3D v2

https://mcp.app.layer.ai/mcp

execute_forge({
  "base_model_id": "hunyuan-3d-v2",
  "prompt": "A wooden treasure chest with iron bands, game-ready",
  "batch_size": 1
})

# Start the generation — returns an inference id straight away.
curl -X POST https://api.app.layer.ai/api/v2/workspaces/$WORKSPACE_ID/base-models/tencent-hunyuan3d-v2/inferences \
  -H "Authorization: Bearer $LAYER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
        "guidance_file_init_image": [
          {
            "url": "https://example.com/input.png"
          }
        ]
      }'

# Poll until status is "complete" — the response then carries the asset URLs.
curl https://api.app.layer.ai/api/v2/workspaces/$WORKSPACE_ID/inferences/$INFERENCE_ID \
  -H "Authorization: Bearer $LAYER_TOKEN"

seed

integer

The starting point for the model's randomness. The same seed and settings give the same result.

guidance_scale

numberdefault 7.50–20

How closely the result follows the prompt. Lower gives the model more freedom.

inference_steps

integerdefault 501–50

How many refinement passes the model makes. More add detail and take longer.

include_textures

booleandefault true

Paint colour onto the mesh. Off returns bare geometry.

guidance_file_init_image

file[]required

The image the 3D model is built from