CutOptim Engine API

API pro optimalizaci řezání: pošlete díly a materiál — 2D desky, 1D tyče, dřevo nebo nesting nepravidelných dílů podle skutečného tvaru — a zpátky dostanete rozvržení, plán řezání a využití. Ve výchozím nastavení vrací stejný požadavek vždy stejný plán.

Zobrazit celý benchmark → · Naměřeno, ne tvrzeno

{
  "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 }
}

Proč na tom stavět

Napsat, nebo zavolat

Vlastní optimalizátor řezání vypadá jako projekt na víkend, ale promění se v dlouhý ocas okrajových případů: výpočty šířky řezu a ořezu, docházející zásoba, pravidla otáčení a vzoru dřeva, rozvržení, která musí jít rozřezat od kraje ke kraji, polygony s otvory — a sada regresních testů, která dokazuje, že žádná změna plán nezhorší. Engine API je přesně tato práce, už hotová a změřená.

Zobrazit celý benchmark →

Ceník

Každý požadavek se počítá stejně — nesting včetně · Při 90 % kvóty a po jejím vyčerpání vám pošleme e-mail.

Vyzkoušejte zdarma: veřejný demo klíč v referenci API a testovací klíče s 1,000 požadavky měsíčně, které se nikdy neúčtují

Větší objemy. 10,000 požadavků za měsíc je standardní tarif, ne strop toho, co dokážeme provozovat. Pokud potřebujete více — vyšší objem, oddělené klíče pro staging a produkci nebo individuální řešení — napište nám svá čísla a naceníme to individuálně. Napište nám svůj objem →

Předplatným přijímáte: Engine API Service Terms (anglicky).

Běžné tarify CutOptim (Zdarma / Pro / Dílna) s API nijak nesouvisejí — optimalizátor v aplikaci v nich zůstává zahrnutý. Ceník aplikace →

Co jde dovnitř, co vyjde ven

Jedna skutečná zakázka na každý režim: nahoře tělo požadavku, pod ním vrácený plán nakreslený přímo z odpovědi.

{
  "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 }
}

Co API dělá

Dvě rychlosti: nabídka hned, úspora materiálu později

Většina integrací potřebuje obojí — odpověď, zatímco zákazník čeká, a přesnější plán, když úloha jde na stroj. Vybíráte si u každého volání.

Odpověď má v obou případech stejnou podobu. U 2D přijímá engine max užší sadu voleb než heuristic (reference je vyjmenovává) a úlohu nestingu s vyloučenými zónami stále obsluhuje lbf.

Který engine obsluhuje který režim

Endpoint, na který posíláte POST, určuje režim; parametr engine určuje algoritmus. Výchozí engine heuristic obsluhuje 2D, 1D i dřevo; balanced je pouze pro 2D; asynchronní engine max obsluhuje 2D desky i nesting podle skutečného tvaru; a výchozím enginem nestingu je jeho vlastní lbf. Stejný engine jako v aplikaci, přes HTTP.

• heuristic — Výchozí — gilotinový packer s více strategiemi. Nejvyšší výtěžnost, každé rozvržení je řezatelné na pile a vždy vrací plán řezání. Obsluhuje 2D, 1D i dřevo.
• balanced — Volitelný MaxRects free-nester pro 2D. U velmi velkých úloh výrazně rychlejší za mírně nižší výtěžnost, jeho rozvržení však často nelze rozřezat od kraje ke kraji, takže neobsahují plán řezání.
• max — Asynchronní vrstva: úlohu odešlete a výsledek získáte dotazováním GET /v1/jobs/{id}. U 2D je to stromové prohledávání, které dosahuje prokazatelného optima u mnohem více úloh, za několik sekund až minutu na výpočet — stále deterministické a řezatelné na pile. U nestingu podle skutečného tvaru nejdřív spustí lbf, pak stráví časový rozpočet hledáním rozvržení s menším počtem desek a nikdy nevrátí víc; toto hledání je časově omezené, takže jeho nesty hlásí deterministic: false.
• lbf — Výchozí engine nestingu podle skutečného tvaru. Zaklesává nepravidelné polygony do vzájemných kapes pro laser, plazmu a vodní paprsek — okamžitě a deterministicky. max (výše) může pak stejnou úlohu prohledat kvůli menšímu počtu desek.

Který endpoint pro který materiál: ploché desky — překližka, MDF, sklo, akrylát, plech — jdou na /v1/optimize/2d; tyče, trubky, roury a profily na /v1/optimize/1d; konstrukční dřevo (50×150 jen z 50×150) na /v1/optimize/wood; nepravidelné polygony pro laser, plazmu a vodní paprsek na /v1/optimize/nest.

Jedno volání, celý plán

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"
  }'

Vrátí se:

{
  "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
}

Kompletní podoba požadavku a odpovědi, všechny volby, všechny chybové kódy a všechna jádra:Reference API → · Průvodce integrací →

Fast, nebo hustě? Vyberte jednou volbou

Volba effort vyvažuje čas výpočtu proti využití. Tady je ten kompromis, změřený na jedné náročné zakázce — každé číslo pochází ze skutečného packeru.

A tak jako tak je to rychlé: i největší výrobní zakázky — 2000 dílů a více — se na výchozím enginu vyřeší v řádu sekund, pohodlně v časovém rozpočtu API.

Řešení podle oboru

Stejné jádro, představené pro způsob řezání v konkrétním oboru. Každá stránka ukazuje endpoint, požadavek a odpověď a pole, na kterých u daného materiálu záleží.

Jádro pracuje s geometrií, ne s katalogem materiálů: plech a plát, deskové materiály na bázi dřeva, sklo, plasty a akrylát, kompozity, pěna, karton i papír procházejí stejnými endpointy. Materiál mění jen čísla, která posíláte — šířku řezu nebo rozestup dílů, odstup od hrany, velikosti zásoby.