Zum Hauptinhalt springen
← CutOptim Engine APIEngine API · Nesting · heute live

Zuschnitt-Marker-Nesting API

Ja — es gibt eine API für die Markererstellung. Schnittteile so auf eine Rolle aus Stoff, Leder oder technischem Textil zu legen, dass der Marker möglichst kurz wird, ist ein True-Shape-Nesting-Problem mit einer offenen Dimension, und die CutOptim Engine API löst es über HTTP unter POST /v1/optimize/nest. Ihr PLM, ERP oder Ihre Made-to-Order-Software sendet die Teilekonturen und die Rollenbreite als JSON und erhält einen Marker zurück: die Platzierung jedes Teils und die dafür nötige Länge — für Bekleidung, Polsterei, Lederwaren und technische Textilien.

Das ist heute live als Marker-Modus des Nesting-Endpunkts: eine Materialzeile mit roll: true und ohne h. Dieselbe True-Shape-Engine, die Tafeln schachtelt, schachtelt die Teile; nur das Material ändert sich, von einer Tafel fester Größe zu einer Rolle fester Breite und freier Länge.

Alle Formate, Engines, Limits und Codebeispiele für Entwickler: CutOptim Nesting-API

POST /v1/optimize/nest
{
  "parts": [
    { "name": "front",
      "polygon": [[0,0],[560,0],[560,700],[420,760],[140,760],[0,700]],
      "qty": 2, "allowedRotations": [0,180] },
    { "name": "sleeve",
      "polygon": [[0,0],[480,0],[420,560],[60,560]],
      "qty": 4, "allowedRotations": [0,180] },
    { "name": "collar",
      "polygon": [[0,0],[500,0],[500,80],[0,80]],
      "qty": 2, "allowedRotations": [0,180] }
  ],
  "stock": [{ "w": 1585, "roll": true }],
  "options": { "minSeparation": 3, "edgeClearance": 5 }
}

Nesting ist nicht Teil der öffentlichen Demo — dieses Beispiel mit einem kostenlosen Testschlüssel ausführen. Kostenlosen Testschlüssel erstellen

  • Heute live auf POST /v1/optimize/nest — Marker-Modus, mit einer roll-Materialzeile (w und roll: true, kein h).
  • Liefert EINE Tafel, deren h die kürzeste gefundene Markerlänge ist, mit Randabstand — auch in metrics.length.
  • True-Shape-Teile: Polygone (mit Löchern) oder SVG- und DXF-Dateien über parts[].source.
  • Fadenlauf und Strich: allowedRotations [0, 180] je Teil behält die Richtung; options.minSeparation und options.edgeClearance setzen die Abstände.
  • stock[].maxLength begrenzt den Marker (höchstens 200000); Teile, die nicht passen, landen in unplaced, nie auf einer zweiten Tafel.
  • lbf antwortet synchron für das Angebot; max ist asynchron (202, dann GET /v1/jobs/{id} pollen) und kann den lbf-Marker nur verkürzen.
  • Kostenlose Validierung: POST /v1/validate/nest prüft einen Auftrag ohne Schlüssel und ohne Kontingent.

Eine Rolle ist keine Tafel

Eine Tafel hat zwei feste Seiten, und die Frage ist, wie viele Tafeln ein Auftrag braucht. Eine Rolle hat eine feste Seite — die Breite —, und die Frage ist, wie viel Länge die Teile verbrauchen. Senden Sie eine Materialzeile mit w und roll: true, ohne h, und das Nesting liefert EINE Tafel der Breite w zurück, deren h die kürzeste gefundene Länge ist, mit Randabstand an beiden Enden; dieselbe Zahl steht in metrics.length. Die Länge auf der Rolle ist das, was Sie einkaufen, also die Zahl, die ein Angebot braucht.

Was Sie senden und was zurückkommt

Senden Sie jedes Schnittteil als Polygon (mit optionalen Löchern) oder als SVG oder DXF über parts[].source, mit einer Stückzahl. Die Response liefert jede Platzierung als starre Transformation (eine Drehung in Grad, dann eine x/y-Verschiebung), die Markerlänge und jedes Teil, das nicht gepasst hat, in unplaced. Jedes meta-Objekt — Ihre Modell-, Größen- oder Zuschnittreferenz — kommt unverändert bei jeder platzierten Kopie zurück, sodass der Marker mit Ihrem eigenen System übereinstimmt.

Fadenlauf, Strich und Abstände

