API文档目录

人脸图像识别

单张人脸图片检测建模

  • 接口说明

从图片中检测出人脸信息，输出结构化属性和模型，输出人脸目标框，同步返回模型。可以在【人脸应用服务->人脸查询】中使用模型数据进行以脸搜脸，例如【名单库以脸搜脸】、【抓拍库以脸搜脸】。

  • 接口版本

v1

  • 接口地址

/api/aibasic/v1/face/imageDetectionAndModeling

  • 请求方法

POST

  • 数据提交方式

application/json

  • 输入参数
字段名 类型 必填 描述 示例
 imageUrl String false 图片访问地址（imageUrl与imageData二选一填写，但当两者都存在时默认使用imageUrl(Url需要进行encode编码，防止出现特殊字符)。图片像素在256*256-900w内，文件大小在128字节-4M内。图片类型限制为：png、jpg/jpeg、bmp） https://ip:port/kms/services/rest/CRL/getDocumentPreviewFile?token=0d65c57effffffff4c34a16891f84e7b&id=68a501a234ec4537b599706e126a5152
 imageData String false 图片数据通过Base64编码后的字符串（imageUrl与imageData二选一填写，但当两者都存在时默认使用imageUrl。图片像素在256*256-900w内，文件大小在128字节-4M内。图片类型限制为：png、jpg/jpeg、bmp） /9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAA
 returnAttributes Boolean false 是否返回年龄段、是否带眼睛等人脸属性（true-返回，false-不返回，默认false） false
  • 入参举例
{
   “imageData”: “/9j/4AAQSkZJRgABAQEAXgBeAAD/2wBDAAIBAQIBAQICAgICAgICAwUDAwMDAwYEBAMFBwYHBwcGBwcICQsJCAgKCAcHCg0KCgsMDAwMBwkODw0MDgsMDAz/2wBDAQICAgMDAwYDAwYMCAcIDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAz/wAARCAAPAA8DASIAAhEBAxEB/8QAHwAAAQUBAQEBAQEAAAAAAAAAAAECAwQFBgcICQoL/8QAtRAAAgEDAwIEAwUFBAQAAAF9AQIDAAQRBRIhMUEGE1FhByJxFDKBkaEII0KxwRVS0fAkM2JyggkKFhcYGRolJicoKSo0NTY3ODk6Q0RFRkdISUpTVFVWV1hZWmNkZWZnaGlqc3R1dnd4eXqDhIWGh4iJipKTlJWWl5iZmqKjpKWmp6ipqrKztLW2t7i5usLDxMXGx8jJytLT1NXW19jZ2uHi4+Tl5ufo6erx8vP09fb3+Pn6/8QAHwEAAwEBAQEBAQEBAQAAAAAAAAECAwQFBgcICQoL/8QAtREAAgECBAQDBAcFBAQAAQJ3AAECAxEEBSExBhJBUQdhcRMiMoEIFEKRobHBCSMzUvAVYnLRChYkNOEl8RcYGRomJygpKjU2Nzg5OkNERUZHSElKU1RVVldYWVpjZGVmZ2hpanN0dXZ3eHl6goOEhYaHiImKkpOUlZaXmJmaoqOkpaanqKmqsrO0tba3uLm6wsPExcbHyMnK0tPU1dbX2Nna4uPk5ebn6Onq8vP09fb3+Pn6/9oADAMBAAIRAxEAPwD9DP8AgrOdL+N37P39k+MlsdS+HMus2rapod19ohj1NUikaNJJLXbcqq3PkyjyZo2LQqGJjLo/pn7I/wATfEel+B7JtW1mPWtAvH8/RALdEeDSTBH9kiO2OM7lGSS+5ueWNeqeM/hLouv6JP4a1jRdP1jw/eKpf7bBFOkrK4kG+NlIYhl4JHAA9M1p6bYt4ihh077Da/2PboIS6KqpaBR8saxnsNqj5eMEelR9WfP7Xmduxt7aLpez5Ve+5//Z”,
   “returnAttributes”: true
}
  • 返回值
参数名称 数据类型 属性描述 是否必填 示例
 code String 返回码（0表示成功，其他表示失败） false 0
 msg String 返回信息 false success
 data Object 返回数据 false
  total Number 总条数 false 1
  list Array 目标人脸及模型信息 false
   list[0] Object false
    modelData String 模型数据，可以在【人脸应用服务->人脸查询】中使用模型数据进行以脸搜脸，例如【名单库以脸搜脸】、【抓拍库以脸搜脸】。 false data
    faceRect Object 人脸小图矩形框（用于参数建模），该字段具体使用方式参考【目标框位置坐标说明】。 false
     height Number 高度（取值范围[0,1]） false 1
     width Number 宽度（取值范围[0,1]） false 1
     x Number x坐标（取值范围[0,1]） false 0
     y Number y坐标（取值范围[0,1]） false 0
    faceMark Object 人脸特征区域 false
     leftEye Object 左眼位置 false
      x Number x坐标（取值范围[0,1]） false 0.13
      y Number y坐标（取值范围[0,1]） false 0.87
     rightEye Object 右眼位置 false
      x Number x坐标（取值范围[0,1]） false 0.78
      y Number y坐标（取值范围[0,1]） false 0.5
     noseTip Object 鼻尖位置 false
      x Number x坐标（取值范围[0,1]） false 0.78
      y Number y坐标（取值范围[0,1]） false 0.5
     leftMouth Object 左嘴角位置 false
      x Number x坐标（取值范围[0,1]） false 0.78
      y Number y坐标（取值范围[0,1]） false 0.5
     rightMouth Object 右嘴角位置 false
      x Number x坐标（取值范围[0,1]） false 0.78
      y Number y坐标（取值范围[0,1]） false 0.5
    recommendFaceRect Object 人脸区域推荐位置（人脸小图矩形框只能刚好标定出人脸，不适合作为抠图展示。用于抠图时，需在人脸小图矩形框基础上向外放大。），该字段具体使用方式参考【目标框位置坐标说明】。 false
     height Number 高度（取值范围[0,1]） false 1
     width Number 宽度（取值范围[0,1]） false 1
     x Number x坐标（取值范围[0,1]） false 0
     y Number y坐标（取值范围[0,1]） false 0
    facePose Object 人脸角度 false
     pitch Number 平面外上下俯仰角（人脸朝上为正, 取值范围: [-90, 90], 若无效时此项不存在, float类型） false 0.998
     yaw Number 平面外左右偏转角（人脸朝左为正, 取值范围: [-90, 90], 若无效时此项不存在, float类型） false 0.876
     roll Number 平面内旋转角（人脸顺时针旋转为正, 取值范围: [-90, 90], 若无效时此项不存在, float类型） false 0.623
    ageGroup String 年龄段(unknown-未知，child-少年，young-青年，middle-中年，old-老年，取值参考【数据字典】，typeCode为common.human_ageGroup) false old
    ageGroupName String 年龄段名称 false 老年
    gender String 性别(unknown-未知，male-男，female-女，取值参考【数据字典】，typeCode为common.human_gender) false male
    genderName String 性别名称 false 男
    glass String 是否戴眼镜(unknown-未知，yes-是，no-否，取值参考【数据字典】，typeCode为common.human_glass) false yes
    glassName String 是否戴眼镜说明 false 是
    smile String 是否微笑(unknown-未知，yes-是，no-否，取值参考【数据字典】，typeCode为common.human_smile) false yes
    smileName String 是否微笑说明 false 是
    ethnic String 是否少数民族(unknown-未知，yes-是，no-否，取值参考【数据字典】，typeCode为common.human_ethnic) false yes
    ethnicName String 是否少数民族说明 false 是
  • 返回值举例
{
   “code”: “0”,
   “msg”: “success”,
   “data”: {
     “total”: 1,
     “list”: [
       {
         “modelData”: “AwAAAGAgggSAAP8HFQED+f8F8/7//QX6/v70+RIDAhAQAQv+/enw+/r5/hcaCwf2+AsL/AL0/v8CCBLzAQwB9QUF+gHu/A8CCADqAfD1CgkO7gYO+QkL7gUT+/wAAgQQD/4JCuzl/w70BAUS///9BfgV8Ant6Pv2Gv8Q8gkA+gcO8ff9BgP/Fvr+YEAAAAAAAABZIIIEgAA7ABAJOAATAAAPGgQOABYGIBYjBh8wBgATEgEMDAAMFA0HIRYADQYDCwAGBRkKBhQHBzcCHw8pEAEgPg4AARwXJw8KJREJAAYPBw8VLhkSEAUCDioTFxsRBwArAB4qCgkHAAEHJhE4Ew4aFwYRBgwNBQooDhsaHQ8IIAYVGRckDllAAAAAAAAAUCCCBIAAEAAVAAAcPgAANgAOAAAEFQQxABAACAUICQI9AAIdHQAAEAUoAxgACAlJECUAAAIYIggAAAAbAAAmAAsgDwAFAAAAHAASAC8jDAAAIQAJBkUlExYYAQATAAUACA0AMwAANgAFGSYAMgAAAAAbGQASAAAHHDgGAAEBASQAAAADGyA=”,
         “faceRect”: {
           “height”: 1,
           “width”: 1,
           “x”: 0,
           “y”: 0
        },
         “faceMark”: {
           “leftEye”: {
             “x”: 0.13,
             “y”: 0.87
          },
           “rightEye”: {
             “x”: 0.78,
             “y”: 0.5
          },
           “noseTip”: {
             “x”: 0.78,
             “y”: 0.5
          },
           “leftMouth”: {
             “x”: 0.78,
             “y”: 0.5
          },
           “rightMouth”: {
             “x”: 0.78,
             “y”: 0.5
          }
        },
         “recommendFaceRect”: {
           “height”: 1,
           “width”: 1,
           “x”: 0,
           “y”: 0
        },
         “facePose”: {
           “pitch”: 0.998,
           “yaw”: 0.876,
           “roll”: 0.623
        },
         “ageGroup”: “old”,
         “ageGroupName”: “老年”,
         “gender”: “male”,
         “genderName”: “男”,
         “glass”: “yes”,
         “glassName”: “是”,
         “smile”: “yes”,
         “smileName”: “是”,
         “ethnic”: “yes”,
         “ethnicName”: “是”
      }
    ]
  }
}

