Skip to content

Parameters

Every design Prompt2CAD produces ships with a set of parameters — adjustable knobs the agent declares as it writes the geometry. They show up in the bottom-right panel of the viewport and let you re-shape the model without spending credits.

Three kinds of parameter

TypeLooks likeExample
NumberSlider with min / max / stepwidth: 0.8 → 2.2 m, step 0.05
EnumButton groupfinish: matte-white / black-brown / white-oak
BooleanSwitchback_panel: on / off

Numbers can carry a unit. The most common is length (meters internally, displayed in your unit system). Others are angle (radians under the hood, displayed in degrees), count (integers like shelf count or drawer count), and none (unitless ratios).

Why parameters matter

Parameters are free in two senses:

  • No credits — dragging a slider re-executes the geometry code in your browser; no API call.
  • No latency — the model re-renders on the next frame.

That makes parameters the cheapest iteration loop in the app. The pattern most users settle into:

  1. Get a roughly-right model from the first generation (30 credits).
  2. Sweep the sliders to fine-tune dimensions and try variants.
  3. Only use chat follow-ups for changes a slider cannot express.

Practical examples

Dimensions

width, height, depth, length, diameter. Drag to fit a real-world spot — an alcove, a corner, the gap between two walls.

Counts

shelf_count, drawer_count, door_count, rows, cols. Step is usually 1. Adding a shelf does not require chat — the slider re-divides the carcass.

Angles

door_angle, lid_angle, recline_angle. Useful for visualising the model in its "open" state for a renderer or a client preview.

Enums

finish, style, sink_style, hardware. Listed as a button row. Picking a different finish swaps the material palette and re-textures the whole piece.

Booleans

with_plinth, with_back_panel, glass_doors. A switch in the panel. Toggling rebuilds the relevant section.

What if the parameter I need doesn't exist?

Ask. The agent can add a parameter at any point — "add a slider for the toe-kick height" — and it will show up in the panel within one iteration. Costs 15 credits.

If a parameter exists but its range is too narrow ("the width only goes to 1.4 m, I need 1.8"), you can tell the agent to widen the range. That is also an iteration.

The agent declares ranges deliberately

Parameter ranges (min, max, step) are picked to keep the geometry sensible. A bookshelf width slider that allows 0.05 m would let you collapse the carcass into a flat plane. Override them carefully — sometimes "too narrow" really is "the agent thinks anything outside that range looks bad."

Edge cases

  • Slider value out of range — values are clamped. A bug in the geometry code that wrote width = 999 would still render at width.max.
  • A slider drag breaks the model — rare, but possible if the geometry code makes an assumption that fails at the extreme. The red error banner at the top of the viewport shows what went wrong; drag back, or ask the agent for a fix.
  • A parameter you don't see anywhere — the agent declared it but no primitive uses it. Harmless, but you can ask for a clean-up.

Persistence

Parameter values are persisted with the project. Closing the tab and re-opening the project restores every slider to where you left it. Exports use the current parameter values — so if you have a width slider at 1.6 m, your STEP file will be 1.6 m wide.

Next: Sections — the one piece of model vocabulary worth knowing.

Docs for Prompt2CAD — derived from the source code at the commit that built them.