文档首页/ 天筹求解器服务 OptVerse/ API参考/ API/ 算法服务/ 方形件-电子锯
更新时间：2025-08-28 GMT+08:00
查看PDF
分享

方形件-电子锯

创建任务

创建二维切割-方形件-电子锯任务， 该接口为异步操作，返回任务ID，任务的状态及结果请通过查询任务详情接口获取

URI

POST /v2/{project_id}/optverse/regular-plate/tasks

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

用户项目ID，获取方法请参见获取项目ID。

请求参数

二维切割前的原材料请求参数如表4所示。

表2 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

是

String

该字段填为“application/json”。
表3 请求Body参数

参数

是否必选

参数类型

描述

input_json

是

object

任务输入信息，json格式，具体数据结构参见regularPlateInputJson。
表4 regularPlateInputJson

参数

是否必须

参数类型

说明

plate_id

是

Int

原材料ID

plate_length

是

Float

原材料长

plate_width

是

Float

原材料宽

plate_thick

是

Float

原材料厚度

plate_material

是

String

原材料制作材料

plate_grain

是

Bool

原材料是否有纹路

plate_num

是

Int

原材料数量

is_offcut

否

Bool

是否为余料

plate_cost

否

Float

原材料成本

二维切割后的成品请求参数如表5所示。

表5 成品请求Body参数说明

参数

是否必须

参数类型

说明

item_id

是

int

成品ID

item_length

是

Float

成品长

item_width

是

Float

成品宽

item_thick

是

Float

成品厚度

item_num

是

Int

成品数量

item_turn

是

Bool

成品是否可以旋转（无纹路：true,有纹路：false）

item_material

是

String

成品材料

item_name

是

String

成品名称

is_substitute

否

Bool

是否为替补板

label_info

是(键值对内的信息可随意增加与删减)

map<String,String>

打印标签信息的键值对组合

二维切割条件参数的请求参数如表6所示。

表6 切割条件参数的请求Body参数说明

参数

是否必须

参数类型

说明

kerf_horizontal

是

Float

横向锯刀宽度

kerf_vertical

是

Float

纵向锯刀宽度

plate_trim_horizontal

是

Float

原材料横向修边量

plate_trim_vertical

是

Float

原材料纵向修边量

item_forward_trim

是

Float

再分锯切前向修边量

item_backward_trim

是

Float

再分锯切后部修边量

first_cut_direction

是

Int

进料方向（横向0，纵向1，任意方向2）

max_stack_height

是

Float

最大叠板高度

calculate_time

是

Int

算法的最长计算时间

offcut_length

否

Float

余料长度下限

offcut_width

否

Float

余料宽度下限

offcut_area

否

Float

余料面积下限

time_cost

否

Float

每小时的锯切时间成本

max_cut_stage_num

否

Int

开始切割后，同一个方向上的切割，统计为一次，需在设置的转板次数内，将大板切割完毕

min_stack_utilization

否

Float

最小的叠板利用率

item_sort_location

否

Bool

长条板件中部件的放置顺序，true最大部件放在左侧，false最大部件放在右侧

item_num_limit

否

Int

锯切图上的小板种类数量限制

请求示例

POST https://{endpoint}/v2/{project_id}/optverse/regular-plate/tasks
Request Header:
Content-Type: application/json;charset=utf-8
Auth-Token:
Body:
{
    "input_json": {
        "items": [
            {
                "item_id": 0,
                "item_material": "18mm金丝白橡零度木刺刨花板E0",
                "item_length": 60.0,
                "item_width": 553.0,
                "item_turn": false,
                "item_num": 1,
                "item_name": "F-补板/立档条",
                "item_thick": 18,
                "label_info": {}
            }
        ],
        "parameters": [
            {
                "calculate_time": 30,
                "first_cut_direction": 1,
                "item_backward_trim": 0.0,
                "item_forward_trim": 0.0,
                "kerf_horizontal": 4.4,
                "kerf_vertical": 4.4,
                "max_program_num": 2,
                "max_stack_height": 80,
                "plate_trim_horizontal": 10.0,
                "plate_trim_vertical": 10.0
            }
        ],
        "plates": [
            {
                "plate_grain": true,
                "plate_id": 0,
                "plate_length": 2440.0,
                "plate_material": "18mm金丝白橡零度木刺刨花板E0",
                "plate_num": 9999,
                "plate_thick": 18.0,
                "plate_width": 1220.0
            }
        ]
    }
}