提交平台监控点实时视频人脸结构化分析任务

  • 接口说明

对平台指定监控点进行实时人脸分析。系统会自动从该监控点取流进行做分析，把分析后的结果存入大数据平台，可以在【智能应用服务->人脸应用服务】中进行查询、分析、统计等人脸应用使用。

  • 接口版本

v1

  • 接口地址

/api/aibasic/v1/face/submitRealtimeVideoTask

  • 请求方法

POST

  • 数据提交方式

application/json

  • 输入参数
字段名 类型 必填 描述 示例
 priority String true 任务优先级(high-高，medium-中，low-低) low
 cameraIndexCode String true 平台监控点唯一标识（根据该监控点唯一标识从系统取流，长度不大于32个字符）。可调用【资源目录服务->监控资源信息】中获取监控点相关API获取，如【分页获取监控点资源】。 90ad77d8057c43dab140b77361606927
  • 入参举例
{
   “priority”: “low”,
   “cameraIndexCode”: “90ad77d8057c43dab140b77361606927”
}
  • 返回值
参数名称 数据类型 属性描述 是否必填 示例
 code String 返回码（0表示成功，其他表示失败） false 0
 msg String 返回信息 false success
 data Object 返回数据 false
  taskId String 提交的任务ID（最大长度为64，通过该标识可以控制任务操作）。可以通过任务ID调用【智能任务暂停】、【智能任务恢复】、【智能任务删除】、【智能任务状态查询】接口对该任务进行对应操作。 false temp_301230caa5534d0d9de6f9c020936019
  • 返回值举例
{
   “code”: “0”,
   “msg”: “success”,
   “data”: {
     “taskId”: “temp_301230caa5534d0d9de6f9c020936019”
  }
}

提交平台监控点录像视频人脸结构化分析任务

  • 接口说明

对平台指定监控点的存储录像进行人脸分析。系统会自动从该监控点取流进行做分析，把分析后的结果存入大数据平台，可以在【智能应用服务->人脸应用服务】中进行查询、分析、统计等人脸应用使用。

  • 接口版本

v1

  • 接口地址

/api/aibasic/v1/face/submitRecordVideoTask

  • 请求方法

POST

  • 数据提交方式

application/json

  • 输入参数
字段名 类型 必填 描述 示例
 beginTime String true 录像开始时间（IOS8601格式yyyy-MM-dd’T’HH:mm:ss.SSSzzz） 2017-06-15T00:00:00.000+08:00
 endTime String true 录像结束时间（IOS8601格式yyyy-MM-dd’T’HH:mm:ss.SSSzzz） 2017-06-15T00:30:00.000+08:00
 speed Number true 加速比（取值范围：1-40） 1
 priority String true 任务优先级(high-高，medium-中，low-低) low
 cameraIndexCode String true 平台监控点唯一标识（根据该监控点唯一标识从系统取流，长度不大于32个字符）。可调用【资源目录服务->监控资源信息】中获取监控点相关API获取，如【分页获取监控点资源】。 1c8d8fbd83184fcc870144393b5a547c
  • 入参举例
{
   “beginTime”: “2017-06-15T00:00:00.000+08:00”,
   “endTime”: “2017-06-15T00:30:00.000+08:00”,
   “speed”: 1,
   “priority”: “low”,
   “cameraIndexCode”: “1c8d8fbd83184fcc870144393b5a547c”
}
  • 返回值
参数名称 数据类型 属性描述 是否必填 示例
 code String 返回码（0表示成功，其他表示失败） false 0
 msg String 返回信息 false success
 data Object 返回数据 false
  taskId String 提交的任务ID（最大长度为64，通过该标识可以控制任务操作）。可以通过任务ID调用【智能任务暂停】、【智能任务恢复】、【智能任务删除】、【智能任务状态查询】接口对该任务进行对应操作。 false temp_301230caa5534d0d9de6f9c020936019
  • 返回值举例
{
   “code”: “0”,
   “msg”: “success”,
   “data”: {
     “taskId”: “temp_301230caa5534d0d9de6f9c020936019”
  }
}

提交外部实时视频人脸结构化分析任务

  • 接口说明

可以基于提供的外部的实时视频RTSP标准协议取流url，下发人脸录像视频分析任务。视频数据格式为H.264/H.265。系统会自动从url取流做视频分析，把分析后的结果存入大数据平台，可以在【智能应用服务->人脸应用服务】中进行查询、分析、统计等人脸应用使用。

  • 接口版本

v1

  • 接口地址

/api/aibasic/v1/face/submitOuterRealtimeVideoTask

  • 请求方法

POST

  • 数据提交方式

application/json

  • 输入参数
字段名 类型 必填 描述 示例
 priority String true 任务优先级(high-高，medium-中，low-低) low
 streamUrl String true rtsp取流地址（长度不大于1024个字符） rtsp://ip:port/EUrl/nnYI0QE
 sourceId String true 视频源的唯一标识，最长32位。分析结果记录会带上该值，后续可以通过该值进行精确查询（和平台监控点唯一编号一样使用）。 若多个录像片段需要用同一个唯一标识检索，则多次下发任务时，该字段赋值同一个id即可。 1c8d8fbd83184fcc870144393b5a547c
 sourceName String true 视频源的名称，最长255位。分析结果会带上该值，后续可以在结果中直接显示视频源名称(和平台监控点名称唯一使用)。 新世纪网吧一楼监控摄像头
 longitude String false 视频源的坐标经度，分析结果会带上该值，可在地图上进行定位和实现轨迹功能。WGS84坐标系，最长32位 120.12254
 latitude String false 视频源的坐标纬度，分析结果会带上该值，可在地图上进行定位和实现轨迹功能。WGS84坐标系，最长32位 32.2154
  • 入参举例
{
   “priority”: “low”,
   “streamUrl”: “rtsp://ip:port/EUrl/nnYI0QE”,
   “sourceId”: “1c8d8fbd83184fcc870144393b5a547c”,
   “sourceName”: “新世纪网吧一楼监控摄像头”,
   “longitude”: “120.12254”,
   “latitude”: “32.2154”
}
  • 返回值
参数名称 数据类型 属性描述 是否必填 示例
 code String 返回码（0表示成功，其他表示失败） false 0
 msg String 返回信息 false success
 data Object 返回数据 false
  taskId String 提交的任务ID（最大长度为64，通过该标识可以控制任务操作）。可以通过任务ID调用【智能任务暂停】、【智能任务恢复】、【智能任务删除】、【智能任务状态查询】接口对该任务进行对应操作。 false temp_301230caa5534d0d9de6f9c020936019
  • 返回值举例
{
   “code”: “0”,
   “msg”: “success”,
   “data”: {
     “taskId”: “temp_301230caa5534d0d9de6f9c020936019”
  }
}

提交外部录像视频人脸结构化分析任务

  • 接口说明

可以基于提供的外部的录像视频RTSP标准协议取流url，下发人脸录像视频分析任务。视频数据格式为H.264/H.265。
系统会自动从url取流，做人脸分析，把分析后的结果存入大数据平台，可以在【智能应用服务->人脸应用服务】中进行查询、分析、统计等人脸应用使用。

  • 接口版本

v1

  • 接口地址

