El modelador es una API.

REST

Un endpoint por acción.

Lista el catálogo con sus esquemas y luego llama a cualquier acción sobre la revisión que tienes. Concurrencia optimista en cada modificación: si alguien ha editado entretanto, se te avisa, no se sobrescribe.

• Tokens con permisos de lectura, escritura, IA y administración.
• Lote: hasta 100 comandos como una sola revisión y un solo paso de deshacer — todo o nada.
• Deltas: un cliente que ya tiene un modelo recibe el cambio, no el archivo.
• La cancelación llega hasta el proceso de geometría; no se confirma nada de una petición cancelada.

$KOZOROSA es la dirección de tu Foundry, o la dirección local que indica Kozorosa para Mac en Help → Connect an AI Agent.

# Everything the modeler can do, with its schema
curl -H "Authorization: Bearer $TOKEN" \
     $KOZOROSA/api/studio/actions

# One edit, on the revision you hold
curl -X POST $KOZOROSA/api/studio/actions/push_pull \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"model_id":"…","expected_revision":12,
       "args":{"target":"body1","face_id":"f7","distance":40}}'

# A hundred commands as one revision and one undo step
curl -X POST $KOZOROSA/api/studio/actions/batch …

Python

Bucles, aritmética y el modelo leído de vuelta.

La consola de Python asocia todo el catálogo a un solo nombre, cad. Un script se ejecuta en su propio proceso aislado; es una sola edición y un solo paso de deshacer, y un script que falla no cambia nada.

Ejecutar un script, paso a paso

n = params["cells"]
pitch = params["pitch"]
strut = params["strut"]

for i in range(n + 1):
    for j in range(n + 1):
        cad.create_box(width=strut, depth=strut,
                       height=n * pitch,
                       position=[i * pitch, j * pitch, 0])

print("struts:", len(cad.features))
result = {"struts": len(cad.features),
          "extent_mm": n * pitch}