CutOptim Engine API

Une API d’optimisation de découpe : envoyez les pièces et le stock — panneaux 2D, barres 1D, bois ou imbrication à forme réelle de pièces irrégulières — et récupérez la disposition, le plan de découpe et le rendement. Par défaut, la même requête renvoie toujours le même plan.

Voir le benchmark complet → · Mesuré, pas revendiqué

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

Pourquoi construire dessus

Le développer, ou l'appeler

Un optimiseur de découpe ressemble à un projet de week-end, puis se transforme en une longue traîne de cas particuliers : arithmétique du trait de scie et du délignage, stock qui s'épuise, règles de rotation et de grain, dispositions qui doivent être sciables de bord à bord, polygones avec des trous — et une suite de régression qui prouve qu'un changement ne dégrade jamais un plan. L'Engine API, c'est ce travail, déjà fait et mesuré.

Voir le benchmark complet →

Tarifs

Chaque requête compte de la même façon — imbrication comprise · Nous vous écrivons à 90 % du quota, puis lorsqu'il est épuisé.

Essayez gratuitement : une clé de démo publique dans la documentation de l'API, et des clés de test de 1,000 requêtes par mois, jamais facturées

Volumes plus importants. 10,000 requêtes par mois correspondent à l'offre standard, ce n'est pas un plafond de ce que nous pouvons faire tourner. S'il vous faut davantage — un volume plus élevé, des clés distinctes pour la préproduction et la production, ou un accord dédié —, indiquez-nous vos chiffres et nous tarifons au cas par cas. Indiquez-nous votre volume →

En vous abonnant, vous acceptez : Engine API Service Terms (en anglais).

Les offres CutOptim habituelles (Gratuit / Pro / Atelier) n'ont aucun lien avec l'API — l'optimiseur intégré à l'application y reste inclus. Voir les tarifs de l'application →

Ce qui entre, ce qui sort

Un vrai travail par mode : en haut le corps de la requête, en dessous le plan renvoyé, dessiné directement à partir de la réponse.

{
  "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 que fait l'API

Deux vitesses : devis immédiat, économie de matériau plus tard

La plupart des intégrations ont besoin des deux — une réponse pendant que le client attend, et un plan plus serré quand le travail part sur la machine. Vous choisissez par appel.

La réponse a la même structure dans les deux cas. En 2D, le moteur max accepte un ensemble d'options plus restreint que heuristic (la documentation les liste), et un travail d'imbrication avec des zones d'exclusion reste servi par lbf.

Quel moteur sert quel mode

L'endpoint que vous appelez en POST choisit le mode ; le paramètre engine choisit l'algorithme. Le moteur heuristic par défaut sert le 2D, le 1D et le bois ; balanced est réservé au 2D ; le moteur asynchrone max sert les panneaux 2D et l'imbrication à forme réelle ; et l'imbrication a pour moteur par défaut son propre moteur lbf. Le même moteur que l'application, en HTTP.

• heuristic — Le moteur par défaut — un packer guillotine multi-stratégies. Rendement maximal, chaque disposition est sciable, et il renvoie toujours un plan de découpe. Il sert le 2D, le 1D et le bois.
• balanced — Un free-nester MaxRects en option pour le 2D. Bien plus rapide sur les très gros travaux pour un rendement légèrement moindre, mais ses dispositions ne peuvent souvent pas être sciées de bord à bord, elles ne portent donc aucun plan de découpe.
• max — Le palier asynchrone : vous soumettez le travail et interrogez GET /v1/jobs/{id} pour le résultat. En 2D, c'est une recherche arborescente qui atteint l'optimum prouvé sur bien plus de travaux, en quelques secondes à une minute par résolution — toujours déterministe et sciable. Sur l'imbrication à forme réelle, il exécute d'abord lbf, puis consacre un budget de temps à chercher une disposition avec moins de feuilles, sans jamais en renvoyer davantage ; cette recherche est limitée dans le temps, ses imbrications indiquent donc deterministic: false.
• lbf — Le moteur par défaut de l'imbrication à forme réelle. Il imbrique des polygones irréguliers dans les poches les uns des autres pour le laser, le plasma et le jet d'eau — instantanément et de façon déterministe. max (ci-dessus) peut ensuite chercher une version du même travail avec moins de feuilles.

Quel endpoint pour quel matériau : les panneaux plats — contreplaqué, MDF, verre, acrylique, tôle — vont vers /v1/optimize/2d ; les barres, tubes, tuyaux et profilés vers /v1/optimize/1d ; le bois de structure (un 50×150 uniquement depuis un 50×150) vers /v1/optimize/wood ; les polygones irréguliers pour le laser, le plasma et le jet d'eau vers /v1/optimize/nest.

Un appel, 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éponse renvoyée :

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

Structure complète de la requête et de la réponse, toutes les options, tous les codes d'erreur et tous les moteurs :Documentation de l'API → · Guide d'intégration →

Fast ou dense ? Choisissez avec une seule option

L'option effort arbitre entre le temps de calcul et l'utilisation. Voici ce compromis, mesuré sur un travail exigeant — chaque chiffre provient du vrai packer.

Et c'est rapide dans tous les cas : même les plus gros travaux de production — 2 000 pièces et plus — se résolvent en quelques secondes avec le moteur par défaut, largement dans le budget de temps de l'API.

Solutions par secteur

Le même moteur, présenté pour la façon dont un métier découpe. Chaque page montre l'endpoint, une requête et une réponse, ainsi que les champs qui comptent pour ce matériau.

Le moteur travaille sur de la géométrie, pas sur un catalogue de matériaux : tôle et plaque, panneaux à base de bois, verre, plastiques et acrylique, composites, mousse, carton et papier passent tous par les mêmes endpoints. Le matériau ne change que les nombres que vous envoyez — trait de scie ou espacement entre pièces, dégagement de bord, tailles de stock.