/api/aibasic/v1/face/submitOuterRecordVideoTask

  • 请求方法

POST

  • 数据提交方式

application/json

  • 输入参数
字段名 类型 必填 描述 示例
 beginTime String true 录像开始时间（IOS8601格式yyyy-MM-dd’T’HH:mm:ss.SSSzzz） 2017-06-15T00:00:00.000+08:00
 endTime String true 录像结束时间（IOS8601格式yyyy-MM-dd’T’HH:mm:ss.SSSzzz） 2017-06-15T00:30:00.000+08:00
 priority String true 任务优先级(high-高，medium-中，low-低) low
 streamUrl String true rtsp取流地址（长度不大于1024个字符） rtsp://ip:port/EUrl/nnYI0QE
 sourceId String true 视频源的唯一标识，最长32位。分析结果记录会带上该值，后续可以通过该值进行精确查询（和平台监控点唯一编号一样使用）。 若多个录像片段需要用同一个唯一标识检索，则多次下发任务时，该字段赋值同一个id即可。 1c8d8fbd83184fcc870144393b5a547c
 sourceName String true 视频源的名称，最长255位。分析结果会带上该值，后续可以在结果中直接显示视频源名称(和平台监控点名称唯一使用)。 新世纪网吧一楼监控摄像头录像_2018.08.09_00:00-04:00
 speed Number true 加速比（取值范围：1-40） 10
 longitude String false 视频源的坐标经度，分析结果会带上该值，可在地图上进行定位和实现轨迹功能。WGS84坐标系，最长32位 120.12254
 latitude String false 视频源的坐标纬度，分析结果会带上该值，可在地图上进行定位和实现轨迹功能。WGS84坐标系，最长32位 32.2154
  • 入参举例
{
   “beginTime”: “2017-06-15T00:00:00.000+08:00”,
   “endTime”: “2017-06-15T00:30:00.000+08:00”,
   “priority”: “low”,
   “streamUrl”: “rtsp://ip:port/EUrl/nnYI0QE”,
   “sourceId”: “1c8d8fbd83184fcc870144393b5a547c”,
   “sourceName”: “新世纪网吧一楼监控摄像头录像_2018.08.09_00:00-04:00”,
   “speed”: 10,
   “longitude”: “120.12254”,
   “latitude”: “32.2154”
}
  • 返回值
参数名称 数据类型 属性描述 是否必填 示例
 code String 返回码（0表示成功，其他表示失败） false 0
 msg String 返回信息 false success
 data Object 返回数据 false
  taskId String 提交的任务ID（最大长度为64，通过该标识可以控制任务操作）。可以通过任务ID调用【智能任务暂停】、【智能任务恢复】、【智能任务删除】、【智能任务状态查询】接口对该任务进行对应操作。 false temp_301230caa5534d0d9de6f9c020936019
  • 返回值举例
{
   “code”: “0”,
   “msg”: “success”,
   “data”: {
     “taskId”: “temp_301230caa5534d0d9de6f9c020936019”
  }
}

人体图像识别

单张人体图片检测建模

  • 接口说明

从图片中检测出人体信息，输出结构化属性和模型，输出人体目标框，同步返回结果。可以【人体应用服务->人体查询】中使用模型数据进行以人搜人，例如【以人搜人】、【提交以人搜人任务】。

  • 接口版本

v1

  • 接口地址

/api/aibasic/v1/body/imageDetectionAndModeling

  • 请求方法

POST

  • 数据提交方式

application/json

  • 输入参数
字段名 类型 必填 描述 示例
 imageUrl String false 图片访问地址（imageUrl与imageData二选一填写，但当两者都存在的时候,默认使用imageUrl(Url需要进行encode编码，防止出现特殊字符)。图片像素在256*256-900w内，文件大小在128字节-4M内。图片类型限制为：png、jpg/jpeg、bmp） https://ip:port/kms/services/rest/CRL/getDocumentPreviewFile?token=0d65c57effffffff4c34a16891f84e7b&id=68a501a234ec4537b599706e126a5152
 imageData String false 图片数据通过Base64编码后的字符串（imageUrl与imageData二选一填写,但当两者都存在的时候,默认使用imageUrl。图片像素在256*256-900w内，文件大小在128字节-4M内。图片类型限制为：png、jpg/jpeg、bmp） /9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAA
 returnAttributes Boolean false 是否返回上衣类型、年龄段等人体属性（true-返回，false-不返回，默认false） false
  • 入参举例
{
   “imageUrl”: “https://ip:port/kms/services/rest/CRL/getDocumentPreviewFile?token=0d65c57effffffff4c34a16891f84e7b&id=68a501a234ec4537b599706e126a5152”,
   “imageData”: “/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAA”,
   “returnAttributes”: true
}
  • 返回值
参数名称 数据类型 属性描述 是否必填 示例
 code String 返回码（0表示成功，其他表示失败） false 0
 msg String 返回信息 false success
 data Object 返回数据 false
  total Number 总条数 false 1
  list Array List数据 false
   list[0] Object 人体信息 false
    bodyRect Object 人体识别区域（图片检测后返回的区域），该字段具体使用方式参考【目标框位置坐标说明】。 false
     height Number 高度，取值范围[0,1] false 1
     width Number 宽度，取值范围[0,1] false 1
     x Number x坐标，取值范围[0,1] false 0
     y Number y坐标，取值范围[0,1] false 0
    modelData String 目标模型数据。可以在【人体应用服务->人体查询】中使用模型数据进行以人搜人，例如【以人搜人】、【提交以人搜人任务】。 false data
    ageGroup String 年龄段（unknown-未知，child-少年，young-青年，middle-中年，old-老年。取值参考【数据字典】，typeCode为common.human_ageGroup） false child
    ageGroupName String 年龄段说明 false 少年
    gender String 性别（unknown-未知，male-男，female-女。取值参考【数据字典】，typeCode为common.human_gender） false male
    genderName String 性别说明 false 男
    glass String 是否戴眼镜（unknown-未知，yes-是，no-否。取值参考【数据字典】，typeCode为common.human_glass） false yes
    glassName String 是否戴眼镜说明 false 是
    bag String 是否背包（unknown-未知，yes-是，no-否。取值参考【数据字典】，typeCode为common.three_wheel_on_bag） false yes
    bagName String 是否背包说明 false 是
    hat String 是否戴帽子（unknown-未知，yes-是，no-否）取值参考【数据字典】，typeCode为common.human_hat false yes
    hatName String 是否戴帽子说明 false 是
    mask String 是否戴口罩（unknown-未知，yes-是，no-否）,取值参考【数据字典】，typeCode为common.three_wheel_mask false yes
    maskName String 是否戴口罩说明 false 是
    things String 是否拎东西（unknown-未知，yes-是，no-否）取值参考【数据字典】，typeCode为common.human_things false yes
    thingsName String 是否拎东西说明 false 是
    hairStyle String 发型（unknown-未知，shortHair-短发，longHair-长发。取值参考【数据字典】，typeCode为common.three_wheel_hair_style） false shortHair
    hairStyleName String 发型说明 false 短发
    jacketType String 上衣类型（unknown-未知，shortSleeve-短袖，longSleeve-长袖。取值参考【数据字典】，typeCode为common.three_wheel_jacket） false shortSleeve
    jacketTypeName String 上衣类型说明 false 短袖
    trousersType String 下衣类型（unknown-未知，shortTrousers-短裤，longTrousers-长裤，skirt-裙子）取值参考【数据字典】，typeCode为common.human_trousers_type false shortTrousers
    trousersTypeName String 下衣类型说明 false 短裤
    jacketColor String 上衣颜色（取值参考【数据字典】，typeCode为common.three_wheel_jacket_color） false white
    jacketColorName String 上衣颜色说明 false 白
    trousersColor String 下衣颜色（具体取值详见属性参数取值字典）取值参考【数据字典】，typeCode为common.human_trousers_color false white
    trousersColorName String 下衣颜色说明 false 白
    ride String 是否骑车（unknown-未知，yes-是，no-否）取值参考【数据字典】，typeCode为common.human_ride false yes
    rideName String 是否骑车说明 false 是
    cyclingType String 骑车类型（unknown-未知，bicycle-自行车，motorcycle-摩托车/电动车，threeWheelVehicle-三轮车）取值参考【数据字典】，typeCode为common.three_wheel_type false bicycle
    cyclingTypeName String 骑车类型说明 false 自行车
    cyclingPersonNumber String 骑车人数（unknown-未知，onePerson-单人，multiplePersons-多人）取值参考【数据字典】，typeCode为common.three_wheel_driver_count false onePerson
    cyclingPersonNumberName String 骑车人数说明 false 单人
  • 返回值举例
{
   “code”: “0”,
   “msg”: “success”,
   “data”: {
     “total”: 1,
     “list”: [
       {
         “bodyRect”: {
           “height”: 1,
           “width”: 1,
           “x”: 0,
           “y”: 0
        },
         “modelData”: “data”,
         “ageGroup”: “child”,
         “ageGroupName”: “少年”,
         “gender”: “male”,
         “genderName”: “男”,
         “glass”: “yes”,
         “glassName”: “是”,
         “bag”: “yes”,
         “bagName”: “是”,
         “hat”: “yes”,
         “hatName”: “是”,
         “mask”: “yes”,
         “maskName”: “是”,
         “things”: “yes”,
         “thingsName”: “是”,
         “hairStyle”: “shortHair”,
         “hairStyleName”: “短发”,
         “jacketType”: “shortSleeve”,
         “jacketTypeName”: “短袖”,
         “trousersType”: “shortTrousers”,
         “trousersTypeName”: “短裤”,
         “jacketColor”: “white”,
         “jacketColorName”: “白”,
         “trousersColor”: “white”,
         “trousersColorName”: “白”,
         “ride”: “yes”,
         “rideName”: “是”,
         “cyclingType”: “bicycle”,
         “cyclingTypeName”: “自行车”,
         “cyclingPersonNumber”: “onePerson”,
         “cyclingPersonNumberName”: “单人”
      }
    ]
  }
}

