人脸 API 发行说明

本文适用于 Microsoft 人脸 API 服务版本 1.0。

2017 年 5 月版本更改

  • 新属性如果在 returnFaceAttributes 中指定了 hairmakeupaccessoryocclusionblurexposurenoise,可以从人脸 - 检测返回毛发、化妆、附件、光散射、模糊、曝光和噪点属性。

  • 增强支持在一个人员组中包含 10,000 个人员,人脸 - 识别还支持缩放。

  • 列出人员 API人员 - 列出人员组中的人员中支持使用附加的可选参数 starttop 进行分页。

  • 增强添加/删除人脸时,支持针对不同的人脸列表或人员组中的不同人员使用并发性。

2017 年 3 月版本更改

2016 年 11 月版本更改

  • 人脸存储扩展:使用人员对象(人员 - 添加人员人脸)或人脸列表(人脸列表 - 将人脸添加到人脸列表)时,人脸存储允许标准订阅存储更多的保存人脸,以通过人脸 API 进行识别或相似性匹配。 存储的图像按照每 1,000 张人脸 0.5 美元的每日按比例费率收费。 免费层订阅仍旧限制为总共 1,000 个人员。

2016 年 10 月版本更改

2016 年 7 月版本更改

  • 人脸验证 API:支持“人脸到人员”对象鉴定 - 以前,人脸验证请求仅支持“人脸到人脸”鉴定。 可在此处可以找到更多详细信息:人脸 - 验证

  • 查找相似人脸 API:添加了可选模式字段用于选择两种工作模式:默认的 matchPerson 工作方式与以前相同,新模式 matchFace 消除了同人筛选。 如果未指定模式字段,则行为与以前的版本相同。 可在此处可以找到更多详细信息:人脸 - 查找相似人脸

  • 人脸识别 API:为用户启用了一个可选的用户指定 confidenceThreshold,用于定义某个人脸是否属于某个人员对象的置信度阈值。 可在此处可以找到更多详细信息:人脸 - 识别

  • 列出人员组:“列出人员组”中添加了新的可选起点参数和顶部参数,以支持用户在列表中指定起点和人员组总数。 可在此处找到更多详细信息:人员组 - 列出人员组

Note

所有这些更改与最新版的服务兼容,对新添加的参数使用默认值不会导致用户代码发生任何更改。

V1.0 在 V0 基础上的更改

  • API 签名:在人脸 API V1.0 中,服务根终结点已从 https://api.cognitive.azure.cn/face/v0/ 更改为 https://api.cognitive.azure.cn/face/v1.0/。 API 发生了多项签名更改,包括:

  • 人脸大小:以前版本的人脸 API 未明确说明 API 可检测到的最小人脸大小。 在 V1.0 中,API 将可检测的最小大小设置为 36x36 像素。 不会检测小于 36x36 像素的人脸。

  • 保存的数据:使用人脸 V1.0 服务无法访问在人脸 V0 中设置的现有人员组和人员数据。 这种不兼容问题只会发生这一次,后续的 API 更新不再会影响保存的数据。

Note

人脸 API 的 V0 终结点已在 2016 年 6 月 30 日停用