CutOptim Engine API

Una API de optimización de corte: envía piezas y material — paneles 2D, barras 1D, madera o anidado de forma real de piezas irregulares — y recibe la distribución, el plan de corte y el aprovechamiento. Por defecto, la misma solicitud siempre devuelve el mismo plan.

Ver el benchmark completo → · Medido, no afirmado

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

Por qué construir sobre él

Constrúyelo, o invócalo

Un optimizador de corte parece un proyecto de fin de semana y se convierte en una larga cola de casos límite: aritmética de kerf y refilado, stock que se agota, reglas de rotación y de veta, distribuciones que deben ser serrables de borde a borde, polígonos con agujeros — y una batería de regresión que demuestre que un cambio nunca empeora un plan. La Engine API es ese trabajo, ya hecho y medido.

Ver el benchmark completo →

Precios

Cada solicitud cuenta igual, también el anidado · Te enviamos un correo al llegar al 90 % de la cuota y cuando se agota.

Pruébala gratis: una clave de demostración pública en la referencia de la API y claves de prueba con 1,000 solicitudes al mes que nunca se facturan

Volúmenes mayores. 10,000 solicitudes al mes es el plan estándar, no un techo de lo que podemos ejecutar. Si necesitas más — mayor volumen, claves separadas para staging y producción, o un acuerdo dedicado — dinos tus cifras y lo presupuestamos de forma individual. Cuéntanos tu volumen →

Al suscribirte aceptas: Engine API Service Terms (en inglés).

Los planes habituales de CutOptim (Free / Pro / Taller) no tienen relación con la API — el optimizador integrado en la aplicación sigue incluido en ellos. Ver precios de la aplicación →

Qué entra, qué sale

Un trabajo real por modo: arriba el cuerpo de la petición, debajo el plan devuelto, dibujado directamente a partir de la respuesta.

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

Qué hace la API

Dos velocidades: presupuesta ahora, ahorra material después

La mayoría de integraciones necesitan ambas — una respuesta mientras el cliente espera, y un plan más ajustado cuando el trabajo pasa a la máquina. Tú eliges por llamada.

La respuesta tiene la misma forma en ambos casos. En 2D, el motor max acepta un conjunto de opciones más reducido que heuristic (la referencia las enumera), y un trabajo de anidado con zonas de exclusión lo sigue sirviendo lbf.

Qué motor sirve cada modo

El endpoint al que haces POST elige el modo; el parámetro engine elige el algoritmo. El motor heuristic por defecto sirve 2D, 1D y madera; balanced es solo 2D; el motor max asíncrono sirve paneles 2D y el anidado de forma real; y el anidado tiene su propio motor lbf por defecto. El mismo motor que la aplicación, sobre HTTP.

• heuristic — El motor por defecto — un empaquetador guillotine multiestrategia. El mayor aprovechamiento, cada distribución es cortable con sierra y siempre devuelve un plan de corte. Sirve 2D, 1D y madera.
• balanced — Un empaquetador libre MaxRects opcional para 2D. Mucho más rápido en trabajos muy grandes a cambio de un aprovechamiento algo menor, pero sus distribuciones a menudo no pueden cortarse de borde a borde, así que no llevan plan de corte.
• max — El nivel asíncrono: envías el trabajo y consultas GET /v1/jobs/{id} para el resultado. En 2D es una búsqueda en árbol que alcanza el óptimo probado en muchos más trabajos, con un tiempo de segundos a un minuto por resolución — sigue siendo determinista y cortable con sierra. En el anidado de forma real ejecuta primero lbf y luego dedica un presupuesto de tiempo a buscar una distribución con menos tableros, sin devolver nunca más; esa búsqueda tiene un tiempo limitado, así que sus anidados dicen deterministic: false.
• lbf — El motor por defecto del anidado de forma real. Empaqueta polígonos irregulares en las cavidades de las demás piezas para láser, plasma y chorro de agua — de forma instantánea y determinista. max (arriba) puede después buscar en el mismo trabajo una distribución con menos tableros.

Qué endpoint para cada material: los tableros planos — contrachapado, MDF, vidrio, acrílico, chapa metálica — van a /v1/optimize/2d; barras, tubo, tubería y perfil a /v1/optimize/1d; madera estructural (un 50×150 solo a partir de 50×150) a /v1/optimize/wood; polígonos irregulares para láser, plasma y chorro de agua a /v1/optimize/nest.

Una llamada, un plan completo

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

Devuelve:

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

La estructura completa de la solicitud y la respuesta, todas las opciones, todos los códigos de error y todos los motores:Referencia de la API → · Guía de integración →

¿Fast o denso? Elige con una sola opción

La opción effort equilibra el tiempo de cálculo frente al aprovechamiento. Aquí está ese compromiso, medido en un trabajo exigente — cada cifra proviene del packer real.

Y en cualquier caso es rápido: incluso los trabajos de producción más grandes — 2000 piezas o más — se resuelven en segundos con el motor predeterminado, holgadamente dentro del presupuesto de tiempo de la API.

Soluciones por sector

El mismo motor, presentado según cómo corta cada oficio. Cada página muestra el endpoint, una solicitud y una respuesta, y los campos que importan para ese material.

El motor trabaja con geometría, no con un catálogo de materiales: chapa y plancha metálica, tableros derivados de la madera, vidrio, plásticos y acrílico, composites, espuma, cartón y papel pasan todos por los mismos endpoints. El material solo cambia los números que envías — kerf o separación entre piezas, holgura de borde, tamaños de stock.