提交平台监控点实时视频人体结构化分析任务

  • 接口说明

对平台指定监控点进行实时人体分析。系统会自动从该监控点取流进行做分析，把分析后的结果存入大数据平台，可以在【智能应用服务->人体应用服务】中进行查询、分析、统计等人脸应用使用。

  • 接口版本

v1

  • 接口地址

/api/aibasic/v1/body/submitRealtimeVideoTask

  • 请求方法

POST

  • 数据提交方式

application/json

  • 输入参数
字段名 类型 必填 描述 示例
 priority String true 任务优先级（high-高,medium-中,low-低） low
 cameraIndexCode String true 平台监控点唯一标识（长度不大于64个字符）。可调用【资源目录服务->监控资源信息】中获取监控点相关API获取，如【分页获取监控点资源】。 90ad77d8057c43dab140b77361606927
  • 入参举例
{
   “priority”: “low”,
   “cameraIndexCode”: “90ad77d8057c43dab140b77361606927”
}
  • 返回值
参数名称 数据类型 属性描述 是否必填 示例
 code String 返回码（0表示成功，其他表示失败） false 0
 msg String 返回信息 false success
 data Object 返回数据 false
  taskId String 提交的任务ID（最大长度为64，通过该标识可以控制任务操作）。可以通过任务ID调用【智能任务暂停】、【智能任务恢复】、【智能任务删除】、【智能任务状态查询】接口对该任务进行对应操作。 false temp_301230caa5534d0d9de6f9c020936019
  • 返回值举例
{
   “code”: “0”,
   “msg”: “success”,
   “data”: {
     “taskId”: “temp_301230caa5534d0d9de6f9c020936019”
  }
}

提交平台监控点录像视频结人体构化分析任务

  • 接口说明

对平台指定监控点的存储录像进行人体分析。系统会自动从该监控点取流进行做分析，把分析后的结果存入大数据平台，可以在【智能应用服务->人体应用服务】中进行查询、分析、统计等人脸应用使用。

  • 接口版本

v1

  • 接口地址

/api/aibasic/v1/body/submitRecordVideoTask

  • 请求方法

POST

  • 数据提交方式

application/json

  • 输入参数
字段名 类型 必填 描述 示例
 beginTime String true 录像开始时间（IOS8601格式yyyy-MM-dd’T’HH:mm:ss.SSSzzz） 2017-06-15T00:00:00.000+08:00
 endTime String true 录像结束时间（IOS8601格式yyyy-MM-dd’T’HH:mm:ss.SSSzzz） 2017-06-15T01:00:00.000+08:00
 speed Number true 加速比（取值范围1-40） 1
 priority String true 任务优先级（high-高，medium-中，low-低） low
 cameraIndexCode String true 平台监控点唯一标识（长度不大于64个字符）。可调用【资源目录服务->监控资源信息】中获取监控点相关API获取，如【分页获取监控点资源】。 90ad77d8057c43dab140b77361606927
  • 入参举例
{
   “beginTime”: “2017-06-15T00:00:00.000+08:00”,
   “endTime”: “2017-06-15T01:00:00.000+08:00”,
   “speed”: 1,
   “priority”: “low”,
   “cameraIndexCode”: “90ad77d8057c43dab140b77361606927”
}
  • 返回值
参数名称 数据类型 属性描述 是否必填 示例
 code String 返回码（0表示成功，其他表示失败） false 0
 msg String 返回信息 false success
 data Object 返回数据 false
  taskId String 提交的任务ID（最大长度为64，通过该标识可以控制任务操作）。可以通过任务ID调用【智能任务暂停】、【智能任务恢复】、【智能任务删除】、【智能任务状态查询】接口对该任务进行对应操作。 false temp_301230caa5534d0d9de6f9c020936019
  • 返回值举例
{
   “code”: “0”,
   “msg”: “success”,
   “data”: {
     “taskId”: “temp_301230caa5534d0d9de6f9c020936019”
  }
}

提交外部实时视频人体结构化分析任务

  • 接口说明

可以基于提供的外部的实时视频RTSP标准协议取流url，下发人体录像视频分析任务。视频数据格式为H.264/H.265。
系统会自动从url取流做视频分析，把分析后的结果存入大数据平台，可以在【智能应用服务->人体应用服务】中进行查询、分析、统计等人脸应用使用。

  • 接口版本

v1

  • 接口地址

/api/aibasic/v1/body/submitOuterRealtimeVideoTask

  • 请求方法

POST

  • 数据提交方式

application/json

  • 输入参数
字段名 类型 必填 描述 示例
 priority String true 任务优先级(high-高，medium-中，low-低) low
 streamUrl String true rtsp取流地址（长度不大于1024个字符） rtsp://ip:port/EUrl/nnYI0QE
 sourceId String true 视频源的唯一标识，最长32位。分析结果记录会带上该值，后续可以通过该值进行精确查询（和平台监控点唯一编号一样使用）。 若多个录像片段需要用同一个唯一标识检索，则多次下发任务时，该字段赋值同一个id即可。 1c8d8fbd83184fcc870144393b5a547c
 sourceName String true 视频源的名称，最长255位。分析结果会带上该值，后续可以在结果中直接显示视频源名称(和平台监控点名称唯一使用)。 新世纪网吧三楼监控摄像头
 longitude String false 视频源的坐标经度，分析结果会带上该值，可在地图上进行定位和实现轨迹功能。WGS84坐标系，最长32位 120.12254
 latitude String false 视频源的坐标纬度，分析结果会带上该值，可在地图上进行定位和实现轨迹功能。WGS84坐标系，最长32位 32.2154
  • 入参举例
{
   “priority”: “low”,
   “streamUrl”: “rtsp://ip:port/EUrl/nnYI0QE”,
   “sourceId”: “1c8d8fbd83184fcc870144393b5a547c”,
   “sourceName”: “新世纪网吧三楼监控摄像头”,
   “longitude”: “120.12254”,
   “latitude”: “32.2154”
}
  • 返回值
参数名称 数据类型 属性描述 是否必填 示例
 code String 返回码（0表示成功，其他表示失败） false 0
 msg String 返回信息 false success
 data Object 返回数据 false
  taskId String 提交的任务ID（最大长度为64，通过该标识可以控制任务操作）。可以通过任务ID调用【智能任务暂停】、【智能任务恢复】、【智能任务删除】、【智能任务状态查询】接口对该任务进行对应操作。 false temp_301230caa5534d0d9de6f9c020936019
  • 返回值举例
{
   “code”: “0”,
   “msg”: “success”,
   “data”: {
     “taskId”: “temp_301230caa5534d0d9de6f9c020936019”
  }
}

提交外部录像视频人体结构化分析任务

  • 接口说明

可以基于提供的外部的录像视频RTSP标准协议取流url，下发人体录像视频分析任务。视频数据格式为H.264/H.265。
系统会自动从url取流，做人脸分析，把分析后的结果存入大数据平台，可以在【智能应用服务->人体应用服务】中进行查询、分析、统计等人脸应用使用。

  • 接口版本

v1

  • 接口地址

/api/aibasic/v1/body/submitOuterRecordVideoTask

  • 请求方法

POST

  • 数据提交方式

application/json

  • 输入参数
