Hi3D

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

execute_forge({
  "base_model_id": "hi-3d",
  "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/hitem3d-hi3d/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"

face_limit

integerdefault 100000100000–2000000

The maximum number of faces in the output mesh.

include_textures

booleandefault true

Paint colour onto the mesh. Off returns bare geometry.

pbr_materials

booleandefault false

Add metalness, roughness and normal maps so the model reacts to light in a game engine.

guidance_file_init_image

file[]required

Add each image to the view it shows. Any images need a front view