电气构件识别任务创建

接口概述

根据电气预处理任务 ID 与图框 ID 创建电气构件识别任务。接口采用异步处理方式，请求成功后立即返回任务 ID，配电箱、灯具、插座、桥架、消防电气设备等电气构件识别将在后台继续执行。

调用本接口前，应先完成 DWG 图纸基本信息识别与电气识别预处理任务创建，并从中获取 electricalPreTaskId 和 frameId。

请求地址

POST /cv/electrical_cv/createTask

请求头

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

请求参数

参数	类型	必填	说明
electricalPreTaskId	String	是	电气预处理任务 ID，取自电气识别预处理任务创建接口返回的 taskId
frameId	String	是	待识别图框的唯一标识，取自图框基本信息结果

请求示例

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

返回结果

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "1900123456789012346",
    "status": "RUNNING",
    "type": "ELECTRICAL_CV",
    "createTime": "2026-07-20T17:06:00.000+08:00",
    "endTime": null,
    "logs": [
      {
        "message": "电气识图预处理完成,等待执行下一步...",
        "time": "2026-07-20 17:06:05"
      }
    ]
  },
  "timestamp": 1784538360000
}

返回字段

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

data 字段

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

响应码

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

异步调用流程

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

注意事项

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