人脸识别特征值同步接口
更新时间：2026-03-16
人脸识别特征值同步接口
人脸识别特征值同步接口可以实现人脸特征抽取和人脸库的构建。 该接口主要用于在服务端（云端）提取与人脸离线识别SDK通用的人脸特征值，通过调用该接口获取到的人脸特征值及构建的人脸库可以直接导入离线设备端作为人脸离线识别SDK的底库。
特征抽取接口
说明：该接口用于检测图片中的人脸并获得人脸位置信息及特征数据
1. 请求参数
1.1. 请求方法
HTTP方法：POST
请求URL： https://aip.baidubce.com/rest/2.0/face/v1/feature
URL参数：
| 参数 | 值 |
|---|---|
| access_token | 通过API Key和Secret Key获取的access_token,参考“Access Token获取” |
Header：
| 参数 | 值 |
|---|---|
| Content-Type | application/json |
1.2. 参数列表
| 参数 | 是否必选 | 类型 | 说明 |
|---|---|---|---|
| image | 是 | string | 图片信息(数据大小应小于10M) |
| image_type | 是 | string | 图片类型: BASE64:图片的base64值 URL:图片的 URL( 下载图片时可能由于网络等原因导致下载图片时间过长) |
| platform_version | 否 | string | 平台版本（私有化部署版本）可选值有Android_4300、Android_4501、Android_5101、Android_6001、Android_60011、Android_6002、Android_6003、Android_8001、Android_8002、Android_9001、HiSilicon_2000、HiSilicon_2001、Windows_8001、Windows_8002 |
| version | 是 | string | 服务版本（公有云接口版本）, 当前支持【4300、4501、5101、6001、60011、6002、Android_7001、Android_7002、Android_7003、Android_905D3、Android_8001、Android_8002、Windows_8001、Windows_8002、HiSilicon_2000、HiSilicon_2001、HiSilicon_2003、HiSilicon_3000、RV1109_2000、RV1109_2001、RV1109_2003、RV1109_3000】 4300对应安卓sdk的4.3.0.1版本; 4501对应安卓sdk4.5.0.1版本; 5101对应安卓sdk5.1.0.1版本; 6001: 对应安卓/Windows 6.0通行版; 60011:对应安卓6.0通行红外照版; 6002: 对应安卓/Windows 6.0口罩版； 6003:对应安卓6.0证件照识别模型； Android_7001:对应7.0通用版RGB识别模型； Android_7002:对应7.0通用版RGB&NIR识别模型； Android_7003:对应7.0海外版RGB识别模型； Android_905D3: 对应905D3 1.0 RGB识别模型； Android_8001:对应8.0通用版RGB识别模型； Android_8002:对应8.0通用版RGB&NIR识别模型； Android_9001:对应9.0通用版RGB&NIR识别模型； Windows_8001:对应8.0通用版RGB识别模型； Windows_8002:对应8.0通用版RGB&NIR识别模型； HiSilicon_2000:对应海思2.0通用版RGB识别模型； HiSilicon_2001:对应海思2.0通用版RGB&NIR识别模型； HiSilicon_2003:对应海思2.0海外版RGB识别模型； HiSilicon_3000:对应HiSilicon 3.0通用版RGB识别模型 RV1109_2000:对应RV1109 2.0通用版RGB识别模型； RV1109_2001:对应RV1109 2.0通用版RGB&NIR识别模型； RV1109_2003:对应RV1109 2.0海外版RGB识别模型； RV1109_3000:对应RV1109 3.0通用版RGB识别模型 备注：只有大版本号一致才能满足不同系统版本SDK的特征值互通，例如安卓6.x和Windows 6.x，新版本安卓8.x和Windows 8.x |
| max_face_num | 否 | uint32 | 最多处理人脸的数目. 默认值为1（仅检测图片中面积最大的那个人脸） 最大值100 |
| prob_threshold | 否 | float | 人脸检测置信度过滤阈值 范围0~1 默认值为0.5 |
| min_face_size | 否 | uint32 | 人脸大小过滤阈值 默认值为50(仅检测人脸区域宽度在50以上的人脸) |
| display_quality | 否 | string | 可选 y 或 n。 n：表示不显示 人脸质量+旋转属性【默认】 y：表示显示 人脸质量+旋转属性。 同时参数 max_face_num 会被设置为1 |
1.3. 请求示例
Plain Text
1{
2 "image": "/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAgGBgcGBQgHB...",
3 "image_type": "BASE64",
4 "platform_version": "Android_4300",
5 "version": 4300
6}2.返回结果
2.1. 参数列表
| 字段 | 是否必选 | 类型 | 说明 |
|---|---|---|---|
| face_num | 是 | int | 图片中的人脸数量 |
| face_list | 是 | array | 人脸信息列表 字段信息见下 |
| ----------------------------- | ---- | ---- | ----------------------------------------------------------------- |
| location | 是 | array | 人脸在图片中的位置 |
| +center_x | 是 | float | 人脸区域中心点离左边界的距离 |
| +center_y | 是 | float | 人脸区域中心点离上边界的距离 |
| +width | 是 | float | 人脸区域的宽度 |
| +height | 是 | float | 人脸区域的高度 |
| +rotation | 是 | int64 | 人脸框相对于竖直方向的顺时针旋转角，[-180,180] |
| angle | 否 | array | 人脸旋转参数 具体说明参考人脸空间姿态角 display_quality参数为y时显示 |
| +yaw | 否 | float | 三维旋转之左右旋转角[-90(左), 90(右)] |
| +pitch | 否 | float | 三维旋转之俯仰角度[-90(上), 90(下)] |
| +roll | 否 | float | 平面内旋转角[-180(逆时针), 180(顺时针)] |
| quality | 否 | array | 人脸质量信息。 display_quality参数为y时显示 |
| +occlusion | 否 | array | 人脸各部分遮挡的概率，范围[0~1]，0表示完整，1表示不完整 |
| ++left_eye | 否 | float | 左眼遮挡比例 |
| ++right_eye | 否 | float | 右眼遮挡比例 |
| ++nose | 否 | float | 鼻子遮挡比例 |
| ++mouth | 否 | float | 嘴巴遮挡比例 |
| ++left_cheek | 否 | float | 左脸颊遮挡比例 |
| ++right_cheek | 否 | float | 右脸颊遮挡比例 |
| ++chin_contour | 否 | float | 下巴遮挡比例 |
| +blur | 否 | float | 人脸模糊程度，范围[0~1]，0表示清晰，1表示模糊 |
| +illumination | 否 | float | 取值范围在[0~255], 表示脸部区域的光照程度 越大表示光照越好 |
| +completeness | 否 | int64 | 人脸完整度，0或1, 0为人脸溢出图像边界，1为人脸都在图像边界内 |
| face_probability | 是 | float | 人脸置信度，范围0-1 |
| landmark72 | 否 | array | 72个特征点位置 face_field包含landmark时返回 具体对应位置见72个关键点示意图 |
| landmark72_probability | 是 | float | 人脸置信度，范围0-1 |
| feature | 是 | string | 人脸特征信息 |
2.2. 返回示例
Plain Text
1{
2"error_code": 0,
3"error_msg": "SUCCESS",
4"log_id": 2858021767,
5"timestamp": 1586767658,
6"cached": 0,
7"result": {
8 "face_num": 1,
9 "face_list": [
10 {
11 "location": {
12 "center_x": 77.58989716,
13 "center_y": 142.822937,
14 "width": 88.65403748,
15 "height": 111.686615,
16 "rotation": 0
17 },
18 "angle": {
19 "yaw": -0.34859421849251,
20 "pitch": 1.9135693311691,
21 "roll": 2.3033397197723
22 },
23 "quality": {
24 "occlusion": {
25 "left_eye": 0,
26 "right_eye": 0,
27 "nose": 0,
28 "mouth": 0,
29 "left_cheek": 0.0064102564938366,
30 "right_cheek": 0.0057411273010075,
31 "chin": 0
32 },
33 "blur": 1.1886881756684e-10,
34 "illumination": 141,
35 "completeness": 1
36 },
37 "landmark72_probability": 0.9992024302,
38 "landmark72": [
39 {
40 "x": 31.85945511,
41 "y": 134.6939392
42 },
43 {
44 "x": 34.70507431,
45 "y": 149.3773804
46 },
47 {
48 "x": 38.71540833,
49 "y": 163.9017944
50 },
51 {
52 "x": 45.37094498,
53 "y": 178.0964508
54 },
55 {
56 "x": 58.14535522,
57 "y": 190.8776245
58 },
59 {
60 "x": 73.57247925,
61 "y": 198.5220337
62 },
63 {
64 "x": 88.43057251,
65 "y": 200.3898926
66 },
67 {
68 "x": 101.6749039,
69 "y": 194.270813
70 },
71 {
72 "x": 113.2898407,
73 "y": 181.7249756
74 },
75 {
76 "x": 120.3853683,
77 "y": 167.4402008
78 },
79 {
80 "x": 122.5986481,
81 "y": 153.5954437
82 },
83 {
84 "x": 123.1974487,
85 "y": 139.8652344
86 },
87 {
88 "x": 122.687851,
89 "y": 126.2104416
90 },
91 {
92 "x": 52.40658951,
93 "y": 135.2301331
94 },
95 {
96 "x": 56.85477448,
97 "y": 132.2627563
98 },
99 {
100 "x": 61.40156555,
101 "y": 131.2002563
102 },
103 {
104 "x": 65.94801331,
105 "y": 131.8759308
106 },
107 {
108 "x": 70.11144257,
109 "y": 135.0392303
110 },
111 {
112 "x": 65.93842316,
113 "y": 135.842926
114 },
115 {
116 "x": 61.48118591,
117 "y": 136.3649902
118 },
119 {
120 "x": 56.84508896,
121 "y": 136.0989227
122 },
123 {
124 "x": 61.41680908,
125 "y": 133.6108093
126 },
127 {
128 "x": 44.35185242,
129 "y": 125.7888184
130 },
131 {
132 "x": 50.08662415,
133 "y": 120.1439972
134 },
135 {
136 "x": 57.18831635,
137 "y": 118.5079346
138 },
139 {
140 "x": 64.31583405,
141 "y": 118.9860992
142 },
143 {
144 "x": 71.02742767,
145 "y": 122.8297577
146 },
147 {
148 "x": 64.24365234,
149 "y": 123.2055359
150 },
151 {
152 "x": 57.56406403,
153 "y": 123.3519287
154 },
155 {
156 "x": 50.91134644,
157 "y": 124.1832886
158 },
159 {
160 "x": 92.80820465,
161 "y": 132.9268494
162 },
163 {
164 "x": 96.26389313,
165 "y": 128.844574
166 },
167 {
168 "x": 100.5915298,
169 "y": 127.3882294
170 },
171 {
172 "x": 105.1667709,
173 "y": 127.6879349
174 },
175 {
176 "x": 109.6202545,
177 "y": 129.9836884
178 },
179 {
180 "x": 105.8541565,
181 "y": 131.58078
182 },
183 {
184 "x": 101.5338593,
185 "y": 132.6605225
186 },
187 {
188 "x": 97.05542755,
189 "y": 132.9283447
190 },
191 {
192 "x": 100.1235352,
193 "y": 129.9213257
194 },
195 {
196 "x": 90.2924881,
197 "y": 121.1221771
198 },
199 {
200 "x": 96.0561142,
201 "y": 116.0347748
202 },
203 {
204 "x": 102.5889816,
205 "y": 114.3559265
206 },
207 {
208 "x": 109.3289413,
209 "y": 114.6903839
210 },
211 {
212 "x": 115.2678986,
213 "y": 119.429985
214 },
215 {
216 "x": 109.318779,
217 "y": 118.7310181
218 },
219 {
220 "x": 103.117363,
221 "y": 119.074173
222 },
223 {
224 "x": 96.82205963,
225 "y": 120.2095337
226 },
227 {
228 "x": 76.32652283,
229 "y": 135.2134247
230 },
231 {
232 "x": 75.47886658,
233 "y": 142.9312134
234 },
235 {
236 "x": 74.66484833,
237 "y": 150.6994934
238 },
239 {
240 "x": 71.87775421,
241 "y": 159.0964966
242 },
243 {
244 "x": 78.33350372,
245 "y": 160.4037628
246 },
247 {
248 "x": 91.78503418,
249 "y": 159.0786133
250 },
251 {
252 "x": 96.69219971,
253 "y": 156.4392853
254 },
255 {
256 "x": 92.56558228,
257 "y": 148.8883667
258 },
259 {
260 "x": 90.01399231,
261 "y": 141.4549561
262 },
263 {
264 "x": 87.45940399,
265 "y": 134.0280151
266 },
267 {
268 "x": 85.36231995,
269 "y": 155.7476807
270 },
271 {
272 "x": 66.46245575,
273 "y": 172.3835449
274 },
275 {
276 "x": 76.1668396,
277 "y": 170.0975342
278 },
279 {
280 "x": 85.70652771,
281 "y": 169.4825439
282 },
283 {
284 "x": 94.3141861,
285 "y": 168.2900391
286 },
287 {
288 "x": 102.5781555,
289 "y": 168.4827271
290 },
291 {
292 "x": 96.42169952,
293 "y": 176.848175
294 },
295 {
296 "x": 86.68830109,
297 "y": 180.6125488
298 },
299 {
300 "x": 75.61171722,
301 "y": 179.1507874
302 },
303 {
304 "x": 76.39985657,
305 "y": 172.5153046
306 },
307 {
308 "x": 85.97942352,
309 "y": 172.4254913
310 },
311 {
312 "x": 94.55542755,
313 "y": 170.6518555
314 },
315 {
316 "x": 94.6856842,
317 "y": 173.494873
318 },
319 {
320 "x": 86.11052704,
321 "y": 175.6858673
322 },
323 {
324 "x": 76.53229523,
325 "y": 175.497345
326 }
327 ],
328 "feature": "azwBEORLwZYRJ+YYPHcnHAFyfII8LSUEuYZtCQfWXQ5mrycxpiT2NB7fnLiiCkW9pmX8oOL+eqSUorLXysaPrMijcdDwf/lW2bmoWenMYlxPsLpAw/F5Ra6uRUkQ047NqzqS8eOqafRphSl6OGTRfDBLq2A3WkjlAcwNaHHzd+2fvPIRm9l/6+nGjJjE4qAc81CFABDR8gXGhGQJtCGLDZokDTAn+A40zIBmOE4h5DzVBzKgrixiJHKYHqoAkCisY+lcL43E+lRzZKNY+6iIXR4qckRV8qxF7TOXSU6iT8xCLCnwNzdH9CP0FXj2h7B8EtHrYEINlOVUW8jpC1uHbYkAIBHyooUWm99SHJZD8R6qHV8BYw9hh6aCzAi3PxoN8kNjsfS6OTUpCJDHAolkvbbN0yDXiYWkKLR/KeMOSiw/uH5R6A0r1NU/Z9jp8m7cBmOpQXhPxcSkEBTIdlFQTGaUs/Ky3Hd0pAoS+Mf98Xwjg4Bg9iOv5f+c+WnLpEpsArJfkIDxkxVBp78Y/2uRnILIbQLbERr7aUsJCD9Ongw7c4cx3PSaNDcqfrgPEVq8n0TUIFD8pSQVmMAo4P6+LWZBBtFDJCLU1Sds2C2R4dyFSvZBlTSexKmfOsta+FzOKPn1cIfLJ3Zud4Z5R+icfTyUJmDh3O5kkJM7aMAi5Gw=",
329 "face_probability": 0.9996234179
330 }
331 ]
332}
333}3. 72个关键点示意图
评价此篇文章