Browse all documentation

MODEL GUIDES

Optimization

Use task_type optimize to find layout issues, collisions, support risks, clearance problems, and suggested improvements. Product surfaces such as Four Cad can use this task after converting CAD geometry into structured spatial input.

What it answers

What is wrong with this layout, and what would improve it?

task_type: optimize

What to send

input.cad_sceneobject

The layout or assembly to review.

input.goalobject

Optional. What to optimize for: clearance, packing, access.

Every field on the request schema is still accepted; these are the ones this task depends on.

What comes back

spatial_optimization.issues

Collisions, clearance, and support problems.

spatial_optimization.suggestions

Proposed changes, each tied to geometry.

spatial_optimization.severity

Ranking so review time goes to what matters.

Example

Terminal
$ curl https://fourechelon.com/api/v1/responses \
-H "Authorization: Bearer $FOUR_ECHELON_API_KEY" \
-H "Content-Type: application/json" \
-d '{
$ "model": "rowe-1.0",
$ "input": {
$ "task_type": "optimize",
$ "goal": { "objective": "clearance" },
$ "cad_scene": { "schema": "four-cad.cad_scene.v1", "solids": [] }
$ }
$ }'

Worth knowing

Findings reference the entities they came from, so every suggestion can be traced back to the geometry rather than taken on trust.