allowedRotations wird je Teil gesetzt: [0, 180] behält die Fadenlauf- oder Strichrichtung bei und lässt ein Teil trotzdem um eine halbe Drehung wenden, während eine längere Liste oder "continuous" zu einem Material ohne Richtung passt. options.minSeparation legt den Abstand zwischen den Teilen fest und options.edgeClearance den Abstand an den Rändern der Rolle. Ein optionales stock[].maxLength begrenzt den Marker auf eine von Ihnen gewählte Länge (höchstens 200000 in Ihrer Einheit): Teile, die darin nicht passen, kommen in unplaced zurück, und eine Rolle wird nie zu einer zweiten Tafel.

Sofort für das Angebot, max für den Zuschnitt

Die Standard-Engine lbf antwortet synchron — deterministisch und innerhalb der Anfrage, schnell genug, um einen Marker zu kalkulieren, während der Kunde wartet. Für den Zuschnittauftrag senden Sie denselben Body mit engine: "max" und pollen GET /v1/jobs/{id}: Sie startet vom lbf-Marker und verwendet das von Ihnen gesetzte Zeitbudget (options.timeBudgetMs) auf eine Streifensuche, die ihn verkürzen, aber nie verlängern kann. Die Response hat in beiden Fällen dieselbe Struktur, und eine warnings-Zeile nennt die Länge und, mit max, ob die Suche sie verkürzt hat.

Zum Download
One-Pager zur Zuschnitt-Marker-Nesting API

Eine Zusammenfassung auf zwei Seiten (PDF in English) — das Problem, was Sie senden und zurückbekommen, ein Request und eine Response und wie Sie auf der Engine aufbauen. Druckfertig, mit QR-Code zurück zu dieser Seite.

PDF2 SeitenKostenlos
PDF herunterladen

FAQ

Gibt es eine API für die Markererstellung?
Ja. Schnittteile so auf eine Rolle zu legen, dass der Marker möglichst kurz wird, ist der Marker-Modus des Nesting-Endpunkts der CutOptim Engine API, POST /v1/optimize/nest. Sie senden jedes Teil als Polygon (oder SVG oder DXF) plus eine Materialzeile mit der Rollenbreite und roll: true und erhalten einen Marker zurück: die Platzierung jedes Teils und seine Länge. Er läuft heute produktiv, für Bekleidung, Polsterei, Leder und technische Textilien.
Wie wird die Markerlänge bestimmt?
Die lbf-Engine platziert die Teile und liefert die nötige Länge, synchron und deterministisch. Mit engine: "max" läuft der Auftrag asynchron: Er startet vom lbf-Marker und verwendet options.timeBudgetMs auf die Suche nach einem kürzeren Streifen und liefert nie einen längeren zurück. Die Länge ist das h der einen zurückgelieferten Tafel, mit Randabstand, und steht zusätzlich in metrics.length.
Kann ich die Fadenlauf- oder Strichrichtung beibehalten?
Ja. Setzen Sie allowedRotations je Teil: [0, 180] hält das Teil auf der Fadenlauflinie und lässt es um eine halbe Drehung wenden, ein einzelner Winkel fixiert es vollständig. Teile aus einem Material ohne Richtung können eine längere Winkelliste oder "continuous" erhalten. options.minSeparation und options.edgeClearance legen die Abstände zwischen den Teilen und an den Rändern der Rolle fest.
Kann ich die Markerlänge begrenzen?
Ja. stock[].maxLength begrenzt den Marker auf eine von Ihnen gewählte Länge, höchstens 200000 in Ihrer Einheit. Teile, die darin nicht passen, kommen in unplaced zurück — eine Rolle wird nie zu einer zweiten Tafel —, sodass Sie sehen, was übrig bleibt, und entscheiden können, wie es weitergeht.
Gradiert es Schnitte, rapportiert Karos oder plant das Auslegen?
Nein. Es schachtelt die Teile, die Sie senden: Es gradiert keinen Schnitt in Größen, passt keine Karos oder Streifen an und plant keine Lagen und kein Auslegen. Senden Sie jede Größe und Stückzahl, die der Marker enthalten soll, als Teile, mit einem meta-Objekt für Ihre eigenen Referenzen, und die Response sagt Ihnen, wohin jede Kopie kommt.
Wie viel Stoff spart es?
Das hängt von den Teilen und der Rollenbreite ab, deshalb nennen wir keinen pauschalen Prozentsatz. Die ehrliche Kennzahl ist die Markerlänge bei denselben Teilen und derselben Breite: Lassen Sie den Auftrag laufen, vergleichen Sie die Länge mit Ihrem bisherigen Marker und lbf mit max. max liefert nie einen längeren Marker als lbf. POST /v1/validate/nest prüft einen Auftrag kostenlos, ohne Schlüssel und ohne Kontingent.

Anwendungsfall Textil und Polsterei (App) · Benchmarks