暖通识别预处理任务创建

接口概述

根据一个或多个图框 ID 创建暖通识别预处理任务。接口采用异步处理方式，请求成功后立即返回任务 ID，暖通图纸的预处理解析将在后台继续执行。

预处理任务执行成功后，其返回的任务 ID 将作为创建暖通构件识别任务时的 heatingPreTaskId 参数使用。

调用本接口前，应先完成 DWG 图纸基本信息识别，并从图框基本信息结果中获取 frameId。

请求地址

POST /cv/heating_cv/createPreTask

请求头

参数	必填	说明
apiKey	是	API 访问凭证，值为 YOUR_API_KEY
Content-Type	是	application/json

请求参数

参数	类型	必填	说明
frameIds	Array<String>	是	待预处理的图框唯一标识列表，取自图框基本信息结果

请求示例

curl -X POST "https://openapi.bangtu-ai.com/openApi/cv/heating_cv/createPreTask" \
  -H "apiKey: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"frameIds":["frame-001","frame-002"]}'

返回结果

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "1900123456789012345",
    "status": "RUNNING",
    "type": "HEATING_PRE_CV",
    "createTime": "2026-07-20T17:06:00.000+08:00",
    "endTime": null,
    "logs": [
      {
        "message": "暖通识图预处理开始...",
        "time": "2026-07-20 17:06:00"
      }
    ]
  },
  "timestamp": 1784538360000
}

返回字段

字段	类型	说明
code	Number	通用响应码，200 表示成功，500 表示失败
message	String	响应信息
data	Object | null	创建成功后的任务信息；请求失败时为 null
timestamp	Number	服务端响应时间戳，单位为毫秒

data 字段

字段	类型	说明
taskId	String	暖通预处理任务的唯一标识，后续作为 heatingPreTaskId 传入暖通构件识别任务创建接口
status	String	当前任务状态；创建成功时为 RUNNING
type	String	任务类型；暖通预处理任务固定为 HEATING_PRE_CV
createTime	String	任务创建时间
endTime	String | null	任务结束时间；任务刚创建时为 null
logs	Array	任务执行日志列表

响应码

code	说明
200	请求成功
500	请求失败

任务状态

状态	说明
RUNNING	任务执行中
SUCCESS	任务执行完成，可继续创建暖通构件识别任务
FAILED	任务执行失败

异步调用流程

1. 创建 DWG 图纸基本信息识别任务，并等待任务执行成功。
2. 获取图框基本信息结果，从中选择需要预处理的 frameId。
3. 调用本接口创建暖通预处理任务，并保存返回的 taskId（即 heatingPreTaskId）。
4. 使用任务状态查询接口，每隔 3 至 5 秒查询一次任务状态。
5. 状态变为 SUCCESS 后，调用暖通构件识别任务创建接口继续识别；状态变为 FAILED 时停止查询并查看任务日志。

注意事项

• frameIds 必须来自已经成功完成的图纸基本信息识别结果。
• 一次请求可传入多个 frameId，其预处理结果将被复用。
• 本接口返回成功只表示任务创建成功，不表示预处理已经完成。
• 返回的 taskId 应按字符串保存，不要转换为数字，避免长整型精度丢失。
• 图框不存在时，任务无法创建并返回失败信息。