响应示例

成功响应示例

{
    "task_id": "40axxxx-701a-47cf-8b56-648xxxxxxd25,
    "create_time": "2025-08-13T08:58:51.479Z",
    "estimated_start_time": null,
    "status": "Pending"
}

参数说明如表7所示。

表7 响应参数

参数

参数类型

说明

task_id

String

任务编号。

create_time

String

任务创建时间

estimated_start_time

String

预估开始时间

status

String

任务状态，包括：

  • Pending：任务等待处理中（排队中）
  • Running：任务正在运行
  • Expired：任务超时
  • Failed：任务失败
  • Succeeded：任务成功
失败响应示例 
{
    "error_code": "optverse.00000006",
    "error_msg": "Input data validate error: the item material is 18MM_PLATE, item_id is 0： Length and width are larger than plate.\n"
}

查询任务

该API用于查询并显示方形件-电子锯任务详情

URI

GET /v2/{project_id}/optverse/regular-plate/tasks/{task_id}

请求参数

表8 参数说明

参数

参数类型

说明

task_id

String

任务ID

响应参数

表9 响应Body参数

参数

参数类型

描述

task_id

String

任务编号。

input_json

String

输入数据，当前为null

status

String

任务状态，包括：

  • Pending：任务等待处理中（排队中）
  • Running：任务正在运行
  • Expired：任务超时
  • Failed：任务失败
  • Succeeded：任务成功

progress

String

返回任务进度

output_json

Array of objects

任务处理结果，json格式，任务状态为finished时携带。具体数据结构参见regularPlateResultDetail

estimated_start_time

String

预估开始时间

start_time

String

任务开始时间

end_time

String

任务结束时间

create_time

String

任务创建时间
表10 regularPlateResultDetail

参数

参数类型

说明

error_detail

String

如果运行出错会提示

result

Object

如果运行正常会在该属性内给出结果

status

String

任务状态，包括：

  • Pending：任务等待处理中（排队中）
  • Running：任务正在运行
  • Expired：任务超时
  • Failed：任务失败
  • Succeeded：任务成功

task_id

String

任务id

result_list

Array of objects

切割方案列表

plan_info

Array of objects

切割方案的统计信息列表

cut_file

String

以字符串形式保存的切割方案文件

plan_name

String

此方案序号（根据参数设置可给出多组方案）

material_info

String

统计信息，详情请参见表11

material_name

String

材料名称

problem_id

Int

按材料划分的问题序列号
表11 统计信息响应参数说明

参数

单位

参数类型

说明

cut_length

米(m)

float

切割长度

cut_sum

-

Int

切割刀数

cut_time

分钟(min)

float

锯切时间

item_num

-

Int

开料件数

material

-

String

材料

program_num

-

Int

锯切图数量

run_program_num

-

Int

运行的锯切图数

rate

百分比(%)

float

原材料利用率

sum_area

平方米(m2)

float

原材料使用面积

sum_cost

-

Float

锯切成本

sum_plate_num

-

Int

原材料使用数量

sum_used_area

平方米(m2)

float

原材料利用面积

请求示例

表12 参数说明

参数

参数类型

说明

task_id

String

任务ID

响应示例

响应示例

