建筑构件识别任务创建

接口概述

根据图框 ID 创建建筑构件识别任务。接口采用异步处理方式，请求成功后立即返回任务 ID，门、窗、空间、轴网等建筑构件识别将在后台继续执行。

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

请求地址

POST /cv/building_cv/createTask

请求头

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

请求参数

参数	类型	必填	说明
frameId	String	是	待识别图框的唯一标识，取自图框基本信息结果

请求示例

curl -X POST "https://openapi.bangtu-ai.com/openApi/cv/building_cv/createTask" \
  -H "apiKey:  YOUR_API_KEY" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  --data-urlencode "frameId=frame-001"

返回结果

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "1900123456789012346",
    "status": "RUNNING",
    "type": "BUILDING_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	服务端响应时间戳，单位为毫秒

响应码

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

data 字段

字段	类型	说明
taskId	String	建筑构件识别任务的唯一标识
status	String	当前任务状态；创建成功时为 RUNNING
type	String	任务类型；建筑构件识别固定为 BUILDING_CV
createTime	String	任务创建时间
endTime	String | null	任务结束时间；任务刚创建时为 null
logs	Array	任务执行日志列表

异步调用流程

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

注意事项

• frameId 必须来自已经成功完成的图纸基本信息识别结果。
• 每次调用只为一个图框创建任务；多个图框需要分别调用本接口。
• 本接口返回成功只表示任务创建成功，不表示建筑构件识别已经完成。
• 返回的 taskId 应按字符串保存，不要转换为数字，避免长整型精度丢失。
• 图框不存在时，任务无法创建并返回失败信息。