CutOptim Engine API

Un’API per l’ottimizzazione del taglio: invia pezzi e materiale — pannelli 2D, barre 1D, legno o nesting true-shape di pezzi irregolari — e ricevi lo schema, il piano di taglio e l’utilizzo. Di default la stessa richiesta restituisce sempre lo stesso piano.

Guarda il benchmark completo → · Misurato, non dichiarato

{
  "parts": [
    { "name": "bracket", "polygon": […], "qty": 12, … },
    { "name": "gusset", "polygon": […], "qty": 14, … },
    { "name": "plate", "polygon": […], "holes": […], "qty": 12, … },
    { "name": "flange", "source": { … }, "qty": 10, … }
  ],
  "stock": [{ "w": 2500, "h": 1250, "exclusions": […], … }],
  "options": { "minSeparation": 5, "edgeClearance": 10 }
}

Perché svilupparci sopra

Scrivilo tu, oppure richiamalo

Un ottimizzatore di taglio sembra un progetto da weekend, poi diventa una lunga coda di casi limite: aritmetica di spessore lama e rifilo, stock che si esaurisce, regole di rotazione e venatura, layout che devono essere tagliabili bordo a bordo, poligoni con fori — e una suite di regressione che dimostri che una modifica non peggiora mai un piano. L’Engine API è questo lavoro, già fatto e misurato.

Guarda il benchmark completo →

Prezzi

Ogni richiesta conta allo stesso modo — nesting compreso · Ti scriviamo al 90% della quota e quando è esaurita.

Provala gratis: una chiave demo pubblica nel riferimento API e chiavi di test con 1,000 richieste al mese, mai fatturate

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 →

Abbonandoti accetti: Engine API Service Terms (in inglese).

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 →

Cosa entra, cosa esce

Un lavoro reale per ogni modalità: sopra il corpo della richiesta, sotto il piano restituito, disegnato direttamente dalla risposta.

{
  "parts": [
    { "name": "Side", "w": 720, "h": 560, "qty": 6 },
    { "name": "Bottom", "w": 764, "h": 560, "qty": 3 },
    { "name": "Top", "w": 764, "h": 560, "qty": 3 },
    { "name": "Shelf", "w": 762, "h": 520, "qty": 3 },
    { "name": "Rail", "w": 764, "h": 100, "qty": 6 },
    { "name": "Plinth", "w": 764, "h": 120, "qty": 6 },
    { "name": "Door", "w": 397, "h": 716, "qty": 6, "rotatable": false },
    { "name": "Drawer front", "w": 796, "h": 176, "qty": 3 }
  ],
  "stock": [
    { "w": 2800, "h": 2070, "qty": 5, "price": 38.5 }
  ],
  "options": { "kerf": 4, "trim": { "left": 10, "right": 10, "top": 10, "bottom": 10 } }
}

{
  "parts": [
    { "name": "Post", "length": 2400, "qty": 4 },
    { "name": "Rail", "length": 1750, "qty": 6 },
    { "name": "Brace", "length": 940, "qty": 8 },
    { "name": "Cross", "length": 620, "qty": 10 }
  ],
  "stock": [
    { "length": 6000, "qty": 10, "price": 24.9 }
  ],
  "options": { "kerf": 3, "trim": { "start": 10 } }
}

{
  "parts": [
    { "name": "Stud", "sw": 45, "sh": 95, "length": 2350, "qty": 6 },
    { "name": "Nogging", "sw": 45, "sh": 95, "length": 555, "qty": 12 },
    { "name": "Joist", "sw": 45, "sh": 145, "length": 3600, "qty": 3 },
    { "name": "Blocking", "sw": 45, "sh": 145, "length": 1150, "qty": 3 }
  ],
  "stock": [
    { "name": "C24 45x95", "sw": 45, "sh": 95, "length": 4800, "qty": 10, "price": 9.8 },
    { "name": "C24 45x145", "sw": 45, "sh": 145, "length": 4800, "qty": 6, "price": 14.6 }
  ],
  "options": { "kerf": 3 }
}

{
  "parts": [
    { "name": "bracket", "polygon": [[0,0], [300,0], [300,100], [100,100], [100,300], [0,300]], "qty": 12, "allowedRotations": [0,90,180,270] },
    { "name": "gusset", "polygon": [[0,0], [250,0], [0,250]], "qty": 14, "allowedRotations": [0,90,180,270] },
    { "name": "plate", "polygon": [[0,0], [240,0], [240,160], [0,160]], "holes": [[[60,65], [180,65], [180,95], [60,95]]], "qty": 12, "allowedRotations": [0,90] },
    { "name": "flange", "source": { "content": "<svg xmlns=\"http://www.w3.org/2000/svg\"><circle cx=\"90\" cy=\"90\" r=\"90\"/><circle cx=\"90\" cy=\"90\" r=\"32\"/><circle cx=\"90\" cy=\"30\" r=\"9\"/><circle cx=\"150\" cy=\"90\" r=\"9\"/><circle cx=\"90\" cy=\"150\" r=\"9\"/><circle cx=\"30\" cy=\"90\" r=\"9\"/></svg>", "filename": "flange.svg" }, "qty": 10, "allowedRotations": [0] }
  ],
  "stock": [
    { "w": 2500, "h": 1250, "qty": 3, "price": 96, "exclusions": [{ "polygon": [[1150,0], [1350,0], [1350,70], [1150,70]], "quality": 0 }] }
  ],
  "options": { "minSeparation": 5, "edgeClearance": 10 }
}

Cosa fa l’API

Due velocità: preventiva subito, risparmia materiale dopo

La maggior parte delle integrazioni ha bisogno di entrambe — una risposta mentre il cliente aspetta, e un piano più stretto quando il lavoro va in macchina. Scegli chiamata per chiamata.

La risposta ha la stessa struttura in entrambi i casi. Sul 2D il motore max accetta un insieme di opzioni più ristretto rispetto a heuristic (il riferimento le elenca), e un lavoro di nesting con zone di esclusione è comunque servito da lbf.

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 è solo 2D; il motore asincrono max serve i pannelli 2D e il nesting true-shape; e il predefinito del nesting è il 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 — Il livello asincrono: invii il lavoro e interroghi GET /v1/jobs/{id} per il risultato. Sul 2D è una ricerca ad albero che raggiunge l’ottimo dimostrato su molti più lavori, con qualche secondo fino a un minuto per risoluzione — sempre deterministico e tagliabile su sega. Sul nesting true-shape esegue prima lbf, poi impiega un budget di tempo cercando uno schema con meno pannelli e non ne restituisce mai di più; quella ricerca è limitata nel tempo, quindi i suoi nest dichiarano deterministic: false.
• lbf — Il predefinito per il nesting true-shape. Incastra poligoni irregolari nelle rientranze gli uni degli altri per laser, plasma e getto d’acqua — istantaneamente e in modo deterministico. max (sopra) può poi cercare lo stesso lavoro per meno pannelli.

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 i motori:Riferimento API → · Guida all'integrazione →

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.

Soluzioni per settore

Lo stesso motore, presentato secondo il modo di tagliare di ogni settore. Ogni pagina mostra l’endpoint, una richiesta e una risposta, e i campi che contano per quel materiale.

Il motore lavora sulla geometria, non su un catalogo di materiali: lamiera e lastre metalliche, pannelli a base legno, vetro, plastica e acrilico, compositi, schiuma, cartone e carta passano tutti attraverso gli stessi endpoint. Il materiale cambia solo i numeri che invii — spessore lama o distanza tra pezzi, margine dal bordo, dimensioni dello stock.