CutOptim Engine API
Deterministički motor za optimizaciju rezanja, pozivljiv putem HTTP-a: isti zahtjev uvijek vraća isti plan rezanja — pa ga možete revidirati, iz njega izraditi ponudu, njime riješiti spor i ponovno pokrenuti prošlogodišnju narudžbu da dobijete prošlogodišnji plan. Isti je motor koji pokreće CutOptim, kroz tri pravokutna načina rada (2D ploče, 1D linearno i drvo s usklađivanjem poprečnog presjeka), uz true-shape ugnježđivanje za nepravilne poligonske dijelove — POST /v1/optimize/nest, za rad laserom, plazmom i vodenim mlazom. Pošaljite dijelove i zalihu, dobijte natrag potpuni raspored, plan rezanja i iskoristivost — spremno za ugradnju u ERP, alat za ponude ili vlastiti softver stroja.
Pogledaj cijelo mjerilo → · Izmjereno, ne tvrđeno
Zašto graditi na tome
Isti ulaz uvijek vraća isti izlaz — bez slučajnosti, bez sata u algoritmu. Rezultate možete predmemorirati i uspoređivati u testovima.
Ne samo pravokutnici: giljotinski slijed rezanja, linije reza naspram prolaza pile, ispiljena duljina i oznaka koja vam govori može li se izraditi na pili za ploče.
Širina reza, obrez po strani, tolerancija, način troška, grupe žice, maksimalne faze rezanja, minimiziranje rotacija — iste opcije koje nudi i aplikacija.
Što API radi
Po jedan poziv za 2D ploče, 1D linearni materijal, drvo s podudaranjem presjeka i true-shape ugnježđivanje nepravilnih poligona — POST /v1/optimize/2d, /1d, /wood i /nest.
POST /v1/optimize/nest pakira proizvoljne poligone (s rupama) na fiksne ploče, uklapajući dijelove jedne u konkavne džepove drugih — 6 ploča ondje gdje isti dijelovi prema graničnom okviru trebaju 9. Za laser, plazmu i vodeni mlaz. Uz to dolaze i zone isključenja po ploči (defekt, stezaljka).
Označite dijelove i zalihu s material oznakom i optimizator dijeli posao: svaki material reže se samo iz vlastite zalihe. Na svakom načinu rada; vraća se sažetak po material.
Imenujte vrstu ruba po bridu (2D) i odgovor zbraja tekuće metre po vrsti — po dijelu i po narudžbi. Metapodatak: nikada ne pomiče dio.
Zatražite include:["svg","csv","dxf"] i odgovor nosi raspored kao gotovu datoteku, ugrađenu — samostalni 2D SVG crtež, R12/AC1009 DXF ili CSV popis rezanja. Bez pohrane, bez drugog poziva.
Priložite meta objekt — broj artikla iz vašeg ERP-a, id retka narudžbe, referencu kupca — bilo kojem retku dijela ili zalihe i vraća se doslovno na svakom postavljenom komadu i svakoj ploči/šipki, pa se plan usklađuje s vašim sustavom.
POST /v1/validate/{2d,1d,wood} shema-validira isto tijelo bez rješavanja — bez ključa, bez kvote. Provjerite da payload neće biti odbijen i dobijte upozorenja o izvedivosti prije nego što potrošite poziv.
minimizeCost rangira prema najnižem ukupnom računu među zalihama s cijenom, miješajući formate; zadano se minimizira materijal. Oba izvode isti guillotine algoritam.
Označite zalihu koju treba prvo potrošiti, tretirajte količine kao čvrsto ograničenje uz respectStock i označite dijelove koji se obavezno režu i osvajaju mjesto na ploči kad materijala nedostaje.
Ne samo pravokutnici: giljotinski slijed rezanja s pozicijama graničnika po koraku, linije reza naspram prolaza pile, ispiljena duljina i oznaka izradivosti na pili za ploče.
kerf, obrez po strani, tolerancija, grain groups, maxCutStages i minimiziranje rotacija — iste opcije koje nudi aplikacija.
Isti ulaz uvijek vraća isti izlaz — predmemorirajte ga i usporedite. Učvrstiva verzija motora i OpenAPI 3.1 dokument opisuju cijeli ugovor.
Pošaljite SVG ili DXF umjesto koordinata: parts[].source čita obris i njegove rupe iz crteža, a POST /v1/import/nest prvo razdvaja datoteku s više dijelova. Ništa se ne pohranjuje — datoteka se obrađuje u memoriji i nestaje s odgovorom.
Koji motor pokriva koji način rada
Krajnja točka na koju šaljete POST bira način rada; parametar engine bira algoritam. Zadani heuristic motor pokriva 2D, 1D i drvo; balanced i asinkroni max motor rade samo za 2D; a true-shape ugnježđivanje radi na vlastitom lbf motoru. Isti motor kao aplikacija, preko HTTP-a.
- heuristic — Zadano — giljotinski višestrateški paker. Najveći iskoristak, svaki raspored može se rezati pilom i uvijek vraća plan rezanja. Pokriva 2D, 1D i drvo.
- balanced — MaxRects slobodni nester za 2D na zahtjev. Znatno brži na vrlo velikim poslovima uz malo manji iskoristak, no njegovi rasporedi često se ne mogu rezati pilom od ruba do ruba, pa ne nose plan rezanja.
- max — Asinkrona pretraga stabla za 2D. Doseže dokazani optimum na mnogo više poslova, uz nekoliko sekundi do minute po rješavanju — pošaljete posao i pozivom GET /v1/jobs/{id} dohvaćate rezultat. I dalje determinističko i može se rezati pilom.
- lbf — Motor za true-shape ugnježđivanje. Pakira nepravilne poligone u međusobne džepove za laser, plazmu i vodeni mlaz; planira se sparrow verzija veće gustoće.
Koja krajnja točka za koji materijal: ravne ploče — šperploča, MDF, staklo, akril, lim — idu na /v1/optimize/2d; šipke, cijevi i profili na /v1/optimize/1d; konstrukcijsko drvo (50×150 samo iz 50×150) na /v1/optimize/wood; nepravilni poligoni za laser, plazmu i vodeni mlaz na /v1/optimize/nest.
Jedan poziv, potpuni plan
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"
}'Vraća se kao:
{
"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
}Potpuna struktura zahtjeva i odgovora, sve opcije, svi kodovi grešaka i sva tri motora:API referenca →
Fast ili gusto? Odaberite jednom opcijom
Opcija effort odmjerava vrijeme izračuna naspram iskoristivosti. Evo tog kompromisa, izmjerenog na jednom zahtjevnom zadatku — svaka brojka dolazi iz stvarnog packera.
I ionako je brzo: čak i najveći proizvodni poslovi — 2.000 dijelova i više — rješavaju se u nekoliko sekundi na zadanom motoru, ugodno unutar vremenskog proračuna API-ja.
Cijene
Veći volumeni. 10,000 zahtjeva mjesečno standardni je plan, a ne gornja granica onoga što možemo pokrenuti. Ako trebate više — veći volumen, odvojene ključeve za staging i produkciju ili namjensko rješenje — recite nam svoje brojke i cijenu određujemo pojedinačno. Recite nam svoj volumen →
Uobičajeni CutOptim planovi (Besplatno / Pro / Radionica) nisu povezani s API-jem — optimizator u aplikaciji ostaje u njima uključen. Pogledajte cijene aplikacije →
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.
1D cut-to-length for tube, pipe and hollow section. POST /v1/optimize/1d
1D cut-to-length for steel and aluminium profile, bar and section, with cost mode. POST /v1/optimize/1d
2D guillotine, zero-kerf score-and-snap for float, tempered and mirror glass. POST /v1/optimize/2d
1D cut-to-length for structural timber with cross-section matching. POST /v1/optimize/wood
True-shape nesting of irregular polygons, with exclusion zones. POST /v1/optimize/nest
True-shape nesting onto plate for laser, plasma or waterjet. POST /v1/optimize/nest
Bar bending schedule optimization for reinforcement steel. · design partners wanted
The why, what and how of the CutOptim Engine API on two pages — the three modes, a request and response, determinism and pricing. Print-ready, with a QR back to this page.