字段名 类型 必填 描述 示例
 beginTime String true 录像开始时间（IOS8601格式yyyy-MM-dd’T’HH:mm:ss.SSSzzz） 2017-06-15T00:00:00.000+08:00
 endTime String true 录像结束时间（IOS8601格式yyyy-MM-dd’T’HH:mm:ss.SSSzzz） 2017-06-15T00:30:00.000+08:00
 priority String true 任务优先级(high-高，medium-中，low-低) low
 streamUrl String true rtsp取流地址（长度不大于1024个字符） rtsp://ip:port/EUrl/nnYI0QE
 sourceId String true 视频源的唯一标识，最长32位。分析结果记录会带上该值，后续可以通过该值进行精确查询（和平台监控点唯一编号一样使用）。 若多个录像片段需要用同一个唯一标识检索，则多次下发任务时，该字段赋值同一个id即可。 1c8d8fbd83184fcc870144393b5a547c
 sourceName String true 视频源的名称，最长255位。分析结果会带上该值，后续可以在结果中直接显示视频源名称(和平台监控点名称唯一使用)。 新世纪网吧三楼监控摄像头录像_2018.08.09_00:00-04:00
 speed Number true 加速比（取值范围：1-40） 10
 longitude String false 视频源的坐标经度，分析结果会带上该值，可在地图上进行定位和实现轨迹功能。WGS84坐标系，最长32位 120.12254
 latitude String false 视频源的坐标纬度，分析结果会带上该值，可在地图上进行定位和实现轨迹功能。WGS84坐标系，最长32位 32.2154
  • 入参举例
{
   “beginTime”: “2017-06-15T00:00:00.000+08:00”,
   “endTime”: “2017-06-15T00:30:00.000+08:00”,
   “priority”: “low”,
   “streamUrl”: “rtsp://ip:port/EUrl/nnYI0QE”,
   “sourceId”: “1c8d8fbd83184fcc870144393b5a547c”,
   “sourceName”: “新世纪网吧三楼监控摄像头录像_2018.08.09_00:00-04:00”,
   “speed”: 10,
   “longitude”: “120.12254”,
   “latitude”: “32.2154”
}
  • 返回值
参数名称 数据类型 属性描述 是否必填 示例
 code String 返回码（0表示成功，其他表示失败） false 0
 msg String 返回信息 false success
 data Object 返回数据 false
  taskId String 提交的任务ID（最大长度为64，通过该标识可以控制任务操作）。可以通过任务ID调用【智能任务暂停】、【智能任务恢复】、【智能任务删除】、【智能任务状态查询】接口对该任务进行对应操作。 false temp_301230caa5534d0d9de6f9c020936019
  • 返回值举例
{
   “code”: “0”,
   “msg”: “success”,
   “data”: {
     “taskId”: “temp_301230caa5534d0d9de6f9c020936019”
  }
}

车辆图像识别

单张车辆图片检测建模

  • 接口说明

从图片中检测出车辆信息，输出结构化属性和模型，输出车辆目标框，同步返回结果。可以在【车辆应用服务->车辆查询】中使用模型数据进行以脸搜脸，例如【按过车图片查找过车信息_模型比对】。

  • 接口版本

v1

  • 接口地址

/api/aibasic/v1/vehicle/imageDetectionAndModeling

  • 请求方法

POST

  • 数据提交方式

application/json

  • 输入参数
字段名 类型 必填 描述 示例
 imageUrl String false 图片访问地址（imageUrl与imageData二选一填写，但当两者都存在的时候,默认使用imageUrl(Url需要进行encode编码，防止出现特殊字符)。图片像素在256*256-900w内，文件大小在128字节-4M内。图片类型限制为：png、jpg/jpeg、bmp） https://ip:port/kms/services/rest/CRL/getDocumentPreviewFile?token=0d65c57effffffff4c34a16891f84e7b&id=68a501a234ec4537b599706e126a5152
 imageData String false 图片数据通过Base64编码后的字符串（imageUrl与imageData二选一填写,但当两者都存在的时候,默认使用imageUrl。图片像素在256*256-900w内，文件大小在128字节-4M内。图片类型限制为：png、jpg/jpeg、bmp） /9j/4AAQSkZJRgABAQEAXgBeAAD/2wBDAAIBAQIBAQICAgICAgICAwUDAwMDAwYEBAMFBwYHBwcGBwcICQsJCAgKCAcHCg0KCgsMDAwMBwkODw0MDgsMDAz/2wBDAQICAgMDAwYDAwYMCAcIDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAz/wAARCAAPAA8DASIAAhEBAxEB/8QAHwAAAQUBAQEBAQEAAAAAAAAAAAECAwQFBgcICQoL/8QAtRAAAgEDAwIEAwUFBAQAAAF9AQIDAAQRBRIhMUEGE1FhByJxFDKBkaEII0KxwRVS0fAkM2JyggkKFhcYGRolJicoKSo0NTY3ODk6Q0RFRkdISUpTVFVWV1hZWmNkZWZnaGlqc3R1dnd4eXqDhIWGh4iJipKTlJWWl5iZmqKjpKWmp6ipqrKztLW2t7i5usLDxMXGx8jJytLT1NXW19jZ2uHi4+Tl5ufo6erx8vP09fb3+Pn6/8QAHwEAAwEBAQEBAQEBAQAAAAAAAAECAwQFBgcICQoL/8QAtREAAgECBAQDBAcFBAQAAQJ3AAECAxEEBSExBhJBUQdhcRMiMoEIFEKRobHBCSMzUvAVYnLRChYkNOEl8RcYGRomJygpKjU2Nzg5OkNERUZHSElKU1RVVldYWVpjZGVmZ2hpanN0dXZ3eHl6goOEhYaHiImKkpOUlZaXmJmaoqOkpaanqKmqsrO0tba3uLm6wsPExcbHyMnK0tPU1dbX2Nna4uPk5ebn6Onq8vP09fb3+Pn6/9oADAMBAAIRAxEAPwD9DP8AgrOdL+N37P39k+MlsdS+HMus2rapod19ohj1NUikaNJJLXbcqq3PkyjyZo2LQqGJjLo/pn7I/wATfEel+B7JtW1mPWtAvH8/RALdEeDSTBH9kiO2OM7lGSS+5ueWNeqeM/hLouv6JP4a1jRdP1jw/eKpf7bBFOkrK4kG+NlIYhl4JHAA9M1p6bYt4ihh077Da/2PboIS6KqpaBR8saxnsNqj5eMEelR9WfP7Xmduxt7aLpez5Ve+5//Z
 returnAttributes Boolean false 是否返回车辆品牌、车身颜色等车辆属性（true-返回，false-不返回，默认false） false
  • 入参举例
{
   “imageData”:"/9j/4AAQSkZJRgABAQEAXgBeAAD/2wBDAAIBAQIBAQICAgICAgICAwUDAwMDAwYEBAMFBwYHBwcGBwcICQsJCAgKCAcHCg0KCgsMDAwMBwkODw0MDgsMDAz/2wBDAQICAgMDAwYDAwYMCAcIDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAz/wAARCAAPAA8DASIAAhEBAxEB/8QAHwAAAQUBAQEBAQEAAAAAAAAAAAECAwQFBgcICQoL/8QAtRAAAgEDAwIEAwUFBAQAAAF9AQIDAAQRBRIhMUEGE1FhByJxFDKBkaEII0KxwRVS0fAkM2JyggkKFhcYGRolJicoKSo0NTY3ODk6Q0RFRkdISUpTVFVWV1hZWmNkZWZnaGlqc3R1dnd4eXqDhIWGh4iJipKTlJWWl5iZmqKjpKWmp6ipqrKztLW2t7i5usLDxMXGx8jJytLT1NXW19jZ2uHi4+Tl5ufo6erx8vP09fb3+Pn6/8QAHwEAAwEBAQEBAQEBAQAAAAAAAAECAwQFBgcICQoL/8QAtREAAgECBAQDBAcFBAQAAQJ3AAECAxEEBSExBhJBUQdhcRMiMoEIFEKRobHBCSMzUvAVYnLRChYkNOEl8RcYGRomJygpKjU2Nzg5OkNERUZHSElKU1RVVldYWVpjZGVmZ2hpanN0dXZ3eHl6goOEhYaHiImKkpOUlZaXmJmaoqOkpaanqKmqsrO0tba3uLm6wsPExcbHyMnK0tPU1dbX2Nna4uPk5ebn6Onq8vP09fb3+Pn6/9oADAMBAAIRAxEAPwD9DP8AgrOdL+N37P39k+MlsdS+HMus2rapod19ohj1NUikaNJJLXbcqq3PkyjyZo2LQqGJjLo/pn7I/wATfEel+B7JtW1mPWtAvH8/RALdEeDSTBH9kiO2OM7lGSS+5ueWNeqeM/hLouv6JP4a1jRdP1jw/eKpf7bBFOkrK4kG+NlIYhl4JHAA9M1p6bYt4ihh077Da/2PboIS6KqpaBR8saxnsNqj5eMEelR9WfP7Xmduxt7aLpez5Ve+5//Z",
   “returnAttributes”: true
}
  • 返回值
