1. 在线API
  2. API使用手册

FaceCore开放平台调用接口:

http://api.facecore.cn
点击测试服务器 http://api.facecore.cn/api/hello?appkey=8c1be718fa976083a6940009f36c056e
1、获取人脸特征值
请求接口(POST):
/api/facedetect?appkey=您自己的AppKey
请求参数:
{
"faceimage" :"4QBGRXhpZgAASUkqAAgAAAABADEBAgAjAAAAGgAAAAAAAABieS5ibG9vZGR5LmNyeXB0by5pbWFnZS5KUEVHRW5jb2RlcgD"
}
请求参数说明:
属性 数据类型 备注
faceimage 字符串String类型 图片的base64编码
返回结果:
{ 
    "facemodels":
    [
         {
                        "facerectanglex" :70,
                        "facerectangley":120,
                        "facerectanglewidth":150,
                        "facerectangleheight":200,
                        "base64feature":"4QBGRXhpZgAASUkqAAgAAAABADEBAgAjAAAAGgAAAAAAAABieS5ibG9vZGR5LmNyeXB0by5pbWFnZS5KUEVHRW5jb2RlcgD/2wC"
                        "lefteye":{"x":50,"y":30},
                        "righteye":{"x":50,"y":30}
                        "mouth":{"x":50,"y":30},
         },
             ............................n(n最大为10) .........................
             ............................n(n最大为10) .........................				
         {
                        "facerectanglex":70,
                        "facerectangley":120,
                        "facerectanglewidth":150,
                        "facerectangleheight":200,
                        "base64feature":"4QBGRXhpZgAASUkqAAgAAAABADEBAgAjAAAAGgAAAAAAAABieS5ibG9vZGR5LmNyeXB0by5pbWFnZS5KUEVHRW5jb2RlcgD/2wC"
                        "lefteye":{"x":50,"y":30},
                        "righteye":{"x":50,"y":30}
                        "mouth":{"x":50,"y":30},
         }
    ]
}
返回结果说明:
属性 数据类型 备注
facerectanglex 整数Int类型 人脸矩形框x坐标
facerectangley 整数Int类型 人脸矩形框y坐标
facerectanglewidth 整数Int类型 人脸矩形框宽
facerectangleheight 整数Int类型 人脸矩形框高
base64feature 字符串String类型 人脸的特征值
lefteye{x,y} 整数Int类型 人脸左眼特征坐标
righteye{x,y} 整数Int类型 人脸右眼特征坐标
mouth{x,y} 整数Int类型 人脸口型特征坐标
2、获取人脸相似度
方式一: 请求接口(POST):
/api/facecompare?appkey=您自己的AppKey
请求参数:
{
"facefeature1":"ySEiPlnTw1wQQ4v69CVGhEiB29dsGCjrkhx4ipGnxWjZgE4DwbNfxSm9G/YKLsdayn8tjyY1",
"facefeature2":"ifEqon64UwtIPEzPtzbDYaCbcG45j8v3u4u6h3FwfXjdHa7/CXgJx2FTPFrWhwEe/pUM"
}
请求参数说明:
属性 数据类型 备注
facefeature1 字符串String类型 第1张人脸的特征值
facefeature2 字符串String类型 第2张人脸的特征值

方式二: 请求接口(POST):
/api/facedetectandcompare?appkey=您自己的AppKey
请求参数:
{
"faceimage1":"/9j/4AAQSkZJRgABAQAAAQABAAD//gA8Q1JFQVRPUjogZ2QtanBlZyB2MS4wICh1c2luZyBJSkcgSlBFRyB2NjIpLCBxdW",
"faceimage2":"ifEqon64UwtIPEzPtzbDYaCbcG45j8v3u4u6h3FwfXjdHa7/CXgJx2FTPFrWhwEe/pUM"
}
请求参数说明:
属性 数据类型 备注
faceimage1 字符串String类型 第1张图片的base64编码
faceimage1 字符串String类型 第2张图片的base64编码

