产品文档

人脸搜索

帮助中心 > 产品文档 > 人脸搜索 > 创建分组接口文档

创建人脸分组

一、接口描述

1.功能描述

创建一个人脸分组,用于存储人脸。一个分组能够存储100000张人脸。一个用户的分组最多不能超过5个。

2. 接口使用

使用接口前,需要先完成API的下单购买,然后可使用已经封装好的SDK进行相应开发,整体流程详见调用方法

二、请求说明

1. 接口地址 :

 https://aiapi.jdcloud.com/jdai/faceGroupCreate 

2. 请求方式:

https post aiapi.jdcloud.com/jdai/faceGroupCreate

3. 请求参数

(1)header请求参数

业务请求参数

名称 类型 必填 示例值 描述
Authorization string JDCLOUD2-HMAC-SHA256Credential=access... 签名

(2)query请求参数

业务请求参数

名称 类型 必填 示例值 描述
groupName string test 分组名称, 不支持中文以及特殊字符
groupInfo string test test 分组描述,支持中文和特殊字符

4. 请求代码示例

建议您使用我们提供的SDK进行调用,SDK获取及调用方式详见sdk的使用方法

三、返回说明

1、返回参数

(1)公共返回参数

名称 类型 示例值 描述
code string 1000 参见错误码-系统级错误码
charge boolean false 或 true false:不扣费, true:扣费
remain long 1305 按天计算剩余调用次数
msg string 查询成功 参见错误码-系统级错误码
result object {...} 查询结果

(2)业务返回参数

名称 类型 示例值 描述
status int 0 返回结果,0表示成功;非0为对应错误号,参见错误码-业务级错误码
message string Success 若status为0,返回分组id,否则返回错误信息,参见错误码-业务级错误码

2、返回示例

 {  "status": 0,  "charge": false,  "remain": 97,  "msg": "查询成功",  "result":  {  "requestid": "6979e9bd79b944b49e0d6e74079d5098",  "message": "8b94af03-67d7-47ec-ae56-bc5d50333076",  "status": 0  } } 

更新时间:2020-04-28 21:14:27