参数名称 数据类型 属性描述 是否必填 示例
 code String 返回码（0表示成功，其他表示失败） false 0
 msg String 返回信息 false success
 data Object 返回数据 false
  total Number 总条数 false 1
  list Array 车辆图片检测建模结果列表 false
   list[0] Object 车辆信息 false
    vehicleRect Object 目标框（归一化矩形框坐标），该字段具体使用方式参考【目标框位置坐标说明】。 false
     height Number 高度（float，取值范围[0,1]） false 1
     width Number 宽度（float，取值范围[0,1]） false 1
     x Number x坐标（float，取值范围[0,1]） false 0
     y Number y坐标（float，取值范围[0,1]） false 0
    plateRect Object 车牌目标框，该字段具体使用方式参考【目标框位置坐标说明】。 false
     height Number 高度（float，取值范围[0,1]） false 1
     width Number 宽度（float，取值范围[0,1]） false 1
     x Number x坐标（float，取值范围[0,1]） false 0
     y Number y坐标（float，取值范围[0,1]） false 0
    modelData String 目标模型数据。可以在【车辆应用服务->车辆查询】中使用模型数据进行以脸搜脸，例如【按过车图片查找过车信息_模型比对】。 false
    plateNo String 车牌号 false 京A523A2
    plateType String 车牌类型（取值参考【数据字典】typeCode为common.plate_type） false 92TypeCivil
    plateTypeName String 车牌类型说明 false 92式民用车
    vehicleColor String 车身颜色（最大长度为32，取值参考【数据字典】typeCode为common.vehicle_color） false white
    vehicleColorName String 车身颜色说明 false 白
    vehicleType String 车辆类型（最大长度为32，值参考【数据字典】typeCode为common.vehicle_type） false truck
    vehicleTypeName String 车辆类型说明 false 拖拉机
    vehicleLogo Number 车辆主品牌（取值参考【数据字典】typeCode为ivehicle.vehicle_models_model） false 1101
    vehicleLogoName String 车辆主品牌说明 false 路虎
    vehicleSubLogo Number 车辆子品牌（取值参考【数据字典】） false 4
    vehicleSubLogoName String 车辆子品牌说明 false 揽胜
    plateColor String 车牌颜色（具体取值详见属性参数取值字典） false white
    plateColorName String 车牌颜色说明 false 白
    pilotSafebelt String 驾驶员是否系安全带（unknown-未知，yes-是，no-否，取值参考【数据字典】typeCode为common.pilot_belt_safe） false yes
    pilotSafebeltName String 驾驶员是否系安全带说明 false 是
    pilotSunvisor String 主驾驶遮阳板是否打开（unknown-未知，yes-是，no-否，取值参考【数据字典】typeCode为common.pilot_sunvisor_open） false no
    pilotSunvisorName String 主驾驶遮阳板是否打开说明 false 否
    vicePilotSafebelt String 副驾驶员是否系安全带（unknown-未知，yes-是，no-否，取值参考【数据字典】typeCode为common.copilot_belt_safe） false yes
    vicePilotSafebeltName String 副驾驶员是否系安全带说明 false 是
    vicePilotSunvisor String 副驾驶遮阳板是否打开（unknown-未知，yes-是，no-否，取值参考【数据字典】typeCode为common.copilot_sunvisor_open） false yes
    vicePilotSunvisorName String 副驾驶遮阳板是否打开说明 false 是
    uphone String 是否打电话（unknown-未知，yes-是，no-否，取值参考【数据字典】typeCode为common.pilot_on_phone） false no
    uphoneName String 是否打电话说明 false 否
    dangmark String 是否悬挂危险品标志（unknown-未知，yes-是，no-否，取值参考【数据字典】typeCode为common.vehicle_has_dangerous_mark） false no
    dangmarkName String 是否悬挂危险品标志说明 false 否
    envprosign String 是否黄标车（unknown-未知，yes-是，no-否，取值参考【数据字典】typeCode为common.vehicle_envprosign） false no
    envprosignName String 是否黄标车说明 false 否
    vehicleState String 车牌状态（取值参考【数据字典】typeCode为common.plate_state） false normal
    vehicleStateName String 车牌状态说明 false 正常
    pdvs String 天窗是否站人（unknown-未知，yes-是，no-否，取值参考【数据字典】typeCode为common.sunroof_person_occupied） false no
    pdvsName String 天窗是否站人说明 false 否
    vehicleHead String 车牌识别方向（unknown-未知，forward-正向，back-背向，取值参考【数据字典】typeCode为common.plate_forward_side） false forward
    vehicleHeadName String 车牌识别方向说明 false 正向
    pendant String 是否有挂件（unknown-未知，yes-是，no-否，取值参考【数据字典】typeCode为common.vehicle_pendant） false yes
    pendantName String 是否有挂件说明 false 是
    tempPlateNo String 是否临时车牌（unknown-未知，yes-是，no-否，取值参考【数据字典】typeCode为common.plate_is_temporary） false no
    tempPlateNoName String 是否临时车牌说明 false 否
    tricycleCanopy String 三轮车是否有蓬（unknown-未知，manned-无蓬载人，noManned-无蓬未载人，yes-有蓬，取值参考【数据字典】typeCode为common.three_wheel_cover_and_carry） false unknown
    tricycleCanopyName String 三轮车是否有蓬说明 false 未知
    decoration String 是否摆件（unknown-未知，yes-是，no-否，取值参考【数据字典】typeCode为common.vehicle_decoration） false yes
    decorationName String 是否摆件说明 false 是
    tissueBox String 是否有纸巾盒（unknown-未知，yes-是，no-否，取值参考【数据字典】typeCode为common.vehicle_has_tissue_box） false yes
    tissueBoxName String 是否有纸巾盒说明 false 是
    card String 是否有卡片（unknown-未知，yes-是，no-否，取值参考【数据字典】typeCode为common.vehicle_has_card） false yes
    cardName String 是否有卡片说明 false 是
    cardNum Number 卡片数量 false 2
    cardType Array 卡片类型（数组） false
     cardType[0] Object false
      value String 卡片类型（unknown-未知，vehiclePass-出入证，取值参考【数据字典】typeCode为common.vehicle_card） false vehiclePass
      valueName String 卡片类型说明 false 出入证
    copilot String 副驾驶是否有人（unknown-未知，yes-是，no-否，取值参考【数据字典】typeCode为common.vehicle_copilot_human_occupied） false yes
    copilotName String 副驾驶是否有人说明 false 是
    frontChild String 副驾驶是否怀抱婴儿/儿童单独乘坐副驾（unknown-未知，yes-是，no-否，取值参考数据字typeCode为common.vehicle_copilot_in_child） false no
    frontChildName String 副驾驶是否怀抱婴儿/儿童单独乘坐副驾说明 false 否
    muckTruck String 是否渣土车（unknown-未知，yes-是，no-否，取值参考【数据字典】typeCode为common.vehicle_muck_truck） false no
    muckTruckName String 是否渣土车说明 false 否
    sunroof String 是否有天窗（unknown-未知，yes-是，no-否，取值参考【数据字典】typeCode为common.sunroof_has_sunroof） false yes
    sunroofName String 是否有天窗说明 false 是
    luggageRack String 是否有行李架（unknown-未知，yes-是，no-否，取值参考【数据字典】typeCode为common.vehicle_luggage_rack） false no
    luggageRackName String 是否有行李架说明 false 否
    vehicleSprayPainted String 是否车身喷字（unknown-未知，yes-是，no-否，取值参考【数据字典】typeCode为common.vehicle_spray_paint） false no
    vehicleSprayPaintedName String 是否车身喷字说明 false 否
    spareTire String 是否有备胎（unknown-未知，yes-是，no-否，取值参考【数据字典】typeCode为common.vehicle_spare_tire） false no
    spareTireName String 是否有备胎说明 false 否
    coverPlate String 渣土车是否盖板（unknown-未知，yes-是，no-否，取值参考【数据字典】typeCode为common.vehicle_muck_truck_covered） false no
    coverPlateName String 渣土车是否盖板说明 false 否
    label String 是否有贴标（unknown-未知，yes-是，no-否，取值参考【数据字典】typeCode为common.vehicle_has_label） false no
    labelName String 是否有贴标说明 false 否
    labelNum Number 贴标数量 false 2
    labelPosition Array 贴标位置,数组 false
     labelPosition[0] Object 贴标位置，该字段具体使用方式参考【目标框位置坐标说明】。 false
      height Number 高度（float，取值范围[0,1]） false 0.107407
      width Number 宽度（float，取值范围[0,1]） false 0.13
      x Number x坐标（float，取值范围[0,1]） false 0.56
      y Number y坐标（float，取值范围[0,1]） false 0.32
    decorationPosition Object 摆件位置，该字段具体使用方式参考【目标框位置坐标说明】。 false
     height Number 高度（float，取值范围[0,1]） false 0.107407
     width Number 宽度（float，取值范围[0,1]） false 0.13
     x Number x坐标（float，取值范围[0,1]） false 0.56
     y Number y坐标（float，取值范围[0,1]） false 0.32
    tissueBoxPosition Object 纸巾盒位置，该字段具体使用方式参考【目标框位置坐标说明】。 false
     height Number 高度（float，取值范围[0,1]） false 0.107407
     width Number 宽度（float，取值范围[0,1]） false 0.13
     x Number x坐标（float，取值范围[0,1]） false 0.56
     y Number y坐标（float，取值范围[0,1]） false 0.32
    pendantPosition Object 挂件位置，该字段具体使用方式参考【目标框位置坐标说明】。 false
     height Number 高度（float，取值范围[0,1]） false 0.107407
     width Number 宽度（float，取值范围[0,1]） false 0.13
     x Number x坐标（float，取值范围[0,1]） false 0.13
     y Number y坐标（float，取值范围[0,1]） false 0.13
    pdvsPosition Object 天窗站人位置，该字段具体使用方式参考【目标框位置坐标说明】。 false
     height Number 高度（float，取值范围[0,1]） false 0.1
     width Number 宽度（float，取值范围[0,1]） false 0.1
     x Number x坐标（float，取值范围[0,1]） false 0.1
     y Number y坐标（float，取值范围[0,1]） false 0.1
    pilotPosition Object 主驾驶位置，该字段具体使用方式参考【目标框位置坐标说明】。 false
     height Number 高度（float，取值范围[0,1]） false 0.1
     width Number 宽度（float，取值范围[0,1]） false 0.1
     x Number x坐标（float，取值范围[0,1]） false 0.1
     y Number y坐标（float，取值范围[0,1]） false 0.1
    vicePilotPosition Object 副驾驶位置，该字段具体使用方式参考【目标框位置坐标说明】。 false
     height Number 高度（float，取值范围[0,1]） false 0.1
     width Number 宽度（float，取值范围[0,1]） false 0.1
     x Number x坐标（float，取值范围[0,1]） false 0.1
     y Number y坐标（float，取值范围[0,1]） false 0.1
  • 返回值举例
{
   “code”: “0”,
   “msg”: “success”,
   “data”: {
     “total”: 1,
     “list”: [
       {
         “vehicleRect”: {
           “height”: 1,
           “width”: 1,
           “x”: 0,
           “y”: 0
        },
         “plateRect”: {
           “height”: 1,
           “width”: 1,
           “x”: 0,
           “y”: 0
        },
         “modelData”: " ",
         “plateNo”: “京A523A2”,
         “plateType”: “92TypeCivil”,
         “plateTypeName”: “92式民用车”,
         “vehicleColor”: “white”,
         “vehicleColorName”: “白”,
         “vehicleType”: “truck”,
         “vehicleTypeName”: “拖拉机”,
         “vehicleLogo”: 1101,
         “vehicleLogoName”: “路虎”,
         “vehicleSubLogo”: 4,
         “vehicleSubLogoName”: “揽胜”,
         “plateColor”: “white”,
         “plateColorName”: “白”,
         “pilotSafebelt”: “yes”,
         “pilotSafebeltName”: “是”,
         “pilotSunvisor”: “no”,
         “pilotSunvisorName”: “否”,
         “vicePilotSafebelt”: “yes”,
         “vicePilotSafebeltName”: “是”,
         “vicePilotSunvisor”: “yes”,
         “vicePilotSunvisorName”: “是”,
         “uphone”: “no”,
         “uphoneName”: “否”,
         “dangmark”: “no”,
         “dangmarkName”: “否”,
         “envprosign”: “no”,
         “envprosignName”: “否”,
         “vehicleState”: “normal”,
         “vehicleStateName”: “正常”,
         “pdvs”: “no”,
         “pdvsName”: “否”,
         “vehicleHead”: “forward”,
         “vehicleHeadName”: “正向”,
         “pendant”: “yes”,
         “pendantName”: “是”,
         “tempPlateNo”: “no”,
         “tempPlateNoName”: “否”,
         “tricycleCanopy”: “unknown”,
         “tricycleCanopyName”: “未知”,
         “decoration”: “yes”,
         “decorationName”: “是”,
         “tissueBox”: “yes”,
         “tissueBoxName”: “是”,
         “card”: “yes”,
         “cardName”: “是”,
         “cardNum”: 2,
         “cardType”: [
           {
             “value”: “vehiclePass”,
             “valueName”: “出入证”
          }
        ],
         “copilot”: “yes”,
         “copilotName”: “是”,
         “frontChild”: “no”,
         “frontChildName”: “否”,
         “muckTruck”: “no”,
         “muckTruckName”: “否”,
         “sunroof”: “yes”,
         “sunroofName”: “是”,
         “luggageRack”: “no”,
         “luggageRackName”: “否”,
         “vehicleSprayPainted”: “no”,
         “vehicleSprayPaintedName”: “否”,
         “spareTire”: “no”,
         “spareTireName”: “否”,
         “coverPlate”: “no”,
         “coverPlateName”: “否”,
         “label”: “no”,
         “labelName”: “否”,
         “labelNum”: 2,
         “labelPosition”: [
           {
             “height”: 0.107407,
             “width”: 0.13,
             “x”: 0.56,
             “y”: 0.32
          }
        ],
         “decorationPosition”: {
           “height”: 0.107407,
           “width”: 0.13,
           “x”: 0.56,
           “y”: 0.32
        },
         “tissueBoxPosition”: {
           “height”: 0.107407,
           “width”: 0.13,
           “x”: 0.56,
           “y”: 0.32
        },
         “pendantPosition”: {
           “height”: 0.107407,
           “width”: 0.13,
           “x”: 0.13,
           “y”: 0.13
        },
         “pdvsPosition”: {
           “height”: 0.1,
           “width”: 0.1,
           “x”: 0.1,
           “y”: 0.1
        },
         “pilotPosition”: {
           “height”: 0.1,
           “width”: 0.1,
           “x”: 0.1,
           “y”: 0.1
        },
         “vicePilotPosition”: {
           “height”: 0.1,
           “width”: 0.1,
           “x”: 0.1,
           “y”: 0.1
        }
      }
    ]
  }
}