方式三: 请求接口(POST):
/api/urlfacedetectandcompare?appkey=您自己的AppKey
请求参数:
{
"url1":"http://a1.att.hudong.com/24/57/16300000178518124635573388901.jpg",,
"url2":"http://pic.yesky.com/imagelist/11/13/12287996_1005.jpg"
}
请求参数说明:
属性 数据类型 备注
url1 字符串String类型 第1张图片的图像网址
url2 字符串String类型 第2张图片的图像网址

返回结果(一、二、三相同):
{
 "similar":1.0
}
返回结果说明(一、二、三相同):
属性 数据类型 备注
similar Float类型 相似度(最大值:1); 返回-1说明请求数据错误, 返回-2说明没检测到人脸, 返回-3说明检测到多张人脸
3、获取人脸轮廓
请求接口(POST):
/api/facepointsdetect?appkey=您自己的AppKey
请求参数:
{
"faceimage" :"4QBGRXhpZgAASUkqAAgAAAABADEBAgAjAAAAGgAAAAAAAABieS5ibG9vZGR5LmNyeXB0by5pbWFnZS5KUEVHRW5jb2RlcgD"
}
请求参数说明:
属性 数据类型 备注
faceimage 字符串String类型 图片的base64编码
返回结果:
{ 
    "facepoints":
    [
         {
                        "points_num" :0,
                        "pos_x":
                         {"0":173.348557,
                          "1":173.445023,
                          "2":174.26622,
                          .......3.....,
                          .............,
                          "67":198.814575
                         },
                        "pos_y":
                         {"0":59.7553024,
                          "1":68.45167,
                          "2":77.08728,
                          .......3.....,
                          .............,
                          "67":92.60215
                         }
         },
             ............................n(n最大为10) .........................
             ............................n(n最大为10) .........................				
         {
                        "points_num" :0,
                        "pos_x":
                         {"0":173.348557,
                          "1":173.445023,
                          "2":174.26622,
                          .......3.....,
                          .............,
                          "67":198.814575
                         },
                        "pos_y":
                         {"0":760.677856,
                          "1":760.8335,
                          "2":762.9904,
                          .......3.....,
                          .............,
                          "67":818.800537
                         }
         }
    ]
}
返回结果说明:
属性 数据类型 备注
points_num 整数Int类型 默认为0
pos_x 数组类型 人脸特征点x坐标
pos_y 数组类型 人脸特征点y坐标
4、获取人脸角度
请求接口(POST):
/api/faceanglesdetect?appkey=您自己的AppKey
请求参数:
{
"faceimage" :"4QBGRXhpZgAASUkqAAgAAAABADEBAgAjAAAAGgAAAAAAAABieS5ibG9vZGR5LmNyeXB0by5pbWFnZS5KUEVHRW5jb2RlcgD"
}
请求参数说明:
属性 数据类型 备注
faceimage 字符串String类型 图片的base64编码
返回结果:
{ 
    "faceangles":
    [
         {
                        "pitch" :5.749201427414106,
                        "roll" :2.615236297310048,
                        "yaw" :1.3674359593343008
                   
         },
             ............................n(n最大为10) .........................
             ............................n(n最大为10) .........................				
         {
                        "pitch" :3.4284045644256116,
                        "roll" :-1.1407781842867735,
                        "yaw" :-3.912597929718953
         }
    ]
}
返回结果说明:
属性 数据类型 备注
pitch double类型 俯仰角
roll double类型 翻滚角
yaw double类型 偏转角
5、获取人脸特征及性别年龄
请求接口(POST):
/api/facedetectageandsex?appkey=您自己的AppKey
请求参数:
{
"faceimage" :"4QBGRXhpZgAASUkqAAgAAAABADEBAgAjAAAAGgAAAAAAAABieS5ibG9vZGR5LmNyeXB0by5pbWFnZS5KUEVHRW5jb2RlcgD"
}
请求参数说明:
属性 数据类型 备注
faceimage 字符串String类型 图片的base64编码
返回结果:
{ 
    "facemodels":
    [
         {
                        "facerectanglex" :70,
                        "facerectangley":120,
                        "facerectanglewidth":150,
                        "facerectangleheight":200,
                        "base64feature":"ySEiPlnTw1wQQ4v69CVGhEiB29dsGCjrkhx4ipGnxWjZgE4DwbNfxSm9G/YKLsday"
                        "lefteye":{"x":50,"y":30},
                        "righteye":{"x":50,"y":30},
                        "mouth":{"x":50,"y":30},
                        "age" :24,
                        "sex" :"male"
         },
             ............................n(n最大为5) .........................
             ............................n(n最大为5) .........................				
         {
                        "facerectanglex":70,
                        "facerectangley":120,
                        "facerectanglewidth":150,
                        "facerectangleheight":200,
                        "base64feature":"4QBGRXhpZgAASUkqAAgAAAABADEBAgAjAAAAGgAAAAAAAABieS5ibG9vZGR5LmNyeXB0by5pbWFnZS5KUEVHRW5jb2RlcgD/2wC"
                        "lefteye":{"x":50,"y":30},
                        "righteye":{"x":50,"y":30},
                        "mouth":{"x":50,"y":30},
                        "age" :24,
                        "sex" :"Female"
         }
    ]
}
返回结果说明:
属性 数据类型 备注
facerectanglex 整数Int类型 人脸矩形框x坐标
facerectangley 整数Int类型 人脸矩形框y坐标
facerectanglewidth 整数Int类型 人脸矩形框宽
facerectangleheight 整数Int类型 人脸矩形框高
base64feature 字符串String类型 人脸的特征值
lefteye{x,y} 整数Int类型 人脸左眼特征坐标
righteye{x,y} 整数Int类型 人脸右眼特征坐标
mouth{x,y} 整数Int类型 人脸口型特征坐标
age 整数Int类型 人脸的年龄
sex 字符串String类型 人脸的性别
6、获取人脸个数
请求接口(POST):
/api/facedetectcount?appkey=您自己的AppKey
请求参数:
{
"faceimage" :"4QBGRXhpZgAASUkqAAgAAAABADEBAgAjAAAAGgAAAAAAAABieS5ibG9vZGR5LmNyeXB0by5pbWFnZS5KUEVHRW5jb2RlcgD"
}
请求参数说明:
属性 数据类型 备注
faceimage 字符串String类型 图片的base64编码
返回结果:
{
totalface :3
}
返回结果说明:
属性 数据类型 备注
totalface 整数Int类型 人脸个数(最大:5)
7、URL获取人脸特征值
请求接口(POST):
/api/urlfacedetect?appkey=您自己的AppKey
请求参数:
{
"url" :"http://img0.bdstatic.com/img/image/shouye/mxxtf-9437933367.jpg"
}
请求参数说明:
属性 数据类型 备注
url 字符串String类型 图片的网站地址
返回结果:
{ 
    "facemodels":
    [
         {
                        "facerectanglex" :70,
                        "facerectangley":120,
                        "facerectanglewidth":150,
                        "facerectangleheight":200,
                        "base64feature":"4QBGRXhpZgAASUkqAAgAAAABADEBAgAjAAAAGgAAAAAAAABieS5ibG9vZGR5LmNyeXB0by5pbWFnZS5KUEVHRW5jb2RlcgD/2wC"
                        "lefteye":{"x":50,"y":30},
                        "righteye":{"x":50,"y":30}
                        "mouth":{"x":50,"y":30},
         },
             ............................n(n最大为5) .........................
             ............................n(n最大为5) .........................				
         {
                        "facerectanglex":70,
                        "facerectangley":120,
                        "facerectanglewidth":150,
                        "facerectangleheight":200,
                        "base64feature":"4QBGRXhpZgAASUkqAAgAAAABADEBAgAjAAAAGgAAAAAAAABieS5ibG9vZGR5LmNyeXB0by5pbWFnZS5KUEVHRW5jb2RlcgD/2wC"
                        "lefteye":{"x":50,"y":30},
                        "righteye":{"x":50,"y":30}
                        "mouth":{"x":50,"y":30},
         }
    ]
}
返回结果说明:
属性 数据类型 备注
facerectanglex 整数Int类型 人脸矩形框x坐标
facerectangley 整数Int类型 人脸矩形框y坐标
facerectanglewidth 整数Int类型 人脸矩形框宽
facerectangleheight 整数Int类型 人脸矩形框高
base64feature 字符串String类型 人脸的特征值
lefteye{x,y} 整数Int类型 人脸左眼特征坐标
righteye{x,y} 整数Int类型 人脸右眼特征坐标
mouth{x,y} 整数Int类型 人脸口型特征坐标
8、添加/修改一张人脸
请求接口(POST):
/api/personface?appkey=您自己的AppKey
请求参数:
{
"faceid" :"facecore_0001_aj",
"nick":"小王",
"base64feature":"4QBGRXhpZgAASUkqAAgAAAABADEBAgAjAAAAGgAAAAAAAABieS5ibG9vZGR5LmNyeXB0by5pbWFnZS5KUEVHRW5jb2RlcgD/2wCEAA0JCgsKCA0LCgsODg0PEyAVExISEyccHhcgLikxMC4pLSwzOko+MzZGNywtQFdBRkxOUlNSMj5aYVpQYEpRUk8BDg4OExETJhUVJk81LTVPT09PT09PT09P",         
"base64faceimage":"/9j/4AAQSkZJRgABAQAAAQABAAD//gA8Q1JFQVRPUjogZ2QtanBlZyB2MS4wICh1c2luZyBJSkcgSlBFRyB2NjIpLCBxdWFsaXR5ID0gMTAwCv/bAEMAAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAf",
}
请求参数说明:
属性 数据类型 备注
faceid 字符串String类型 人脸ID
nick 字符串String类型 昵称
base64feature 字符串String类型 本张图片人脸的特征值
base64faceimage 字符串String类型 本张图片的base64编码
返回结果:
{
"result":true, //true:操作成功 false:操作失败
"message":"添加操作成功"
}
返回结果说明:
属性 数据类型 备注
result bool类型 true:操作成功 false:操作失败
message 字符串String类型 操作结果信息
9、获取人脸库中与目标人脸一定相似度的人脸
请求接口(POST):
/api/personface/similar?appkey=您自己的AppKey 
请求参数:
{
"base64feature":"feature base64code"  //目标人脸的特征值
"threshold":0.7 //阈值
"maxresult":10 //最大返回人脸个数
}
请求参数说明:
属性 数据类型 备注
base64feature 字符串String类型 人脸的特征值
threshold Float类型 阈值
maxresult 整数Int类型 最大返回人脸个数
返回结果:
{
    "similarpersonface":
    [
        {
                        "similar":0.95,
                        "faceid":"facecore_0001_jdjdjd",
                        "appkey":"8c1be718fa976083a6940909f36c056e",
                        "nick":"小王",
                        "createtime":"2014-09-24T16:06:43.9032124+08:00",
                        "base64feature":"4QBGRXhpZgAASUkqAAgAAAABADEBAgAjAAAAGgAAAAAAAABieS5ibG9vZGR5LmNyeXB0by5pbWFnZS5KUEVHRW5jb2RlcgD/2wCEAA0JCgsKCA0LCgsODg0PEyAVExISEyccHhcgLikxMC4pLSwzOko+MzZGNywtQFdBRkxOUlNSMj5aYVpQYEpRUk8BDg4OExETJhUVJk81LTVPT09PT09PT09P",
                        "base64faceimage":"ifEqon64UwtIPEzPtzbDYaCbcG45j8v3u4u6h3FwfXjdHa7/CXgJx2FTPFrWhwEe/pUM"
        },
             ............................n ...........................
             ............................n ...........................
        {
                        "similar" :0.70,
                        "faceid":"facecore_0002",
                        "appkey":"8c1be718fa976083a6940039f36c056e",
                        "nick":"小李",
                        "createtime":"2014-09-24T16:06:43.9032124+08:00",
                        "base64feature":"ySEiPlnTw1wQQ4v69CVGhEiB29dsGCjrkhx4ipGnxWjZgE4DwbNfxSm9G/YKLsdayn8t",
                        "base64faceimage":"/9j/4AAQSkZJRgABAQAAAQABAAD//gA8Q1JFQVRPUjogZ2QtanBlZyB2MS4wICh1c2luZyBJSkcgSlBFRy"
        }
    ]
}
返回结果说明:
属性 数据类型 备注
similar Float类型 相似度
faceid 字符串String类型 人脸ID
appkey 字符串String类型 appkey
nick 字符串String类型 昵称
createtime 字符串String类型 创建时间
base64feature 字符串String类型 人脸的特征值
base64faceimage 字符串String类型 编码base64的图片
10、返回appkey存储的全部人脸
请求接口(GET):
/api/personface/getall?appkey=您自己的AppKey 
返回结果:
{
    "personfaces":
    [
        {
                        "faceid":"facecore_0001_jdjdjd",
                        "appkey":"8c1be718fa976083a6940909f36c056e",
                        "nick":"小王",
                        "createtime":"2014-09-24T16:06:43.9032124+08:00",
                        "base64feature":"4QBGRXhpZgAASUkqAAgAAAABADEBAgAjAAAAGgAAAAAAAABieS5ibG9vZGR5LmNyeXB0by5pbWFnZS5KUEVHRW5jb2RlcgD/2wCEAA0JCgsKCA0LCgsODg0PEyAVExISEyccHhcgLikxMC4pLSwzOko+MzZGNywtQFdBRkxOUlNSMj5aYVpQYEpRUk8BDg4OExETJhUVJk81LTVPT09PT09PT09P",
                        "base64faceimage":"ifEqon64UwtIPEzPtzbDYaCbcG45j8v3u4u6h3FwfXjdHa7/CXgJx2FTPFrWhwEe/pUM"
        },
             ............................n ...........................
             ............................n ...........................
        {
                        "faceid":"facecore_0002",
                        "appkey":"8c1be718fa976083a6940039f36c056e",
                        "nick":"小李",
                        "createtime":"2014-09-24T16:06:43.9032124+08:00",
                        "base64feature":"ySEiPlnTw1wQQ4v69CVGhEiB29dsGCjrkhx4ipGnxWjZgE4DwbNfxSm9G/YKLsdayn8t",
                        "base64faceimage":"/9j/4AAQSkZJRgABAQAAAQABAAD//gA8Q1JFQVRPUjogZ2QtanBlZyB2MS4wICh1c2luZyBJSkcgSlBFRy"
        }
    ]
}
返回结果说明:
属性 数据类型 备注
faceid 字符串String类型 人脸ID
appkey 字符串String类型 appkey
nick 字符串String类型 昵称
createtime 字符串String类型 创建时间
base64feature 字符串String类型 人脸的特征值
base64faceimage 字符串String类型 编码base64的图片
11、获取某张人脸
请求接口(GET):
/api/personface/{id}?appkey=您自己的AppKey  
请求参数:
{
"id":图片id                      
}
请求参数说明:
属性 数据类型 备注
id 字符串String类型 图片id
返回结果:
{
"faceid":"facecore_0001_jdjdjd",
"appkey":"8c1be718fa976083a6940909f36c056e",
"nick":"小王",
"createtime":"2014-09-24T16:06:43.9032124+08:00",
"base64feature":"4QBGRXhpZgAASUkqAAgAAAABADEBAgAjAAAAGgAAAAAAAABieS5ibG9vZGR5LmNyeXB0by5pbWFnZS5KUEVHRW5jb2RlcgD/2wCEAA0JCgsKCA0LCgsODg0PEyAVExISEyccHhcgLikxMC4pLSwzOko+MzZGNywtQFdBRkxOUlNSMj5aYVpQYEpRUk8BDg4OExETJhUVJk81LTVPT09PT09PT09P",
"base64faceimage":"ifEqon64UwtIPEzPtzbDYaCbcG45j8v3u4u6h3FwfXjdHa7/CXgJx2FTPFrWhwEe/pUM"
   
}
返回结果说明:
属性 数据类型 备注
faceid 字符串String类型 人脸ID
appkey 字符串String类型 appkey
nick 字符串String类型 昵称
createtime 字符串String类型 创建时间
base64feature 字符串String类型 人脸的特征值
base64faceimage 字符串String类型 编码base64的图片
侧栏导航
回到顶部