CutOptim Engine API

Un motore di ottimizzazione del taglio deterministico, richiamabile via HTTP: la stessa richiesta restituisce sempre lo stesso piano di taglio — così puoi verificarlo, usarlo per preventivare, dirimere una contestazione e rieseguire l’ordine dell’anno scorso per ottenere il piano dell’anno scorso. È lo stesso motore che alimenta CutOptim, con le sue tre modalità rettangolari (pannelli 2D, 1D lineare e legno con abbinamento della sezione), più il nesting true-shape per pezzi a poligono irregolare — POST /v1/optimize/nest, per lavorazioni a laser, plasma e getto d’acqua. Invia pezzi e materiale e ottieni in risposta lo schema completo, il piano di taglio e l’utilizzo — pronti da integrare in un ERP, in uno strumento di preventivazione o nel software della macchina stessa.

Guarda il benchmark completo → · Misurato, non dichiarato

Perché svilupparci sopra

Cosa fa l’API

Quale motore serve quale modalità

L’endpoint su cui fai POST sceglie la modalità; il parametro engine sceglie l’algoritmo. Il motore heuristic predefinito serve 2D, 1D e legno; balanced e il motore asincrono max sono solo 2D; e il nesting true-shape gira sul proprio motore lbf. Lo stesso motore dell’app, via HTTP.

• heuristic — Il predefinito — un packer guillotine multi-strategia. Resa massima, ogni layout è tagliabile su sega e restituisce sempre un piano di taglio. Serve 2D, 1D e legno.
• balanced — Un free-nester MaxRects opt-in per il 2D. Molto più veloce sui lavori molto grandi a fronte di una resa leggermente inferiore, ma i suoi layout spesso non possono essere segati da bordo a bordo, quindi non trasportano un piano di taglio.
• max — Una ricerca ad albero asincrona per il 2D. Raggiunge l’ottimo dimostrato su molti più lavori, con qualche secondo fino a un minuto per risoluzione — invii il lavoro e interroghi GET /v1/jobs/{id} per il risultato. Sempre deterministico e tagliabile su sega.
• lbf — Il motore di nesting true-shape. Incastra poligoni irregolari nelle rientranze gli uni degli altri per laser, plasma e getto d’acqua; è pianificata una build sparrow a densità più alta.

Quale endpoint per quale materiale: lastre piane — compensato, MDF, vetro, acrilico, lamiera — vanno a /v1/optimize/2d; barre, tubi, tubolari e profili a /v1/optimize/1d; legno strutturale (un 50×150 solo da un 50×150) a /v1/optimize/wood; poligoni irregolari per laser, plasma e getto d’acqua a /v1/optimize/nest.

Una chiamata, un piano completo

curl https://api.cutoptim.com/v1/optimize/2d \
  -H "Authorization: Bearer co_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "parts": [
      { "name": "Door",    "w": 600, "h": 400, "qty": 4 },
      { "name": "Shelf",   "w": 800, "h": 300, "qty": 6 }
    ],
    "stock":   [{ "w": 2440, "h": 1220, "price": 42 }],
    "options": { "kerf": 3, "effort": "balanced" },
    "engine":  "heuristic"
  }'

Torna così:

{
  "metrics": { "sheetCount": 1, "yieldPct": 80.62, "placed": 10, "total": 10,
               "cutLines": 10, "sawPasses": 13, "cutLength": 10720, "totalPrice": 42 },
  "sheets":  [ … ],
  "cutPlan": [{ "sheet": 0, "step": 1, "axis": "h", "pos": 400, "length": 2440, "stage": 1 }, … ],
  "guillotineValid": true,
  "engineVersion": "1.0.0+10e0c941",
  "deterministic": true
}

Struttura completa di richiesta e risposta, tutte le opzioni, tutti i codici di errore e tutti e tre i motori:Riferimento API →

Fast o denso? Scegli con un'unica opzione

L'opzione effort bilancia il tempo di calcolo con l'utilizzo. Ecco questo compromesso, misurato su un lavoro impegnativo — ogni cifra proviene dal packer reale.

Ed è comunque veloce: anche i lavori di produzione più grandi — 2.000 pezzi e oltre — si risolvono in pochi secondi con il motore predefinito, ben entro il budget di tempo dell'API.

Prezzi

Volumi maggiori. 10,000 richieste al mese sono il piano standard, non il limite di ciò che possiamo far girare. Se ti serve di più — un volume più alto, chiavi separate per staging e produzione, o un accordo dedicato — dicci i tuoi numeri e lo quotiamo individualmente. Dicci il tuo volume →

I normali piani CutOptim (Gratuito / Pro / Officina) non hanno alcun legame con l’API — l’ottimizzatore integrato nell’app resta incluso in essi. Vedi i prezzi dell’app →

Solutions by industry

The same engine, positioned for the way one trade cuts. Each page shows the endpoint, a request and a response, and the fields that matter for that material.