CutOptim Engine API

Uma API de otimização de corte: envie peças e estoque — painéis 2D, barras 1D, madeira ou nesting de peças irregulares pela forma real — e receba o layout, o plano de corte e o aproveitamento. Por padrão a mesma requisição sempre devolve o mesmo plano.

Ver o benchmark completo (EN) → · Medido, não alegado

{
  "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 que construir sobre ele

Construir ou chamar a API

Um otimizador de corte parece um projeto de fim de semana e vira uma longa cauda de casos-limite: a aritmética de espessura de serra e refilo, estoque que acaba, regras de rotação e veio, layouts que precisam ser serráveis de ponta a ponta, polígonos com furos — e uma suíte de regressão que prove que uma mudança nunca piora um plano. A Engine API é esse trabalho, já feito e medido.

Ver o benchmark completo (EN) →

Preços

Toda requisição conta igual — nesting incluído · Enviamos um e-mail quando você atinge 90% da cota e quando ela acaba.

Teste grátis: uma chave de demonstração pública na referência da API e chaves de teste com 1,000 requisições por mês que nunca são cobradas

Volumes maiores. 10,000 requisições por mês é o plano padrão, não um teto do que conseguimos rodar. Se precisar de mais — volume maior, chaves separadas para homologação e produção, ou um acordo dedicado — conte os seus números e fazemos um preço individual. Conte o seu volume →

Ao assinar, você aceita os Termos de Serviço da Engine API (em inglês).

Os planos normais do CutOptim (Free / Pro / Workshop) não têm relação com a API — o otimizador do app continua incluído neles. Ver os preços do app →

O que entra, o que sai

Um trabalho real por modo: o corpo da requisição em cima e, embaixo, o plano que voltou, desenhado direto da resposta.

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

O que a API faz

Duas velocidades: orce agora, economize material depois

A maioria das integrações precisa das duas — uma resposta enquanto o cliente espera e um plano mais apertado quando o trabalho vai para a máquina. Você escolhe a cada chamada.

A resposta tem o mesmo formato nos dois casos. Em 2D o motor max aceita um conjunto mais restrito de opções que o heuristic (a referência as lista), e um nesting com zonas de exclusão continua sendo atendido pelo lbf.

Qual motor atende cada modo

O endpoint para o qual você faz o POST escolhe o modo; o parâmetro engine escolhe o algoritmo. O motor padrão heuristic atende 2D, 1D e madeira; balanced é só 2D; o motor assíncrono max atende painéis 2D e nesting pela forma real; e o nesting usa por padrão o seu próprio motor lbf. O mesmo motor do app, via HTTP.

• heuristic — O padrão — um empacotador guilhotina com várias estratégias. Maior aproveitamento, todo layout é cortável na serra e sempre devolve um plano de corte. Atende 2D, 1D e madeira.
• balanced — Um nester livre MaxRects opcional para 2D. Muito mais rápido em trabalhos muito grandes, com aproveitamento um pouco menor, mas os layouts muitas vezes não podem ser serrados de ponta a ponta, então não trazem plano de corte.
• max — O nível assíncrono: você envia o trabalho e consulta GET /v1/jobs/{id} até o resultado. Em 2D é uma busca em árvore que chega ao ótimo comprovado em muito mais trabalhos, com segundos a um minuto por solução — ainda determinística e cortável na serra. No nesting pela forma real roda primeiro o lbf, depois usa um orçamento de tempo procurando um layout com menos chapas e nunca devolve mais; essa busca é limitada por tempo, então os seus nestings informam deterministic: false.
• lbf — O padrão do nesting pela forma real. Encaixa polígonos irregulares nas reentrâncias uns dos outros para laser, plasma e jato d’água — na hora e de forma determinística. O max (acima) pode então buscar o mesmo trabalho com menos chapas.

Qual endpoint para qual material: chapas planas — compensado, MDF, vidro, acrílico, chapa metálica — vão para /v1/optimize/2d; barras, tubos e perfis para /v1/optimize/1d; madeira estrutural (um 50×150 só de 50×150) para /v1/optimize/wood; polígonos irregulares para laser, plasma e jato d’água para /v1/optimize/nest.

Uma chamada, um plano 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"
  }'

Volta como:

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

Formato completo de requisição e resposta, cada opção, todos os códigos de erro e todos os motores:Referência da API (EN) → · Guia de integração (EN) →

Rápido ou denso? Escolha com uma opção

A opção effort troca tempo de solução por aproveitamento. Aqui está essa troca, medida num trabalho exigente — cada número vem do empacotador real.

E é rápido de qualquer jeito: até os maiores trabalhos de produção — 2.000 peças ou mais — resolvem em poucos segundos no motor padrão, folgadamente dentro do orçamento de tempo da API.

Soluções por setor

O mesmo motor, posicionado para o jeito de cortar de cada setor. Cada página (em inglês) mostra o endpoint, uma requisição e uma resposta, e os campos que importam para aquele material.

O motor trabalha com geometria, não com um catálogo de materiais: chapa metálica, painéis de madeira, vidro, plásticos e acrílico, compósitos, espuma, papelão e papel passam pelos mesmos endpoints. O material só muda os números que você envia — espessura de serra ou espaçamento entre peças, folga da borda, medidas de estoque.