Quickstart

Choose a useful reference

Use one clear image with the subject fully visible. A three-quarter view works best because it reveals depth, side profiles and attachment points.

Avoid motion blur, heavy occlusion and images where the object occupies less than half the frame. PhotoTo3D reports uncertainty instead of inventing details that the image cannot show.

Create the build

Open Studio and drop in a PNG, JPEG or WebP up to 15 MB. The image probe measures dimensions, aspect ratio and palette before creating a quality contract.

Review the detected geometry and target score. The browser preview is interactive — drag to orbit and use the wheel to zoom.

pnpm add three
# Download the generated factory from Studio
cp ~/Downloads/create-object-model.ts ./src/models/

Use the factory

Import the generated function anywhere you create your Three.js scene. The returned Group contains named nodes and a sculptRuntime contract for interaction.

import { createObjectModel } from './models/create-object-model';

const object = createObjectModel();
scene.add(object);
object.userData.sculptRuntime.nodes.body.rotation.y = 0.4;