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”
  }
}