成功响应示例 
{
    "result": {
        "result_list": [
            {
                "cut_file": "<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?><AutoCut ver=\"100\"><Project Name=\"订单\" CutTime=\"999.99\" Selected=\"-1\" ApplictionVer=\"1.0.0\" Update=\"2020-4-22 11:14:00\"><Data Class=\"3\" TotalUnit=\"1000000\" Type=\"18.0_18MM_PLATE\" Ply=\"18.0\" Grain=\"True\"><Objective Type=\"Shape\" Count=\"1\"><Shape X=\"60.0\" Y=\"553.0\" Turn=\"True\" Count=\"1\" Name=\"底板\" TLType=\"18MM_PLATE_18.0mm\" FH=\"18.0\" item_code=\"小板标识\" order_code=\"订单号\" plan_code=\"批次号\"/></Objective><Substitute Type=\"Shape\" Count=\"1\"><Shape X=\"60.0\" Y=\"553.0\" Turn=\"True\" Count=\"1\" Name=\"底板\" TLType=\"18MM_PLATE_18.0mm\" FH=\"18.0\" item_code=\"小板标识\" order_code=\"订单号\" plan_code=\"批次号\"/></Substitute><Condition Type=\"Shape\" Count=\"1\"><Shape Name=\"18MM_PLATE\" X=\"2440.0\" Y=\"1220.0\" Turn=\"True\" Sx=\"10.0\" Sy=\"10.0\" Count=\"9999\"/></Condition><Solutions Selected=\"0\"><Solution SolverName=\"排料名称\" SolveGap=\"4.4\" SheetCounts=\"1\" SumUnitArea=\"66360.0\" SumSheetArea=\"2976800.0\" SumSpareArea=\"2910440.0\"><Layouts><Layout ID=\"0\" SheetID=\"0\" Count=\"1\" Cut=\"False\" X=\"2440.0\" Y=\"1220.0\" UnitArea=\"66360.0\" SheetArea=\"2976800.0\" SpareArea=\"2910440.0\"><Part X=\"1212.2\" Y=\"2432.2\" Px=\"7.8\" Py=\"7.8\"><Part X=\"2432.2\" Y=\"60.0\" Px=\"7.8\" Py=\"7.8\"><Part X=\"60.0\" Y=\"553.0\" Px=\"7.8\" Py=\"7.8\" Turn=\"False\" UID=\"0\" BID=\"0\" Angle=\"90\"/><Substitute X=\"60.0\" Y=\"553.0\" Px=\"565.2\" Py=\"7.8\" Turn=\"False\" SID=\"0\" BID=\"0\" Angle=\"90\"/></Part></Part></Layout></Layouts></Solution></Solutions></Data></Project></AutoCut>",
                "plan_info": [
                    {
                        "material_info": {
                            "cut_length": 5.02,
                            "cut_sum": 5,
                            "cut_time": 1.1,
                            "item_num": 2,
                            "material": "18MM_PLATE",
                            "program_num": 1,
                            "rate": 0.02229,
                            "run_program_num": 1,
                            "sum_area": 2.98,
                            "sum_cost": 103.67,
                            "sum_plate_num": 1,
                            "sum_used_area": 0.07
                        },
                        "material_name": "18MM_PLATE",
                        "problem_id": 1
                    }
                ],
                "plan_name": "方案1"
            },
            {
                "cut_file": "<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?><AutoCut ver=\"100\"><Project Name=\"订单\" CutTime=\"999.99\" Selected=\"-1\" ApplictionVer=\"1.0.0\" Update=\"2020-4-22 11:14:00\"><Data Class=\"3\" TotalUnit=\"1000000\" Type=\"18.0_18MM_PLATE\" Ply=\"18.0\" Grain=\"True\"><Objective Type=\"Shape\" Count=\"1\"><Shape X=\"60.0\" Y=\"553.0\" Turn=\"True\" Count=\"1\" Name=\"底板\" TLType=\"18MM_PLATE_18.0mm\" FH=\"18.0\" item_code=\"小板标识\" order_code=\"订单号\" plan_code=\"批次号\"/></Objective><Substitute Type=\"Shape\" Count=\"1\"><Shape X=\"60.0\" Y=\"553.0\" Turn=\"True\" Count=\"1\" Name=\"底板\" TLType=\"18MM_PLATE_18.0mm\" FH=\"18.0\" item_code=\"小板标识\" order_code=\"订单号\" plan_code=\"批次号\"/></Substitute><Condition Type=\"Shape\" Count=\"1\"><Shape Name=\"18MM_PLATE\" X=\"2440.0\" Y=\"1220.0\" Turn=\"True\" Sx=\"10.0\" Sy=\"10.0\" Count=\"9999\"/></Condition><Solutions Selected=\"0\"><Solution SolverName=\"排料名称\" SolveGap=\"4.4\" SheetCounts=\"1\" SumUnitArea=\"66360.0\" SumSheetArea=\"2976800.0\" SumSpareArea=\"2910440.0\"><Layouts><Layout ID=\"0\" SheetID=\"0\" Count=\"1\" Cut=\"False\" X=\"2440.0\" Y=\"1220.0\" UnitArea=\"66360.0\" SheetArea=\"2976800.0\" SpareArea=\"2910440.0\"><Part X=\"1212.2\" Y=\"2432.2\" Px=\"7.8\" Py=\"7.8\"><Part X=\"2432.2\" Y=\"60.0\" Px=\"7.8\" Py=\"7.8\"><Part X=\"60.0\" Y=\"553.0\" Px=\"7.8\" Py=\"7.8\" Turn=\"False\" UID=\"0\" BID=\"0\" Angle=\"90\"/><Substitute X=\"60.0\" Y=\"553.0\" Px=\"565.2\" Py=\"7.8\" Turn=\"False\" SID=\"0\" BID=\"0\" Angle=\"90\"/></Part></Part></Layout></Layouts></Solution></Solutions></Data></Project></AutoCut>",
                "plan_info": [
                    {
                        "material_info": {
                            "cut_length": 5.02,
                            "cut_sum": 5,
                            "cut_time": 1.1,
                            "item_num": 2,
                            "material": "18MM_PLATE",
                            "program_num": 1,
                            "rate": 0.02229,
                            "run_program_num": 1,
                            "sum_area": 2.98,
                            "sum_cost": 103.67,
                            "sum_plate_num": 1,
                            "sum_used_area": 0.07
                        },
                        "material_name": "18MM_PLATE",
                        "problem_id": 1
                    }
                ],
                "plan_name": "方案2"
            },
            {
                "cut_file": "<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?><AutoCut ver=\"100\"><Project Name=\"订单\" CutTime=\"999.99\" Selected=\"-1\" ApplictionVer=\"1.0.0\" Update=\"2020-4-22 11:14:00\"><Data Class=\"3\" TotalUnit=\"1000000\" Type=\"18.0_18MM_PLATE\" Ply=\"18.0\" Grain=\"True\"><Objective Type=\"Shape\" Count=\"1\"><Shape X=\"60.0\" Y=\"553.0\" Turn=\"True\" Count=\"1\" Name=\"底板\" TLType=\"18MM_PLATE_18.0mm\" FH=\"18.0\" item_code=\"小板标识\" order_code=\"订单号\" plan_code=\"批次号\"/></Objective><Substitute Type=\"Shape\" Count=\"1\"><Shape X=\"60.0\" Y=\"553.0\" Turn=\"True\" Count=\"1\" Name=\"底板\" TLType=\"18MM_PLATE_18.0mm\" FH=\"18.0\" item_code=\"小板标识\" order_code=\"订单号\" plan_code=\"批次号\"/></Substitute><Condition Type=\"Shape\" Count=\"1\"><Shape Name=\"18MM_PLATE\" X=\"2440.0\" Y=\"1220.0\" Turn=\"True\" Sx=\"10.0\" Sy=\"10.0\" Count=\"9999\"/></Condition><Solutions Selected=\"0\"><Solution SolverName=\"排料名称\" SolveGap=\"4.4\" SheetCounts=\"1\" SumUnitArea=\"66360.0\" SumSheetArea=\"2976800.0\" SumSpareArea=\"2910440.0\"><Layouts><Layout ID=\"0\" SheetID=\"0\" Count=\"1\" Cut=\"False\" X=\"2440.0\" Y=\"1220.0\" UnitArea=\"66360.0\" SheetArea=\"2976800.0\" SpareArea=\"2910440.0\"><Part X=\"1212.2\" Y=\"2432.2\" Px=\"7.8\" Py=\"7.8\"><Part X=\"2432.2\" Y=\"60.0\" Px=\"7.8\" Py=\"7.8\"><Part X=\"60.0\" Y=\"553.0\" Px=\"7.8\" Py=\"7.8\" Turn=\"False\" UID=\"0\" BID=\"0\" Angle=\"90\"/><Substitute X=\"60.0\" Y=\"553.0\" Px=\"565.2\" Py=\"7.8\" Turn=\"False\" SID=\"0\" BID=\"0\" Angle=\"90\"/></Part></Part></Layout></Layouts></Solution></Solutions></Data></Project></AutoCut>",
                "plan_info": [
                    {
                        "material_info": {
                            "cut_length": 5.02,
                            "cut_sum": 5,
                            "cut_time": 1.1,
                            "item_num": 2,
                            "material": "18MM_PLATE",
                            "program_num": 1,
                            "rate": 0.02229,
                            "run_program_num": 1,
                            "sum_area": 2.98,
                            "sum_cost": 103.67,
                            "sum_plate_num": 1,
                            "sum_used_area": 0.07
                        },
                        "material_name": "18MM_PLATE",
                        "problem_id": 1
                    }
                ],
                "plan_name": "方案3"
            },
            {
                "cut_file": "<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?><AutoCut ver=\"100\"><Project Name=\"订单\" CutTime=\"999.99\" Selected=\"-1\" ApplictionVer=\"1.0.0\" Update=\"2020-4-22 11:14:00\"><Data Class=\"3\" TotalUnit=\"1000000\" Type=\"18.0_18MM_PLATE\" Ply=\"18.0\" Grain=\"True\"><Objective Type=\"Shape\" Count=\"1\"><Shape X=\"60.0\" Y=\"553.0\" Turn=\"True\" Count=\"1\" Name=\"底板\" TLType=\"18MM_PLATE_18.0mm\" FH=\"18.0\" item_code=\"小板标识\" order_code=\"订单号\" plan_code=\"批次号\"/></Objective><Substitute Type=\"Shape\" Count=\"1\"><Shape X=\"60.0\" Y=\"553.0\" Turn=\"True\" Count=\"1\" Name=\"底板\" TLType=\"18MM_PLATE_18.0mm\" FH=\"18.0\" item_code=\"小板标识\" order_code=\"订单号\" plan_code=\"批次号\"/></Substitute><Condition Type=\"Shape\" Count=\"1\"><Shape Name=\"18MM_PLATE\" X=\"2440.0\" Y=\"1220.0\" Turn=\"True\" Sx=\"10.0\" Sy=\"10.0\" Count=\"9999\"/></Condition><Solutions Selected=\"0\"><Solution SolverName=\"排料名称\" SolveGap=\"4.4\" SheetCounts=\"1\" SumUnitArea=\"66360.0\" SumSheetArea=\"2976800.0\" SumSpareArea=\"2910440.0\"><Layouts><Layout ID=\"0\" SheetID=\"0\" Count=\"1\" Cut=\"False\" X=\"2440.0\" Y=\"1220.0\" UnitArea=\"66360.0\" SheetArea=\"2976800.0\" SpareArea=\"2910440.0\"><Part X=\"1212.2\" Y=\"2432.2\" Px=\"7.8\" Py=\"7.8\"><Part X=\"2432.2\" Y=\"60.0\" Px=\"7.8\" Py=\"7.8\"><Part X=\"60.0\" Y=\"553.0\" Px=\"7.8\" Py=\"7.8\" Turn=\"False\" UID=\"0\" BID=\"0\" Angle=\"90\"/><Substitute X=\"60.0\" Y=\"553.0\" Px=\"565.2\" Py=\"7.8\" Turn=\"False\" SID=\"0\" BID=\"0\" Angle=\"90\"/></Part></Part></Layout></Layouts></Solution></Solutions></Data></Project></AutoCut>",
                "plan_info": [
                    {
                        "material_info": {
                            "cut_length": 5.02,
                            "cut_sum": 5,
                            "cut_time": 1.1,
                            "item_num": 2,
                            "material": "18MM_PLATE",
                            "program_num": 1,
                            "rate": 0.02229,
                            "run_program_num": 1,
                            "sum_area": 2.98,
                            "sum_cost": 103.67,
                            "sum_plate_num": 1,
                            "sum_used_area": 0.07
                        },
                        "material_name": "18MM_PLATE",
                        "problem_id": 1
                    }
                ],
                "plan_name": "方案4"
            }
        ]
    },
    "status": "finished",
    "task_id": "40axxxxx-701a-47cf-8b56-648xxxxxxx25"
}

父主题： 算法服务

相关文档