提交平台监控点实时视频车辆结构化分析任务

  • 接口说明

对平台指定监控点进行实时车辆分析。系统会自动从该监控点取流进行做分析，把分析后的结果存入大数据平台，可以在【智能应用服务->车辆应用服务】中进行查询、分析、统计等人脸应用使用。

  • 接口版本

v1

  • 接口地址

/api/aibasic/v1/vehicle/submitRealtimeVideoTask

  • 请求方法

POST

  • 数据提交方式

application/json

  • 输入参数
字段名 类型 必填 描述 示例
 priority String true 任务优先级（high-高，medium-中，low-低） low
 cameraIndexCode String true 平台监控点唯一标识（根据该监控点唯一标识从系统取流，长度不大于32个字符）。可调用【资源目录服务->监控资源信息】中获取监控点相关API获取，如【分页获取监控点资源】。 90ad77d8057c43dab140b77361606927
  • 入参举例
{
   “priority”: “low”,
   “cameraIndexCode”: “90ad77d8057c43dab140b77361606927”
}
  • 返回值
参数名称 数据类型 属性描述 是否必填 示例
 code String 返回码（0表示成功，其他表示失败） false 0
 msg String 返回信息 false success
 data Object 返回数据 false
  taskId String 提交的任务ID（最大长度为64，通过该标识可以控制任务操作）。可以通过任务ID调用【智能任务暂停】、【智能任务恢复】、【智能任务删除】、【智能任务状态查询】接口对该任务进行对应操作。 false temp_301230caa5534d0d9de6f9c020936019
  crossingIndexCode String 在大数据使用该编号查询本次分析任务的结果（长度不大于32个字符） false 6fe0535c0eac4cb29e8e5721105da6c8
  • 返回值举例
{
   “code”: “0”,
   “msg”: “success”,
   “data”: {
     “taskId”: “temp_301230caa5534d0d9de6f9c020936019”,
     “crossingIndexCode”: “6fe0535c0eac4cb29e8e5721105da6c8”
  }
}

提交平台监控点录像视频车辆结构化分析任务

  • 接口说明

