> For the complete documentation index, see [llms.txt](https://docs.projectsim.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.projectsim.ai/creating-assets/choosing-an-endpoint/worked-use-cases.md). # Example use cases Choose a scenario below, then follow its creation guide for supported inputs, parameters, and Python and cURL examples. For the shared polling and download workflow, see the [Quickstart](/getting-started/quickstart.md). ## A SKU at measured scale You are testing grasping and contact with a particular SKU and need its geometry at measured scale. Choose **Measured** and record a continuous video orbiting the SKU beside a printed ChArUco board. Submit **one reference image** in `inputs.images` for reconstruction and **one video capture** in `inputs.capture` for scale measurement. Both are required. Follow the [capture instructions](/creating-assets/assets-measured/measured-capture.md) before sending the request. {% embed url="" %} Left: phone motion around the object and ChArUco board. Right: the corresponding camera footage. {% endembed %} [Create a Measured asset →](/creating-assets/assets-measured.md) ## Damaged parcels for perception You need parcel variants with creases, crushed corners, and different surface wear to evaluate recognition or grasp planning under packaging damage. Choose **High-fidelity** because the variation includes detailed surface changes and irregular silhouettes. Provide one parcel reference image in `seed.images` and use `seed.text` to describe the desired damage or wear. Choose `variation_type: general` when the silhouette should change, or `texture` for surface-only changes. Set `params.physics.body` to `rigid` for fixed damaged shapes; visible damage does not require a deformable body. Example `seed.text` with `variation_type: general` and `body: rigid`: > Vary the single cardboard parcel in the reference with lightly dented corners, shallow wall creases, and modest differences in rectangular proportions. Keep it recognisable as one closed shipping box. Use a reference showing one parcel clearly. If the image contains several boxes, crop or replace it before submitting; a prompt cannot guarantee that separate objects will be reconstructed separately.

High-fidelity parcels with creased surfaces, crushed corners, and different packaging details — High-fidelity: vary wear and damage, including changes to the object silhouette.

[Create a High-fidelity variation set →](/creating-assets/high-fidelity-variation-set.md) ## Visually varied strawberries You need strawberry assets spanning ripeness, surface damage, and decay for robotic perception or produce sorting. Choose **High-fidelity** for organic geometry and detailed appearance variation. Provide a photo of one strawberry in `seed.images`. Use `seed.text` to describe the desired condition, and `params.variation` to steer the type and strength of variation. Choose `general` for shape and appearance changes or `texture` for surface-only changes. Set `params.physics.body` to `rigid` for perception with fixed shapes, or `deformable` when the simulation requires deformation. Example `seed.text` with `variation_type: general` and `body: rigid`: > Vary the single strawberry in the reference across pale, ripe red, and slightly overripe appearances, with modest changes in its plumpness and surface bruising. Keep each variant recognisable as one strawberry.

High-fidelity strawberries with differences in ripeness, surface damage, and decay — High-fidelity: vary organic shape and appearance, including ripeness and decay.

Generate object variants for visual domain randomization from an image, text, or both, with optional variation references. [Create a High-fidelity variation set →](/creating-assets/high-fidelity-variation-set.md) ## Box variations for warehouse manipulation You need a family of shipping boxes to evaluate picking, packing, or stacking across different object sizes and proportions. Use **Procedural**: boxes have simple geometric construction, so one procedural class can generate related variants at scale. Describe one box family in the required `seed.text` brief, optionally adding one reference image in `seed.images`. Set `params.physics.body` to `rigid` and `params.physics.articulated` to `false`. Use the brief to guide proportions, handles, and construction; it does not specify exact dimension values. Example `seed.text` for these jointless boxes (`articulated: false`): > One closed corrugated cardboard shipping box with a taped, sealed top and bottom. Vary its width, depth, height, and cardboard colour within ordinary parcel proportions. All panels are fixed; no moving parts. If the task requires opening the box, switch to `articulated: true` and use the [four-flap opening-box prompt](/creating-assets/procedural-variation-set.md#example-procedural-prompts). Do not combine an opening request with “no moving parts.”

Procedural shipping boxes with different proportions, handles, and surface finishes — Procedural: vary proportions and construction within a geometric object family.

[Procedural variation set](/creating-assets/procedural-variation-set.md) ## Articulated roll cages You are developing a manipulation policy that opens a roll-cage gate or interacts with movable panels. Use **Procedural** for articulation and variations in cage height, panel layout, and mechanical configuration. Set `params.physics.body` to `rigid` and `params.physics.articulated` to `true`. Describe the cage and which parts should move in `seed.text`, with an optional reference image. Example `seed.text` (`articulated: true`): > One warehouse roll cage with a rectangular base, three fixed mesh sides, and one front mesh gate. The gate swings outward around a vertical hinge on its left edge and starts closed. Keep its handle attached to the gate. Vary cage height, width, and mesh spacing.

Procedural roll cages with different heights, panel layouts, and opening gates — Procedural: vary configurations and include articulated parts, such as opening gates.

[Procedural variation set](/creating-assets/procedural-variation-set.md) ## Articulated desks with drawers You need 20 related desks with sliding drawers for drawer-opening and manipulation tasks. Use Procedural: the pipeline generates one object class and samples variants from it. This is a geometric object family, and articulation is supported here. Set `params.physics.body: rigid` and `params.physics.articulated: true`; the text describes the intended construction rather than specifying exact joint or dimension values. Example `seed.text` (`articulated: true`): > One freestanding desk with a fixed worktop, supporting legs, and drawers beneath the worktop. Each drawer slides outward horizontally and starts closed. Handles move with their drawers. Vary the desk proportions, drawer configuration, handle shape, and wood finish.

Ten articulated desk variants with different dimensions, materials, and drawer configurations, including open drawers — Articulated desk variants for drawer-opening and manipulation tasks.

[Procedural variation set](/creating-assets/procedural-variation-set.md)