O modelador é uma API.

REST

Um endpoint por ação.

Liste o catálogo com seus esquemas e depois chame qualquer ação sobre a revisão que você tem. Concorrência otimista em cada mutação: se alguém editou nesse meio-tempo, você é avisado, não sobrescrito.

• Tokens com escopo para leitura, escrita, IA e administração.
• Lote: até 100 comandos como uma só revisão e uma só etapa de desfazer — tudo ou nada.
• Deltas: um cliente que tem um modelo recebe a alteração, não o arquivo.
• O cancelamento chega ao worker de geometria; nada é confirmado para uma requisição cancelada.

$KOZOROSA é o endereço do seu Foundry, ou o endereço local que o Kozorosa para Mac informa em 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

Laços, aritmética e a releitura do modelo.

O console Python vincula o catálogo inteiro a um único nome, cad. Um script roda em um processo isolado próprio; ele é uma edição e uma etapa de desfazer, e um script que falha não altera nada.

Execute um script, passo a passo

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}