对平台指定监控点的存储录像进行车辆分析。系统会自动从该监控点取流进行做分析，把分析后的结果存入大数据平台，可以在【智能应用服务->车辆应用服务】中进行查询、分析、统计等人脸应用使用。

  • 接口版本

v1

  • 接口地址

/api/aibasic/v1/vehicle/submitRecordVideoTask

  • 请求方法

POST

  • 数据提交方式

application/json

  • 输入参数
字段名 类型 必填 描述 示例
 beginTime String true 录像开始时间（ISO8601格式 yyyy-MM-dd’T’HH:mm:ss.SSSzzz） 2017-06-15T00:00:00.000+08:00
 endTime String true 录像结束时间（ISO8601格式 yyyy-MM-dd’T’HH:mm:ss.SSSzzz） 2017-06-15T00:00:00.000+08:00
 speed Number true 加速比（取值范围1-40） 1
 priority String true 任务优先级（high-高，medium-中，low-低） low
 cameraIndexCode String true 平台监控点唯一标识（根据该监控点唯一标识从系统取流，长度不大于32个字符）。可调用【资源目录服务->监控资源信息】中获取监控点相关API获取，如【分页获取监控点资源】。 90ad77d8057c43dab140b77361606927
  • 入参举例
{
   “beginTime”: “2017-06-15T00:00:00.000+08:00”,
   “endTime”: “2017-06-15T00:00:00.000+08:00”,
   “speed”: 1,
   “priority”: “low”,
   “cameraIndexCode”: “90ad77d8057c43dab140b77361606927”
}
  • 返回值
参数名称 数据类型 属性描述 是否必填 示例
 code String 返回码（0表示成功，其他表示失败） false 0
 msg String 返回信息 false success
 data Object 返回数据 false
  taskId String 提交的任务ID（最大长度为64，通过该标识可以控制任务操作）。可以通过任务ID调用【智能任务暂停】、【智能任务恢复】、【智能任务删除】、【智能任务状态查询】接口对该任务进行对应操作。 false temp_301230caa5534d0d9de6f9c020936019
  crossingIndexCode String 在大数据使用该编号查询本次分析任务的结果（长度不大于32个字符） false 6fe0535c0eac4cb29e8e5721105da6c8
  • 返回值举例
{
   “code”: “0”,
   “msg”: “success”,
   “data”: {
     “taskId”: “temp_301230caa5534d0d9de6f9c020936019”,
     “crossingIndexCode”: “6fe0535c0eac4cb29e8e5721105da6c8”
  }
}

提交外部实时视频车辆结构化分析任务

  • 接口说明

可以基于提供的外部的实时视频RTSP标准协议取流url，下发车辆录像视频分析任务。视频数据格式为H.264/H.265。
系统会自动从url取流做视频分析，把分析后的结果存入大数据平台，可以在【智能应用服务->车辆应用服务】中进行查询、分析、统计等人脸应用使用。

  • 接口版本

v1

  • 接口地址

/api/aibasic/v1/vehicle/submitOuterRealtimeVideoTask

  • 请求方法

POST

  • 数据提交方式

application/json

  • 输入参数
字段名 类型 必填 描述 示例
 priority String true 任务优先级(high-高，medium-中，low-低) low
 streamUrl String true rtsp取流地址（长度不大于1024个字符） rtsp://ip:port/EUrl/nnYI0QE
 sourceId String true 视频源的唯一标识，最长32位。分析结果记录会带上该值，后续可以通过该值进行精确查询（和平台监控点唯一编号一样使用）。若多个录像片段需要用同一个唯一标识检索，则多次下发任务时，该字段赋值同一个id即可。 1c8d8fbd83184fcc870144393b5a547c
 sourceName String true 视频源的名称，最长255位。分析结果会带上该值，后续可以在结果中直接显示视频源名称(和平台监控点名称唯一使用)。 新世纪网吧一楼监控摄像头
 longitude String false 视频源的坐标经度，分析结果会带上该值，可在地图上进行定位和实现轨迹功能。WGS84坐标系，最长32位 120.12254
 latitude String false 视频源的坐标纬度，分析结果会带上该值，可在地图上进行定位和实现轨迹功能。WGS84坐标系，最长32位 32.2154
  • 入参举例
{
   “priority”: “low”,
   “streamUrl”: “rtsp://ip:port/EUrl/nnYI0QE”,
   “sourceId”: “1c8d8fbd83184fcc870144393b5a547c”,
   “sourceName”: “长江路秋溢路口”,
   “longitude”: “120.12254”,
   “latitude”: “32.2154”
}
  • 返回值
参数名称 数据类型 属性描述 是否必填 示例
 code String 返回码（0表示成功，其他表示失败） false 0
 msg String 返回信息 false success
 data Object 返回数据 false
  taskId String 提交的任务ID（最大长度为64，通过该标识可以控制任务操作）。可以通过任务ID调用【智能任务暂停】、【智能任务恢复】、【智能任务删除】、【智能任务状态查询】接口对该任务进行对应操作。 false temp_301230caa5534d0d9de6f9c020936019
  • 返回值举例
{
   “code”: “0”,
   “msg”: “success”,
   “data”: {
     “taskId”: “temp_301230caa5534d0d9de6f9c020936019”
  }
}

提交外部录像视频车辆结构化分析任务

  • 接口说明

可以基于提供的外部的录像视频RTSP标准协议取流url，下发车辆录像视频分析任务。视频数据格式为H.264/H.265。
系统会自动从url取流，做人脸分析，把分析后的结果存入大数据平台，可以在【智能应用服务->车辆应用服务】中进行查询、分析、统计等人脸应用使用。

  • 接口版本

v1

  • 接口地址

/api/aibasic/v1/vehicle/submitOuterRecordVideoTask

  • 请求方法

POST

  • 数据提交方式

application/json

  • 输入参数
字段名 类型 必填 描述 示例
 beginTime String true 录像开始时间（IOS8601格式yyyy-MM-dd’T’HH:mm:ss.SSSzzz） 2017-06-15T00:00:00.000+08:00
 endTime String true 录像结束时间（IOS8601格式yyyy-MM-dd’T’HH:mm:ss.SSSzzz） 2017-06-15T00:30:00.000+08:00
 priority String true 任务优先级(high-高，medium-中，low-低) low
 streamUrl String true rtsp取流地址（长度不大于1024个字符） rtsp://ip:port/EUrl/nnYI0QE
 sourceId String true 视频源的唯一标识，最长32位。分析结果记录会带上该值，后续可以通过该值进行精确查询（和平台监控点唯一编号一样使用）。若多个录像片段需要用同一个唯一标识检索，则多次下发任务时，该字段赋值同一个id即可。 1c8d8fbd83184fcc870144393b5a547c
 sourceName String true 视频源的名称，最长255位。分析结果会带上该值，后续可以在结果中直接显示视频源名称(和平台监控点名称唯一使用)。 长江路秋溢路口_2018.08.09_00:00-04:00
 speed Number true 加速比（取值范围：1-40） 10
 longitude String false 视频源的坐标经度，分析结果会带上该值，可在地图上进行定位和实现轨迹功能。WGS84坐标系，最长32位 120.12254
 latitude String false 视频源的坐标纬度，分析结果会带上该值，可在地图上进行定位和实现轨迹功能。WGS84坐标系，最长32位 32.2154
  • 入参举例
{
   “beginTime”: “2017-06-15T00:00:00.000+08:00”,
   “endTime”: “2017-06-15T00:30:00.000+08:00”,
   “priority”: “low”,
   “streamUrl”: “rtsp://ip:port/EUrl/nnYI0QE”,
   “sourceId”: “1c8d8fbd83184fcc870144393b5a547c”,
   “sourceName”: “长江路秋溢路口_2018.08.09_00:00-04:00”,
   “speed”: 10,
   “longitude”: “120.12254”,
   “latitude”: “32.2154”
}
  • 返回值
参数名称 数据类型 属性描述 是否必填 示例
 code String 返回码（0表示成功，其他表示失败） false 0
 msg String 返回信息 false success
 data Object 返回数据 false
  taskId String 提交的任务ID（最大长度为64，通过该标识可以控制任务操作）。可以通过任务ID调用【智能任务暂停】、【智能任务恢复】、【智能任务删除】、【智能任务状态查询】接口对该任务进行对应操作。 false temp_301230caa5534d0d9de6f9c020936019
  • 返回值举例
{
   “code”: “0”,
   “msg”: “success”,
   “data”: {
     “taskId”: “temp_301230caa5534d0d9de6f9c020936019”
  }
}
人脸图像识别单张人脸图片检测建模提交平台监控点实时视频人脸结构化分析任务提交平台监控点录像视频人脸结构化分析任务提交外部实时视频人脸结构化分析任务提交外部录像视频人脸结构化分析任务人体图像识别车辆图像识别