AI 分析
AI 分析
云端对图片或视频帧做识别与场景分析（人脸、人形、目标库及行业行为检测），由服务端调用本模块 OpenAPI。用途、与智见产品的区别见 AI 分析开发指南；能力说明见 AI 服务。
本模块为增值服务，须先通过 技术工单 或商务开通后再调接口。调用前准备好管理员 accessToken（本模块方法页均为管理员 token），并遵守 调用约定与 签名。
每个方法单独一页，URL 为 /api/{method}/。参数、示例和响应字段在方法页，不在本页重复。
接口使用顺序
先区分通用（目标库 + 人脸/人形分析）与行业（行为/场景检测）主路径；部分行业接口可选绑人形工装库，与通用链路衔接见下文。下方接口表按主题分组，不代表调用先后。
通用场景（人脸、人形与目标库）
适用于目标库管理及 faceAnalysis、humanDetect。推荐按下列步骤首次接入；维护阶段可单独调用查询/删除类接口。
| 步骤 | 做什么 | 接口 |
|---|---|---|
| 1 | 创建检测目标库（repositoryType：face 人脸库 / human 人形工装库） | createAiDetectRepository |
| 2 | （可选）确认库 ID | listAiDetectRepositoryByPage |
| 3 | 人脸检索前：向人脸库注册待比对目标（faceAnalysis 的 operation 为 2 或 3 时需要） | addAiDetectTarget |
| 4 | （可选）核对已注册目标 | listAiDetectTarget |
| 5 | 上传图片做分析：仅属性可 operation: 1（可跳过步骤 3–4）；检索/组合见方法页；人形检测通常直接调 humanDetect（不要求库内已有目标） | faceAnalysis · humanDetect |
| 6 | （可选）清理目标或整库 | deleteAiDetectTarget · deleteAiDetectRepository |
operation、检测区域与多库检索参数见 使用云端 AI。repositoryType: human 的库还可供部分行业接口引用（见下节）。
行业场景（行为与场景检测）
默认路径：开通对应能力后，选定一种 *Detect，每次请求携带图片（type / content）与检测区域等参数直接调用，接口之间无固定先后。
与人形工装库衔接（可选，非全部行业接口都需要）：absenceDetect、workwearDetect、heatmapDetect 等可传 repositoryId 或 excludeRepositoryIds（人形工装库须先按通用场景步骤 1–4 创建 human 库并 注册目标）。抽烟、玩手机、货架、垃圾满溢等通常无需目标库。
| 步骤 | 做什么 | 说明 |
|---|---|---|
| 1 | 确认要用的行业能力 | 见下方「行业场景」接口表 |
| 2 | 若该接口支持且业务需要工装库比对 | 先建 human 库并注册目标，再调行业 API |
| 3 | 调对应 OpenAPI | 参数与图片格式以该 method 页为准 |
选型与公共参数见 使用行业场景 AI。
与 AI 智见区分
AI 智见 为另一条产品线，HTTP 在 AI 智见 API，不走本模块 /api/ai/ 上表顺序。智见接入见 开通与管理 AI 智见。
通用场景（人脸、人形与目标库）
行业场景
面向连锁零售、明厨亮灶等的行为与场景分析：
| 接口 | 说明 |
|---|---|
| smokingDetect：抽烟检测 | 抽烟检测 |
| phoneUsingDetect：玩手机检测 | 玩手机检测 |
| shelfStatusDetect：货架状态检测 | 货架状态 |
| trashOverflowDetect：垃圾满溢检测 | 垃圾满溢 |
| absenceDetect：离岗检测 | 离岗检测 |
| workwearDetect：工装检测 | 工装检测 |
| heatmapDetect：热力数据分析 | 热力数据 |