CutOptim Engine API

Un API de optimizare a tăierii: trimiți piesele și materialul — plăci 2D, bare 1D, lemn sau nesting true-shape pentru piese neregulate — și primești înapoi layoutul, planul de tăiere și utilizarea materialului. Implicit, aceeași cerere returnează întotdeauna același plan.

Vezi benchmarkul complet → · Măsurat, nu pretins

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

De ce să construiești pe el

Îl construiești sau îl apelezi

Un optimizator de tăiere pare un proiect de weekend și se transformă într-un șir lung de cazuri speciale: aritmetica kerf-ului și a tăierii de margine, materialul care se termină, regulile de rotire și de fibră, aranjamente care trebuie să fie tăiabile de la o margine la alta, poligoane cu holes — și o suită de regresie care demonstrează că o modificare nu înrăutățește niciodată un plan. Engine API este exact această muncă, deja făcută și măsurată.

Vezi benchmarkul complet →

Prețuri

Fiecare cerere contează la fel — nesting inclus · Vă trimitem un e-mail la 90% din cotă și când aceasta se epuizează.

Încercați gratuit: o cheie demo publică în documentația API și chei de test cu 1,000 cereri pe lună, care nu se facturează niciodată

Volume mai mari. Cele 10,000 cereri pe lună sunt planul standard, nu un plafon al a ceea ce putem rula. Dacă ai nevoie de mai mult — volum mai mare, chei separate pentru staging și producție sau o înțelegere dedicată — spune-ne cifrele tale și îl tarifăm individual. Spune-ne volumul tău →

Prin abonare accepți: Engine API Service Terms (în engleză).

Planurile obișnuite CutOptim (Gratuit / Pro / Atelier) nu au legătură cu API-ul — optimizatorul din aplicație rămâne inclus în ele. Vezi prețurile aplicației →

Ce intră, ce iese

O lucrare reală pentru fiecare mod: sus corpul cererii, dedesubt planul primit, desenat direct din răspuns.

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

Ce face API-ul

Două viteze: ofertă acum, material economisit mai târziu

Majoritatea integrărilor au nevoie de amândouă — un răspuns cât timp așteaptă clientul, și un plan mai strâns când lucrarea ajunge la mașină. Alegi per apel.

Răspunsul are aceeași structură în ambele cazuri. La 2D, motorul max acceptă un set mai restrâns de opțiuni decât heuristic (documentația le listează), iar o lucrare de nesting cu zone de excludere este deservită tot de lbf.

Care motor deservește care mod

Endpointul către care faci POST alege modul; parametrul engine alege algoritmul. Motorul implicit heuristic deservește 2D, 1D și lemnul; balanced este doar 2D; motorul asincron max deservește panourile 2D și nestingul true-shape; iar implicit pentru nesting este propriul motor lbf. Același motor ca în aplicație, prin HTTP.

• heuristic — Implicit — un packer guillotine cu strategii multiple. Randament maxim, fiecare layout poate fi tăiat cu ferăstrăul și returnează întotdeauna un plan de tăiere. Deservește 2D, 1D și lemnul.
• balanced — Un free-nester MaxRects opțional pentru 2D. Mult mai rapid pe lucrări foarte mari, cu un randament ușor mai mic, dar layouturile lui adesea nu pot fi tăiate cu ferăstrăul dintr-o margine în alta, așa că nu poartă niciun plan de tăiere.
• max — Nivelul asincron: trimiți lucrarea și interoghezi GET /v1/jobs/{id} pentru rezultat. La 2D este o căutare arborescentă care atinge optimul demonstrat pe mult mai multe lucrări, în câteva secunde până la un minut per rezolvare — rămâne determinist și tăiabil cu ferăstrăul. La nesting true-shape rulează întâi lbf, apoi cheltuiește un buget de timp căutând un aranjament cu mai puține plăci și nu returnează niciodată mai multe; această căutare este limitată în timp, așa că nesturile ei spun deterministic: false.
• lbf — Motorul implicit de nesting true-shape. Împachetează poligoane neregulate în buzunarele unora în ale altora, pentru laser, plasmă și jet de apă — instantaneu și determinist. max (mai sus) poate apoi căuta aceeași lucrare pentru mai puține plăci.

Care endpoint pentru care material: plăci plane — placaj, MDF, sticlă, acril, tablă — merg la /v1/optimize/2d; bare, tuburi, țevi și profile la /v1/optimize/1d; lemn structural (un 50×150 doar dintr-un 50×150) la /v1/optimize/wood; poligoane neregulate pentru laser, plasmă și jet de apă la /v1/optimize/nest.

Un singur apel, un plan complet

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

Răspunsul primit:

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

Structura completă a cererii și a răspunsului, fiecare opțiune, toate codurile de eroare și toate motoarele:Documentația API → · Ghid de integrare →

Fast sau dens? Alege cu o singură opțiune

Opțiunea effort echilibrează timpul de calcul cu utilizarea. Iată acest compromis, măsurat pe o lucrare solicitantă — fiecare cifră provine din packerul real.

Și oricum este rapid: chiar și cele mai mari lucrări de producție — 2.000 de piese și mai mult — se rezolvă în câteva secunde pe motorul implicit, confortabil în bugetul de timp al API-ului.

Soluții pe industrie

Același motor, poziționat pentru felul în care taie fiecare meserie. Fiecare pagină arată endpointul, o cerere și un răspuns, și câmpurile care contează pentru acel material.

Motorul lucrează cu geometrie, nu cu un catalog de materiale: tablă și plăci metalice, panouri pe bază de lemn, sticlă, plastice și acril, compozite, spumă, carton și hârtie trec toate prin aceleași endpointuri. Materialul schimbă doar numerele pe care le trimiți — kerf-ul sau distanța dintre piese, marginea liberă, dimensiunile materialului de bază.