From 1c7f908ce09f98fdcbf79ed2a8ae21be60eaa634 Mon Sep 17 00:00:00 2001 From: Zhineng Li Date: Sun, 12 Jul 2026 17:11:17 +0800 Subject: update APIs 20260712 --- data/zh_cn/facebody/2019-12-30/api-docs.php | 10796 +++++++++++--------------- data/zh_cn/facebody/2020-09-10/api-docs.php | 108 +- 2 files changed, 4655 insertions(+), 6249 deletions(-) (limited to 'data/zh_cn/facebody') diff --git a/data/zh_cn/facebody/2019-12-30/api-docs.php b/data/zh_cn/facebody/2019-12-30/api-docs.php index 8f5114b..81a08a2 100644 --- a/data/zh_cn/facebody/2019-12-30/api-docs.php +++ b/data/zh_cn/facebody/2019-12-30/api-docs.php @@ -1,266 +1,56 @@ '1.0', - 'info' => [ - 'style' => 'RPC', - 'product' => 'facebody', - 'version' => '2019-12-30', - ], + 'info' => ['style' => 'RPC', 'product' => 'facebody', 'version' => '2019-12-30'], 'directories' => [ [ - 'id' => 183667, - 'title' => '人脸搜索', + 'children' => ['AddFaceEntity', 'AddFace', 'CreateFaceDb', 'DeleteFace', 'DeleteFaceDb', 'DeleteFaceEntity', 'UpdateFaceEntity', 'SearchFace', 'GetFaceEntity', 'ListFaceEntities', 'ListFaceDbs'], 'type' => 'directory', - 'children' => [ - 'AddFaceEntity', - 'AddFace', - 'CreateFaceDb', - 'DeleteFace', - 'DeleteFaceDb', - 'DeleteFaceEntity', - 'UpdateFaceEntity', - 'SearchFace', - 'GetFaceEntity', - 'ListFaceEntities', - 'ListFaceDbs', - ], + 'title' => '人脸搜索', + 'id' => 315227, ], [ - 'id' => 130136, - 'title' => '人脸', + 'children' => ['AddFaceImageTemplate', 'DeleteFaceImageTemplate', 'QueryFaceImageTemplate', 'BlurFace', 'CompareFace', 'DetectFace', 'DetectLivingFace', 'FaceBeauty', 'EnhanceFace', 'RecognizeFace', 'RecognizePublicFace', 'MergeImageFace'], 'type' => 'directory', - 'children' => [ - 'AddFaceImageTemplate', - 'DeleteFaceImageTemplate', - 'QueryFaceImageTemplate', - 'BlurFace', - 'CompareFace', - 'DetectFace', - 'DetectLivingFace', - 'FaceBeauty', - 'EnhanceFace', - 'RecognizeFace', - 'RecognizePublicFace', - 'MergeImageFace', - ], + 'title' => '人脸', + 'id' => 315168, ], [ - 'id' => 130164, - 'title' => '人体', + 'children' => ['BodyPosture', 'DetectBodyCount', 'DetectPedestrian', 'PedestrianDetectAttribute'], 'type' => 'directory', - 'children' => [ - 'BodyPosture', - 'DetectBodyCount', - 'DetectPedestrian', - 'PedestrianDetectAttribute', - ], + 'title' => '人体', + 'id' => 315185, ], [ - 'id' => 130185, - 'title' => '实人认证', + 'children' => ['GetRealPersonVerificationResult', 'GenRealPersonVerificationToken'], 'type' => 'directory', - 'children' => [ - 'GetRealPersonVerificationResult', - 'GenRealPersonVerificationToken', - ], + 'title' => '实人认证', + 'id' => 315206, ], [ - 'id' => 130188, - 'title' => '其他识别', + 'children' => ['DetectCelebrity', 'DetectVideoLivingFace', 'GenerateHumanAnimeStyle', 'GenerateHumanSketchStyle', 'RecognizeAction', 'RecognizeExpression'], 'type' => 'directory', - 'children' => [ - 'DetectCelebrity', - 'DetectVideoLivingFace', - 'GenerateHumanAnimeStyle', - 'GenerateHumanSketchStyle', - 'RecognizeAction', - 'RecognizeExpression', - ], + 'title' => '其他识别', + 'id' => 315209, ], [ - 'id' => 130198, - 'title' => '其它', + 'children' => ['BatchAddFaces', 'ExtractFingerPrint', 'LiquifyFace', 'MonitorExamination', 'RetouchSkin'], 'type' => 'directory', - 'children' => [ - 'BatchAddFaces', - 'ExtractFingerPrint', - 'LiquifyFace', - 'MonitorExamination', - 'RetouchSkin', - ], + 'title' => '其它', + 'id' => 315219, ], [ - 'id' => 0, - 'title' => '其它', + 'children' => ['CompareFaceWithMask', 'DeepfakeFace', 'DetectInfraredLivingFace'], + 'title' => '其他', 'type' => 'directory', - 'children' => [ - 'CompareFaceWithMask', - 'DetectInfraredLivingFace', - 'DeepfakeFace', - ], ], ], 'components' => [ 'schemas' => [], ], 'apis' => [ - 'AddFaceEntity' => [ - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], - 'security' => [ - [ - 'AK' => [], - ], - ], - 'operationType' => 'read', - 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'create', - ], - 'parameters' => [ - [ - 'name' => 'DbName', - 'in' => 'formData', - 'schema' => [ - 'description' => '数据库名称。', - 'type' => 'string', - 'required' => true, - 'example' => 'default', - ], - ], - [ - 'name' => 'EntityId', - 'in' => 'formData', - 'schema' => [ - 'description' => '实体ID，可以包含数字、字母和下划线。', - 'type' => 'string', - 'required' => true, - 'example' => 'mm2', - ], - ], - [ - 'name' => 'Labels', - 'in' => 'formData', - 'schema' => [ - 'description' => '自定义标签，最多可以添加10个标签，总长度不超过1024个字符，具体格式要求如下：'."\n" - .'- 标签中仅支持下划线（_）和连字符（-），不支持其他特殊字符。'."\n" - .'- 标签之间使用英文逗号（,）分隔。', - 'type' => 'string', - 'required' => false, - 'example' => '视觉智能', - ], - ], - ], - 'responses' => [ - 200 => [ - 'schema' => [ - 'type' => 'object', - 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'DA7CAFEB-0A37-4496-9CDF-E3DBB6309CB2', - ], - ], - ], - ], - ], - 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'ParameterError', - 'errorMessage' => 'The parameter is invalid. Please check again.', - ], - ], - 403 => [ - [ - 'errorCode' => 'AuthFailed', - 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', - ], - ], - 408 => [ - [ - 'errorCode' => 'Timeout', - 'errorMessage' => 'The request has timed out.', - ], - ], - 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'The service is unavailable.', - ], - ], - ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"DA7CAFEB-0A37-4496-9CDF-E3DBB6309CB2\\"\\n}","errorExample":""},{"type":"xml","example":"DA7CAFEB-0A37-4496-9CDF-E3DBB6309CB2","errorExample":""}]', - 'title' => '添加人脸样本', - 'summary' => '本文介绍添加人脸样本AddFaceEntity的语法及示例。', - 'description' => '## 功能描述'."\n" - .'添加人脸样本能力用于向人脸数据库中添加人脸样本数据。人脸样本数据是用来标识用户的唯一性，如用户ID、员工ID等。'."\n" - ."\n" - .'> - 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" - .'- 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。'."\n" - ."\n" - .'## 接入指引'."\n" - .'1. 注册阿里云账号：打开[阿里云官网](https://www.aliyun.com)，在阿里云官网右上角，单击**立即注册**，按照操作提示完成账号注册。'."\n" - .'2. 开通能力：请确保您已开通[人脸人体服务](https://vision.aliyun.com/facebody)，若未开通服务请[立即开通](https://common-buy.aliyun.com/?commodityCode=viapi_facebody_public_cn#/open)。'."\n" - ."\n" - .'>'."\n" - .'本能力支持企业或个人认证用户开通。更多实名认证操作信息，请参见[实名认证](https://help.aliyun.com/knowledge_list/37170.html)。'."\n" - .'>'."\n" - ."\n" - .'3. 创建AccessKey：请确保您已[创建AccessKey](~~175144~~)，如果您使用的是子账号AccessKey，您需要给子账号赋予AliyunVIAPIFullAccess权限，具体操作，请参见[RAM授权](~~145025~~)。'."\n" - .'4. 前提条件：已通过[创建人脸数据库](~~159141~~)（CreateFaceDb）接口创建了数据库名称（DbName）。'."\n" - ."\n" - .'5. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/facebody/2019-12-30/AddFaceEntity?lang=JAVA)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" - .'6. 开发接入步骤：'."\n" - .'- 在[SDK总览](~~145033~~)中选择您要接入使用的SDK语言。'."\n" - .'- 在对应语言的SDK文档中找到AI类目为人脸人体（facebody）的SDK包进行安装。'."\n" - .'- 参考文档中提供的示例代码进行适当修改后调用。'."\n" - ."\n" - .'7. 示例代码：该能力常用语言的示例代码，请参见[添加人脸样本示例代码](~~477933~~)。'."\n" - ."\n" - .'8. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" - .'- [Web前端直接调用](~~467779~~)'."\n" - .'- [小程序场景下直接调用](~~467780~~)'."\n" - .'- [Android端直接调用](~~467781~~)'."\n" - .'- [iOS端直接调用](~~467782~~)'."\n" - ."\n" - .'## 限制说明'."\n" - .'- 每个人脸数据库支持最高5万人脸特征，暂不支持扩容。人脸样本和标签组合为一个人脸特征。'."\n" - .'- 每个人脸样本支持添加最多10个标签数据，暂不支持扩容。'."\n" - .'- 添加人脸样本接口提交任务并发默认为2QPS。'."\n" - ."\n" - .'## 计费说明'."\n" - .'添加人脸样本能力可免费调用。', - 'requestParamsDescription' => ' ', - 'responseParamsDescription' => '## SDK参考'."\n" - .'阿里云视觉AI人脸人体类目下的添加人脸样本能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。'."\n" - ."\n" - .'## 示例代码'."\n" - .'该能力常用语言的示例代码，请参见[添加人脸样本示例代码](~~477933~~)。', - 'extraInfo' => '## 错误码'."\n" - .'关于添加人脸样本的错误码，详情请参见[常见错误码](~~146756~~)。'."\n" - ."\n" - .'## 安全声明'."\n" - .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" - .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。'."\n" - .'- 平台不存储用户在使用服务过程中涉及的原始人脸图片或文件信息。'."\n" - .'- 平台针对超过6个月及以上没有API服务调用的用户的人脸特征向量数据进行冻结，确保无服务调用的客户信息安全。如需解冻，请通过钉钉群（23109592）联系我们。', - ], 'AddFace' => [ - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -268,85 +58,44 @@ ], 'operationType' => 'read', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'create', - ], + 'systemTags' => ['operationType' => 'create'], 'parameters' => [ [ 'name' => 'DbName', 'in' => 'formData', - 'schema' => [ - 'description' => '数据库名称。支持小写字母、数字、下划线的组合，长度1~64。', - 'type' => 'string', - 'required' => true, - 'example' => 'default', - ], + 'schema' => ['description' => '数据库名称。支持小写字母、数字、下划线的组合，长度1~64。', 'type' => 'string', 'required' => true, 'example' => 'default'], ], [ 'name' => 'ImageUrl', 'in' => 'formData', - 'schema' => [ - 'description' => '人脸图片地址，人脸必须是正面无遮挡人脸（若包含多张人脸则取最大人脸添加）。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。URL长度不超过1024个字符。', - 'type' => 'string', - 'required' => true, - 'example' => 'https://viapi-test.oss-cn-shanghai.aliyuncs.com/test/imgsearch/demo/1.png', - 'isFileTransferUrl' => true, - ], + 'schema' => ['description' => '人脸图片地址，人脸必须是正面无遮挡人脸（若包含多张人脸则取最大人脸添加）。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。URL长度不超过1024个字符。', 'type' => 'string', 'required' => true, 'example' => 'https://viapi-test.oss-cn-shanghai.aliyuncs.com/test/imgsearch/demo/1.png', 'isFileTransferUrl' => true], ], [ 'name' => 'EntityId', 'in' => 'formData', - 'schema' => [ - 'description' => '实体ID，用来标识用户的唯一性，如用户ID、员工ID等。每个实体可包含多张人脸图片。支持大小写字母、数字、下划线的组合，长度为1~64。', - 'type' => 'string', - 'required' => true, - 'example' => 'U1', - ], + 'schema' => ['description' => '实体ID，用来标识用户的唯一性，如用户ID、员工ID等。每个实体可包含多张人脸图片。支持大小写字母、数字、下划线的组合，长度为1~64。', 'type' => 'string', 'required' => true, 'example' => 'U1'], ], [ 'name' => 'ExtraData', 'in' => 'formData', - 'schema' => [ - 'description' => '自定义信息。支持字母、数字、标点符号和汉字。不超过512个字符。', - 'type' => 'string', - 'required' => false, - 'example' => '王小二', - ], + 'schema' => ['description' => '自定义信息。支持字母、数字、标点符号和汉字。不超过512个字符。', 'type' => 'string', 'required' => false, 'example' => '王小二'], ], [ 'name' => 'QualityScoreThreshold', 'in' => 'formData', - 'schema' => [ - 'description' => '质量分阈值。对新增人脸图片进行质量分析判断，得到的质量分小于该阈值则表示新增人脸图片质量不符合要求，添加失败。取值范围\\[0.0,100.0]。0.0或空则表示不做质量分判断逻辑。', - 'type' => 'number', - 'format' => 'float', - 'required' => false, - 'example' => '50.0', - ], + 'schema' => ['description' => '质量分阈值。对新增人脸图片进行质量分析判断，得到的质量分小于该阈值则表示新增人脸图片质量不符合要求，添加失败。取值范围\\[0.0,100.0]。0.0或空则表示不做质量分判断逻辑。', 'type' => 'number', 'format' => 'float', 'required' => false, 'example' => '50.0'], ], [ 'name' => 'SimilarityScoreThresholdInEntity', 'in' => 'formData', - 'schema' => [ - 'description' => '类内相似度阈值。将新增人脸图片与**EntityId**内已有人脸进行相似比对，小于该阈值则表示与其他人脸图片差异较大，添加失败.；若**EntityId**内没有人脸存在，则添加成功。取值范围\\[0.0,100.0]。0.0或空则表示不做类内相似度判断逻辑。参考值见[人脸比对1:1](~~151891~~)接口的返回结果字段**Thresholds**。', - 'type' => 'number', - 'format' => 'float', - 'required' => false, - 'example' => '50.0', - ], + 'schema' => ['description' => '类内相似度阈值。将新增人脸图片与**EntityId**内已有人脸进行相似比对，小于该阈值则表示与其他人脸图片差异较大，添加失败.；若**EntityId**内没有人脸存在，则添加成功。取值范围\\[0.0,100.0]。0.0或空则表示不做类内相似度判断逻辑。参考值见[人脸比对1:1](~~151891~~)接口的返回结果字段**Thresholds**。', 'type' => 'number', 'format' => 'float', 'required' => false, 'example' => '50.0'], ], [ 'name' => 'SimilarityScoreThresholdBetweenEntity', 'in' => 'formData', - 'schema' => [ - 'description' => '类间相似度阈值。将新增人脸图片与其他所有**EntityId**内已有人脸进行相似比对，大于等于该阈值则表示其他**EntityId**内存在相似人脸，出现重复，添加失败。取值范围\\[0.0,100.0]。0.0或空则表示不做类间相似度判断逻辑。参考值见[人脸比对1:1](~~151891~~)接口的返回结果字段**Thresholds**。'."\n" - ."\n" - .'> 类间相似度阈值检查仅适用于每个EntityId下首次上传的第一张人脸图片。', - 'type' => 'number', - 'format' => 'float', - 'required' => false, - 'example' => '50.0', - ], + 'schema' => ['description' => '类间相似度阈值。将新增人脸图片与其他所有**EntityId**内已有人脸进行相似比对，大于等于该阈值则表示其他**EntityId**内存在相似人脸，出现重复，添加失败。取值范围\\[0.0,100.0]。0.0或空则表示不做类间相似度判断逻辑。参考值见[人脸比对1:1](~~151891~~)接口的返回结果字段**Thresholds**。'."\n" + ."\n" + .'> 类间相似度阈值检查仅适用于每个EntityId下首次上传的第一张人脸图片。', 'type' => 'number', 'format' => 'float', 'required' => false, 'example' => '50.0'], ], ], 'responses' => [ @@ -355,26 +104,13 @@ 'description' => '1', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '2B93C43A-F824-40C8-AF79-844342B0F43A', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '2B93C43A-F824-40C8-AF79-844342B0F43A'], 'Data' => [ 'description' => '返回的结果数据内容。', 'type' => 'object', 'properties' => [ - 'FaceId' => [ - 'description' => '输出人脸ID。', - 'type' => 'string', - 'example' => '5', - ], - 'QualitieScore' => [ - 'description' => '输入图像中的人脸质量分。', - 'type' => 'number', - 'format' => 'float', - 'example' => '99.79581', - ], + 'FaceId' => ['description' => '输出人脸ID。', 'type' => 'string', 'example' => '5'], + 'QualitieScore' => ['description' => '输入图像中的人脸质量分。', 'type' => 'number', 'format' => 'float', 'example' => '99.79581'], ], ], ], @@ -383,28 +119,16 @@ ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'ParameterError', - 'errorMessage' => 'The parameter is invalid. Please check again.', - ], + ['errorCode' => 'ParameterError', 'errorMessage' => 'The parameter is invalid. Please check again.', 'description' => '参数错误，请检查参数值'], ], 403 => [ - [ - 'errorCode' => 'AuthFailed', - 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', - ], + ['errorCode' => 'AuthFailed', 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', 'description' => '授权失败，请检查RAM权限配置'], ], 408 => [ - [ - 'errorCode' => 'Timeout', - 'errorMessage' => 'The request has timed out.', - ], + ['errorCode' => 'Timeout', 'errorMessage' => 'The request has timed out.', 'description' => '请求超时，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'The service is unavailable.', - ], + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'The service is unavailable.', 'description' => '服务不可用，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"2B93C43A-F824-40C8-AF79-844342B0F43A\\",\\n \\"Data\\": {\\n \\"FaceId\\": \\"5\\",\\n \\"QualitieScore\\": 99.79581\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n 2B93C43A-F824-40C8-AF79-844342B0F43A\\n \\n 5\\n 99.79581\\n \\n","errorExample":""}]', @@ -472,16 +196,24 @@ .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。'."\n" .'- 平台不存储用户在使用服务过程中涉及的原始人脸图片或文件信息。'."\n" .'- 平台针对超过6个月及以上没有API服务调用的用户的人脸特征向量数据进行冻结，确保无服务调用的客户信息安全。如需解冻，请通过钉钉群（23109592）联系我们。', - ], - 'CreateFaceDb' => [ - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'viapi-facebody:AddFace', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + ], + 'AddFaceEntity' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -489,19 +221,24 @@ ], 'operationType' => 'read', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'create', - ], + 'systemTags' => ['operationType' => 'create'], 'parameters' => [ [ - 'name' => 'Name', + 'name' => 'DbName', 'in' => 'formData', - 'schema' => [ - 'description' => '数据库名称。支持字母、数字和下划线的组合，长度为1~64。', - 'type' => 'string', - 'required' => true, - 'example' => 'default', - ], + 'schema' => ['description' => '数据库名称。', 'type' => 'string', 'required' => true, 'example' => 'default'], + ], + [ + 'name' => 'EntityId', + 'in' => 'formData', + 'schema' => ['description' => '实体ID，可以包含数字、字母和下划线。', 'type' => 'string', 'required' => true, 'example' => 'mm2'], + ], + [ + 'name' => 'Labels', + 'in' => 'formData', + 'schema' => ['description' => '自定义标签，最多可以添加10个标签，总长度不超过1024个字符，具体格式要求如下：'."\n" + .'- 标签中仅支持下划线（_）和连字符（-），不支持其他特殊字符。'."\n" + .'- 标签之间使用英文逗号（,）分隔。', 'type' => 'string', 'required' => false, 'example' => '视觉智能'], ], ], 'responses' => [ @@ -509,47 +246,31 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '818D24A6-E368-46B3-99C5-3CF36D98CCA3', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'DA7CAFEB-0A37-4496-9CDF-E3DBB6309CB2'], ], + 'description' => '', ], ], ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'ParameterError', - 'errorMessage' => 'The parameter is invalid. Please check again.', - ], + ['errorCode' => 'ParameterError', 'errorMessage' => 'The parameter is invalid. Please check again.', 'description' => '参数错误，请检查参数值'], ], 403 => [ - [ - 'errorCode' => 'AuthFailed', - 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', - ], + ['errorCode' => 'AuthFailed', 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', 'description' => '授权失败，请检查RAM权限配置'], ], 408 => [ - [ - 'errorCode' => 'Timeout', - 'errorMessage' => 'The request has timed out.', - ], + ['errorCode' => 'Timeout', 'errorMessage' => 'The request has timed out.', 'description' => '请求超时，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'The service is unavailable.', - ], + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'The service is unavailable.', 'description' => '服务不可用，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"818D24A6-E368-46B3-99C5-3CF36D98CCA3\\"\\n}","errorExample":""},{"type":"xml","example":"818D24A6-E368-46B3-99C5-3CF36D98CCA3","errorExample":""}]', - 'title' => '创建人脸数据库', - 'summary' => '本文介绍创建人脸数据库CreateFaceDb的语法及示例。', + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"DA7CAFEB-0A37-4496-9CDF-E3DBB6309CB2\\"\\n}","errorExample":""},{"type":"xml","example":"DA7CAFEB-0A37-4496-9CDF-E3DBB6309CB2","errorExample":""}]', + 'title' => '添加人脸样本', + 'summary' => '本文介绍添加人脸样本AddFaceEntity的语法及示例。', 'description' => '## 功能描述'."\n" - .'创建人脸数据库能力可以创建人脸数据库用来存放人脸数据。每个阿里云账号可以创建10个人脸数据库，10个人脸数据库支持最多50万张人脸照片的入库，单个人脸数据库支持最多5万张人脸照片入库，单次搜索可支持最多10个人脸数据库的同时搜索（跨库搜索）。'."\n" - .'人脸数据库、人脸照片入库量、单次搜索的人脸总数以及单次搜索的人脸数据库暂不支持扩容。'."\n" + .'添加人脸样本能力用于向人脸数据库中添加人脸样本数据。人脸样本数据是用来标识用户的唯一性，如用户ID、员工ID等。'."\n" ."\n" .'> - 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" .'- 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。'."\n" @@ -557,187 +278,226 @@ .'## 接入指引'."\n" .'1. 注册阿里云账号：打开[阿里云官网](https://www.aliyun.com)，在阿里云官网右上角，单击**立即注册**，按照操作提示完成账号注册。'."\n" .'2. 开通能力：请确保您已开通[人脸人体服务](https://vision.aliyun.com/facebody)，若未开通服务请[立即开通](https://common-buy.aliyun.com/?commodityCode=viapi_facebody_public_cn#/open)。'."\n" + ."\n" .'>'."\n" .'本能力支持企业或个人认证用户开通。更多实名认证操作信息，请参见[实名认证](https://help.aliyun.com/knowledge_list/37170.html)。'."\n" .'>'."\n" ."\n" .'3. 创建AccessKey：请确保您已[创建AccessKey](~~175144~~)，如果您使用的是子账号AccessKey，您需要给子账号赋予AliyunVIAPIFullAccess权限，具体操作，请参见[RAM授权](~~145025~~)。'."\n" - .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/facebody/2019-12-30/CreateFaceDb?lang=JAVA)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" - .'5. 开发接入步骤：'."\n" + .'4. 前提条件：已通过[创建人脸数据库](~~159141~~)（CreateFaceDb）接口创建了数据库名称（DbName）。'."\n" + ."\n" + .'5. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/facebody/2019-12-30/AddFaceEntity?lang=JAVA)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" + .'6. 开发接入步骤：'."\n" .'- 在[SDK总览](~~145033~~)中选择您要接入使用的SDK语言。'."\n" .'- 在对应语言的SDK文档中找到AI类目为人脸人体（facebody）的SDK包进行安装。'."\n" .'- 参考文档中提供的示例代码进行适当修改后调用。'."\n" ."\n" - .'6. 示例代码：该能力常用语言的示例代码，请参见[创建人脸数据库示例代码](~~477924~~)。'."\n" + .'7. 示例代码：该能力常用语言的示例代码，请参见[添加人脸样本示例代码](~~477933~~)。'."\n" ."\n" - .'7. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" + .'8. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" .'- [Web前端直接调用](~~467779~~)'."\n" .'- [小程序场景下直接调用](~~467780~~)'."\n" .'- [Android端直接调用](~~467781~~)'."\n" .'- [iOS端直接调用](~~467782~~)'."\n" ."\n" .'## 限制说明'."\n" - .'创建人脸数据库接口提交任务并发默认为2QPS。'."\n" + .'- 每个人脸数据库支持最高5万人脸特征，暂不支持扩容。人脸样本和标签组合为一个人脸特征。'."\n" + .'- 每个人脸样本支持添加最多10个标签数据，暂不支持扩容。'."\n" + .'- 添加人脸样本接口提交任务并发默认为2QPS。'."\n" ."\n" .'## 计费说明'."\n" - .'创建人脸数据库能力可免费调用。', + .'添加人脸样本能力可免费调用。', 'requestParamsDescription' => ' ', 'responseParamsDescription' => '## SDK参考'."\n" - .'阿里云视觉AI人脸人体类目下的创建人脸数据库能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。'."\n" + .'阿里云视觉AI人脸人体类目下的添加人脸样本能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。'."\n" ."\n" .'## 示例代码'."\n" - .'该能力常用语言的示例代码，请参见[创建人脸数据库示例代码](~~477924~~)。', + .'该能力常用语言的示例代码，请参见[添加人脸样本示例代码](~~477933~~)。', 'extraInfo' => '## 错误码'."\n" - .'关于创建人脸数据库的错误码，详情请参见[常见错误码](~~146756~~)。'."\n" + .'关于添加人脸样本的错误码，详情请参见[常见错误码](~~146756~~)。'."\n" ."\n" .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。'."\n" .'- 平台不存储用户在使用服务过程中涉及的原始人脸图片或文件信息。'."\n" .'- 平台针对超过6个月及以上没有API服务调用的用户的人脸特征向量数据进行冻结，确保无服务调用的客户信息安全。如需解冻，请通过钉钉群（23109592）联系我们。', - ], - 'DeleteFace' => [ - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'viapi-facebody:AddFaceEntity', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + ], + 'AddFaceImageTemplate' => [ + 'summary' => '本文介绍图像人脸融合模板增加AddFaceImageTemplate的语法及示例。', + 'methods' => ['post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'delete', - ], + 'systemTags' => ['operationType' => 'create'], 'parameters' => [ [ - 'name' => 'DbName', - 'in' => 'formData', - 'schema' => [ - 'description' => '数据库名称。', - 'type' => 'string', - 'required' => true, - 'example' => 'default', - ], - ], - [ - 'name' => 'FaceId', + 'name' => 'ImageURL', 'in' => 'formData', - 'schema' => [ - 'description' => '人脸数据ID。', - 'type' => 'string', - 'required' => true, - 'example' => '001', - ], + 'schema' => ['description' => '人脸模板的图像地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。'."\n" + .'输入限制：'."\n" + .'- 图像格式：JPG、JPEG、PNG。'."\n" + .'- 图像大小：不超过20 MB。'."\n" + .'- 图像分辨率：大于等于128×128像素，小于等于2000×2000像素，最长边小于等于2000像素。'."\n" + .'- URL地址中不能包含中文字符。'."\n" + .'- 支持输入多人图像，建议图像中人脸个数不超过5个。', 'type' => 'string', 'required' => true, 'example' => 'https://invi-label.oss-cn-shanghai.aliyuncs.com/label/temp/faceswap/img_facefusion/template/sucai1.jpg', 'isFileTransferUrl' => true], ], ], 'responses' => [ 200 => [ 'schema' => [ + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'FAC90D32-2F04-5AD4-B94B-BAA163AB3724', - ], - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => '798A721D-7C7F-4D87-A125-1D04B3055C2C'], + 'Data' => [ + 'description' => '返回的结果数据内容。', + 'type' => 'object', + 'properties' => [ + 'TemplateId' => ['description' => '模板ID。', 'type' => 'string', 'example' => '6cd509ea-54fa-4730-8e9d-c94cadcda048'], + 'FaceInfos' => [ + 'description' => '用户输入图为多个人脸时，返回各人脸ID和位置信息。'."\n" + ."\n" + .'> 只有在多人脸场景中，才会返回**FaceInfos**参数。', + 'type' => 'array', + 'items' => [ + 'description' => '用户输入图为多个人脸时，返回各人脸ID和位置信息。'."\n" + ."\n" + .'> 只有在多人脸场景中，才会返回**FaceInfos**参数。', + 'type' => 'object', + 'properties' => [ + 'TemplateFaceID' => ['description' => '人脸对应的子模板ID。', 'type' => 'string', 'example' => 'string 6cd509ea-54fa-4730-8e9d-c94cadcda048_0'], + 'FaceRect' => [ + 'description' => '人脸对应的位置信息。', + 'type' => 'object', + 'properties' => [ + 'X' => ['description' => '人脸框左上角横坐标。', 'type' => 'string', 'example' => '254'], + 'Y' => ['description' => '人脸框左上角纵坐标。', 'type' => 'string', 'example' => '318'], + 'Height' => ['description' => '人脸框高度。', 'type' => 'string', 'example' => '94'], + 'Width' => ['description' => '人脸框宽度。', 'type' => 'string', 'example' => '89'], + ], + ], + ], + ], + ], + ], + ], + ], ], ], ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'ParameterError', - 'errorMessage' => 'The parameter is invalid. Please check again.', - ], + ['errorCode' => 'ParameterError', 'errorMessage' => 'The parameter is invalid. Please check again.', 'description' => '参数错误，请检查参数值'], ], 403 => [ - [ - 'errorCode' => 'AuthFailed', - 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', - ], + ['errorCode' => 'AuthFailed', 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', 'description' => '授权失败，请检查RAM权限配置'], ], 408 => [ - [ - 'errorCode' => 'Timeout', - 'errorMessage' => 'The request has timed out.', - ], + ['errorCode' => 'Timeout', 'errorMessage' => 'The request has timed out.', 'description' => '请求超时，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'The service is unavailable.', - ], + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'The service is unavailable.', 'description' => '服务不可用，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"FAC90D32-2F04-5AD4-B94B-BAA163AB3724\\"\\n}","errorExample":""},{"type":"xml","example":"\\n FAC90D32-2F04-5AD4-B94B-BAA163AB3724\\n","errorExample":""}]', - 'title' => '删除人脸', - 'summary' => '本文介绍删除人脸DeleteFace的语法及示例。', + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"798A721D-7C7F-4D87-A125-1D04B3055C2C\\",\\n \\"Data\\": {\\n \\"TemplateId\\": \\"6cd509ea-54fa-4730-8e9d-c94cadcda048\\",\\n \\"FaceInfos\\": [\\n {\\n \\"TemplateFaceID\\": \\"string 6cd509ea-54fa-4730-8e9d-c94cadcda048_0\\",\\n \\"FaceRect\\": {\\n \\"X\\": \\"254\\",\\n \\"Y\\": \\"318\\",\\n \\"Height\\": \\"94\\",\\n \\"Width\\": \\"89\\"\\n }\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n 7BC58484-6724-508F-857D-0E7035AD5DEA\\n \\n 30f738a9-1e69-4ecb-8bbc-50bf0aa75e60\\n \\n","errorExample":""}]', + 'title' => '添加人脸图像模板', 'description' => '## 功能描述'."\n" - .'删除人脸能力可以删除指定数据库中的人脸图片信息。'."\n" - ."\n" - .'>'."\n" + .'图像人脸融合模板增加功能可以将已通过内容审核的人脸图像，作为人脸融合的模板图，供图像人脸融合功能使用。'."\n" ."\n" - .'- 人脸图片信息删除后不可恢复，请谨慎操作。'."\n" - .'- 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" + .'> - 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" .'- 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。'."\n" ."\n" - .'>'."\n" - ."\n" .'## 接入指引'."\n" .'1. 注册阿里云账号：打开[阿里云官网](https://www.aliyun.com)，在阿里云官网右上角，单击**立即注册**，按照操作提示完成账号注册。'."\n" .'2. 开通能力：请确保您已开通[人脸人体服务](https://vision.aliyun.com/facebody)，若未开通服务请[立即开通](https://common-buy.aliyun.com/?commodityCode=viapi_facebody_public_cn#/open)。'."\n" - ."\n" .'>'."\n" - .'本能力支持企业或个人认证用户开通。更多实名认证操作信息，请参见[实名认证](https://help.aliyun.com/knowledge_list/37170.html)。'."\n" + .'本能力仅限企业认证用户开通。更多实名认证操作信息，请参见[实名认证](https://help.aliyun.com/knowledge_list/37170.html)。'."\n" .'>'."\n" ."\n" .'3. 创建AccessKey：请确保您已[创建AccessKey](~~175144~~)，如果您使用的是子账号AccessKey，您需要给子账号赋予AliyunVIAPIFullAccess权限，具体操作，请参见[RAM授权](~~145025~~)。'."\n" - .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/facebody/2019-12-30/DeleteFace?lang=JAVA)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" + ."\n" + .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/facebody/2019-12-30/AddFaceImageTemplate?lang=JAVA&sdkStyle=old¶ms=%7B%7D&tab=DEMO)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" .'5. 开发接入步骤：'."\n" .'- 在[SDK总览](~~145033~~)中选择您要接入使用的SDK语言。'."\n" .'- 在对应语言的SDK文档中找到AI类目为人脸人体（facebody）的SDK包进行安装。'."\n" .'- 参考文档中提供的示例代码进行适当修改后调用。'."\n" ."\n" - .'6. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" + .'6. 示例代码：该能力常用语言的示例代码，请参见[图像人脸融合模板增加示例代码](~~478119~~)。'."\n" + ."\n" + .'7. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" .'- [Web前端直接调用](~~467779~~)'."\n" .'- [小程序场景下直接调用](~~467780~~)'."\n" .'- [Android端直接调用](~~467781~~)'."\n" .'- [iOS端直接调用](~~467782~~)'."\n" ."\n" - .'## 限制说明'."\n" - .'删除人脸接口提交任务并发默认为2QPS。'."\n" + .'## 输入限制'."\n" + .'- 图像格式：JPG、JPEG、PNG。'."\n" + .'- 图像大小：不超过20 MB。'."\n" + .'- 图像分辨率：大于等于128×128像素，小于等于2000×2000像素，最长边小于等于2000像素。'."\n" + .'- URL地址中不能包含中文字符。'."\n" + .'- 支持输入多人图像，建议图像中人脸个数不超过5个。'."\n" + .'- 不限制可以增加的模板数量。'."\n" + ."\n" + .'## 图像质量建议'."\n" + .'- 要求保证图像中的人脸清晰。图像中人脸尺寸建议大于64×64像素，人脸区域建议不大于全图区域的2/3。'."\n" + .'- 建议图像中人脸五官区域轮廓完整，无明显遮挡。人脸融合算法支持人脸偏侧一定角度，在偏侧角度不超过30度的情况下能取得更佳效果。'."\n" + ."\n" + .'推荐图像示例：'."\n" + .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20221114/jris/MergeImageFacetuijian.png" width="300)'."\n" + .'不推荐图像示例：'."\n" + .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20221114/rkbx/MergeImageFacebutuijian.png" width="300)'."\n" ."\n" .'## 计费说明'."\n" - .'删除人脸能力可免费调用。', - 'requestParamsDescription' => ' ', + .'图像人脸融合模板增加能力可免费调用。', 'responseParamsDescription' => '## SDK参考'."\n" - .'阿里云视觉AI人脸人体类目下的删除人脸能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。', + .'阿里云视觉AI人脸人体类目下的图像人脸融合模板增加能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。'."\n" + ."\n" + .'## 示例代码'."\n" + .'该能力常用语言的示例代码，请参见[图像人脸融合模板增加示例代码](~~478119~~)。', 'extraInfo' => '## 错误码'."\n" - .'关于删除人脸的错误码，详情请参见[常见错误码](~~146756~~)。'."\n" + .'关于图像人脸融合模板增加的错误码，详情请参见[常见错误码](~~146756~~)。'."\n" ."\n" .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" - .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。'."\n" - .'- 平台不存储用户在使用服务过程中涉及的原始人脸图片或文件信息。'."\n" - .'- 平台针对超过6个月及以上没有API服务调用的用户的人脸特征向量数据进行冻结，确保无服务调用的客户信息安全。如需解冻，请通过钉钉群（23109592）联系我们。', - ], - 'DeleteFaceDb' => [ - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', + .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'viapi-facebody:AddFaceImageTemplate', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + ], + 'BatchAddFaces' => [ + 'summary' => '本文介绍批量添加人脸数据BatchAddFaces的语法及示例。', + 'methods' => ['post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -745,30 +505,95 @@ ], 'operationType' => 'write', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'delete', - ], + 'systemTags' => ['operationType' => 'none', 'riskType' => 'none', 'chargeType' => 'free', 'tenantRelevance' => 'publicInformation'], 'parameters' => [ [ - 'name' => 'Name', + 'name' => 'DbName', + 'in' => 'formData', + 'schema' => ['description' => '数据库名称。支持小写字母、数字、下划线的组合，长度1~64。', 'type' => 'string', 'required' => true, 'example' => 'default'], + ], + [ + 'name' => 'EntityId', + 'in' => 'formData', + 'schema' => ['description' => '实体ID，用来标识用户的唯一性，如用户ID、员工ID等。每个实体可包含多张人脸图片。支持大小写字母、数字、下划线的组合，长度为1~64。', 'type' => 'string', 'required' => true, 'example' => 'U1'], + ], + [ + 'name' => 'SimilarityScoreThresholdInEntity', + 'in' => 'formData', + 'schema' => ['description' => '类内相似度阈值。将新增人脸图片与**EntityId**内已有人脸进行相似比对，小于该阈值则表示与其他人脸图片差异较大，添加失败.；若**EntityId**内没有人脸存在，则添加成功。取值范围\\[0.0,100.0]。0.0或空则表示不做类内相似度判断逻辑。参考值见[人脸比对1:1](~~151891~~)接口的返回结果字段**Thresholds**。', 'type' => 'number', 'format' => 'float', 'required' => false, 'example' => '50.0'], + ], + [ + 'name' => 'SimilarityScoreThresholdBetweenEntity', 'in' => 'formData', + 'schema' => ['description' => '类间相似度阈值。将新增人脸图片与其他所有**EntityId**内已有人脸进行相似比对，大于等于该阈值则表示其他**EntityId**内存在相似人脸，出现重复，添加失败。取值范围\\[0.0,100.0]。0.0或空则表示不做类间相似度判断逻辑。参考值见[人脸比对1:1](~~151891~~)接口的返回结果字段**Thresholds**。'."\n" + ."\n" + .'> 类间相似度阈值检查仅适用于每个EntityId下首次上传的第一张人脸图片。', 'type' => 'number', 'format' => 'float', 'required' => false, 'example' => '50.0'], + ], + [ + 'name' => 'Faces', + 'in' => 'formData', + 'style' => 'json', 'schema' => [ - 'description' => '数据库名称。', - 'type' => 'string', + 'description' => '人脸信息。', + 'type' => 'array', + 'items' => [ + 'description' => '1', + 'type' => 'object', + 'properties' => [ + 'ExtraData' => ['description' => '自定义信息。支持字母、数字、标点符号和汉字。不超过512个字符。', 'type' => 'string', 'required' => false, 'example' => '王小二'], + 'ImageURL' => ['description' => '人脸图像URL地址。人脸必须是正面无遮挡单人人脸。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。URL长度不超过1024个字符。', 'type' => 'string', 'required' => true, 'example' => 'https://viapi-test.oss-cn-shanghai.aliyuncs.com/test/imgsearch/demo/1.png', 'isFileTransferUrl' => true], + ], + 'required' => false, + ], 'required' => true, - 'example' => 'default', + 'maxItems' => 5, ], ], + [ + 'name' => 'QualityScoreThreshold', + 'in' => 'formData', + 'schema' => ['description' => '质量分阈值。对新增人脸图片进行质量分析判断，得到的质量分小于该阈值则表示新增人脸图片质量不符合要求，添加失败。取值范围\\[0.0,100.0]。0.0或空则表示不做质量分判断逻辑。', 'type' => 'number', 'format' => 'float', 'required' => false, 'example' => '50.0'], + ], ], 'responses' => [ 200 => [ 'schema' => [ + 'title' => 'Schema of Response', + 'description' => '1', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '203AE658-CFE1-507D-B105-F88CD1F1F71B', + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => 'C46A46D0-3263-181A-A1EE-0901E4595390'], + 'Data' => [ + 'description' => '返回的结果数据内容。', + 'type' => 'object', + 'properties' => [ + 'InsertedFaces' => [ + 'description' => '添加成功的记录结果。', + 'type' => 'array', + 'items' => [ + 'description' => '1', + 'type' => 'object', + 'properties' => [ + 'ImageURL' => ['description' => '人脸图像地址，与输入的ImageUrl相同，用来标记图像记录。', 'type' => 'string', 'example' => 'https://viapi-test.oss-cn-shanghai.aliyuncs.com/test/imgsearch/demo/xxxx.png'], + 'FaceId' => ['description' => '输出人脸ID。', 'type' => 'string', 'example' => '16350536'], + 'QualitieScore' => ['description' => '输入图像中的人脸质量分。', 'type' => 'number', 'format' => 'float', 'example' => '99.79581'], + ], + ], + ], + 'FailedFaces' => [ + 'description' => '添加失败的记录结果。', + 'type' => 'array', + 'items' => [ + 'description' => '1', + 'type' => 'object', + 'properties' => [ + 'ImageURL' => ['description' => '人脸图像地址，与输入的ImageUrl相同，用来标记图像记录。', 'type' => 'string', 'example' => 'https://viapi-test.oss-cn-shanghai.aliyuncs.com/test/imgsearch/demo/xxxx.png'], + 'Code' => ['description' => '错误码。', 'type' => 'string', 'example' => 'ClientError.IllegalArgument'], + 'Message' => ['description' => '错误信息。', 'type' => 'string', 'example' => 'not found the db=test'], + ], + ], + ], + ], ], ], ], @@ -776,44 +601,26 @@ ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'ParameterError', - 'errorMessage' => 'The parameter is invalid. Please check again.', - ], + ['errorCode' => 'ParameterError', 'errorMessage' => 'The parameter is invalid. Please check again.', 'description' => '参数错误，请检查参数值'], ], 403 => [ - [ - 'errorCode' => 'AuthFailed', - 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', - ], + ['errorCode' => 'AuthFailed', 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', 'description' => '授权失败，请检查RAM权限配置'], ], 408 => [ - [ - 'errorCode' => 'Timeout', - 'errorMessage' => 'The request has timed out.', - ], + ['errorCode' => 'Timeout', 'errorMessage' => 'The request has timed out.', 'description' => '请求超时，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'The service is unavailable.', - ], + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'The service is unavailable.', 'description' => '服务不可用，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"203AE658-CFE1-507D-B105-F88CD1F1F71B\\"\\n}","errorExample":""},{"type":"xml","example":"\\n 203AE658-CFE1-507D-B105-F88CD1F1F71B\\n","errorExample":""}]', - 'title' => '删除人脸数据库', - 'summary' => '本文介绍删除数据库DeleteFaceDb的语法及示例。', + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"C46A46D0-3263-181A-A1EE-0901E4595390\\",\\n \\"Data\\": {\\n \\"InsertedFaces\\": [\\n {\\n \\"ImageURL\\": \\"https://viapi-test.oss-cn-shanghai.aliyuncs.com/test/imgsearch/demo/xxxx.png\\",\\n \\"FaceId\\": \\"16350536\\",\\n \\"QualitieScore\\": 99.79581\\n }\\n ],\\n \\"FailedFaces\\": [\\n {\\n \\"ImageURL\\": \\"https://viapi-test.oss-cn-shanghai.aliyuncs.com/test/imgsearch/demo/xxxx.png\\",\\n \\"Code\\": \\"ClientError.IllegalArgument\\",\\n \\"Message\\": \\"not found the db=test\\"\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n C46A46D0-3263-181A-A1EE-0901E4595390\\n \\n \\n https://viapi-test.oss-cn-shanghai.aliyuncs.com/test/imgsearch/demo/xxxx.png\\n 16350536\\n 99.79581\\n \\n \\n https://viapi-test.oss-cn-shanghai.aliyuncs.com/test/imgsearch/demo/xxxx.png\\n ClientError.IllegalArgument\\n not found the db=test\\n \\n \\n","errorExample":""}]', + 'title' => '批量添加人脸数据', 'description' => '## 功能描述'."\n" - .'删除数据库能力用于删除指定的人脸数据库。'."\n" - ."\n" - .'>'."\n" + .'批量添加人脸数据能力可以为已创建好的人脸样本中批量添加人脸数据，每个人脸样本最多可以添加5张人脸照片，所以批量添加最多一次添加5张人脸照片。'."\n" ."\n" - .'- 数据库删除后不可恢复，请谨慎操作。'."\n" - .'- 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" + .'> - 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" .'- 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。'."\n" ."\n" - .'>'."\n" - ."\n" .'## 接入指引'."\n" .'1. 注册阿里云账号：打开[阿里云官网](https://www.aliyun.com)，在阿里云官网右上角，单击**立即注册**，按照操作提示完成账号注册。'."\n" .'2. 开通能力：请确保您已开通[人脸人体服务](https://vision.aliyun.com/facebody)，若未开通服务请[立即开通](https://common-buy.aliyun.com/?commodityCode=viapi_facebody_public_cn#/open)。'."\n" @@ -823,7 +630,7 @@ .'>'."\n" ."\n" .'3. 创建AccessKey：请确保您已[创建AccessKey](~~175144~~)，如果您使用的是子账号AccessKey，您需要给子账号赋予AliyunVIAPIFullAccess权限，具体操作，请参见[RAM授权](~~145025~~)。'."\n" - .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/facebody/2019-12-30/DeleteFaceDb?lang=JAVA)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" + .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/facebody/2019-12-30/BatchAddFaces?lang=JAVA)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" .'5. 开发接入步骤：'."\n" .'- 在[SDK总览](~~145033~~)中选择您要接入使用的SDK语言。'."\n" .'- 在对应语言的SDK文档中找到AI类目为人脸人体（facebody）的SDK包进行安装。'."\n" @@ -835,32 +642,49 @@ .'- [Android端直接调用](~~467781~~)'."\n" .'- [iOS端直接调用](~~467782~~)'."\n" ."\n" + .'## 输入限制'."\n" + .'- 图像格式：JPG、JPEG、PNG、BMP。'."\n" + .'- 图像大小：不超过5 MB。'."\n" + .'- 图像分辨率：大于32×32像素，小于4096×4096像素。人脸占比不低于64×64像素。'."\n" + .'- URL地址中不能包含中文字符。'."\n" + ."\n" + .'>当图像分辨率超过最大限制时，请先将图片进行缩放，调整图片大小，具体请参见[图片缩放](~~44688~~)。 '."\n" + ."\n" .'## 限制说明'."\n" - .'删除数据库接口提交任务并发默认为2QPS。'."\n" + .'批量添加人脸数据接口提交任务并发默认为2QPS。'."\n" ."\n" .'## 计费说明'."\n" - .'删除数据库能力可免费调用。', + .'批量添加人脸数据能力可免费调用。', 'requestParamsDescription' => ' ', 'responseParamsDescription' => '## SDK参考'."\n" - .'阿里云视觉AI人脸人体类目下的删除数据库能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。', + .'阿里云视觉AI人脸人体类目下的批量添加人脸数据能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。', 'extraInfo' => '## 错误码'."\n" - .'关于删除数据库的错误码，详情请参见[常见错误码](~~146756~~)。'."\n" + .'关于批量添加人脸数据的错误码，详情请参见[常见错误码](~~146756~~)。'."\n" ."\n" .'## 安全声明'."\n" + ."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。'."\n" .'- 平台不存储用户在使用服务过程中涉及的原始人脸图片或文件信息。'."\n" .'- 平台针对超过6个月及以上没有API服务调用的用户的人脸特征向量数据进行冻结，确保无服务调用的客户信息安全。如需解冻，请通过钉钉群（23109592）联系我们。', - ], - 'DeleteFaceEntity' => [ - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'viapi-facebody:BatchAddFaces', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + ], + 'BlurFace' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -868,29 +692,12 @@ ], 'operationType' => 'read', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'delete', - ], + 'systemTags' => [], 'parameters' => [ [ - 'name' => 'DbName', - 'in' => 'formData', - 'schema' => [ - 'description' => '数据库名称。', - 'type' => 'string', - 'required' => true, - 'example' => 'default', - ], - ], - [ - 'name' => 'EntityId', + 'name' => 'ImageURL', 'in' => 'formData', - 'schema' => [ - 'description' => '实体ID，如员工编号。可以包含数字、字母和下划线。', - 'type' => 'string', - 'required' => true, - 'example' => 'wood', - ], + 'schema' => ['description' => '图像URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。', 'type' => 'string', 'required' => true, 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/BlurFace/BlurFace1.png', 'isFileTransferUrl' => true], ], ], 'responses' => [ @@ -898,64 +705,52 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'DA7CAFEB-0A37-4496-9CDF-E3DBB6309CB2', + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '4C6080B0-64C4-488E-BBA6-245749CA11AD'], + 'Data' => [ + 'description' => '结果数据内容。', + 'type' => 'object', + 'properties' => [ + 'ImageURL' => ['description' => '脱敏后的图片URL地址。'."\n" + .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。', 'type' => 'string', 'example' => 'http://viapi-cn-shanghai-dha-segmenter.oss-cn-shanghai.aliyuncs.com/upload/result_FaceBlur/2020-8-5/invi_FaceBlur_015966077063461060948_IBdDsq.jpg?Expires=1596609506&OSSAccessKeyId=LTAI****************&Signature=x8n3jq1X91Sq7BKWE4vRHSu6g9****'], + 'MaskURL' => ['description' => '脱敏后的图片Mask地址。'."\n" + .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。', 'type' => 'string', 'example' => 'http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/person-image-cartoonizer/59697D68-2A6E-4553-89BD-0FADD07881E8_7ee5_20201027-070958.jpg?Expires=1603784400&OSSAccessKeyId=LTAI****************&Signature=ut2kn46Lz%2FRwqJ9jWJ0RBDut12****'], + ], ], ], + 'description' => '', ], ], ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'ParameterError', - 'errorMessage' => 'The parameter is invalid. Please check again.', - ], + ['errorCode' => 'ParameterError', 'errorMessage' => 'The parameter is invalid. Please check again.', 'description' => '参数错误，请检查参数值'], ], 403 => [ - [ - 'errorCode' => 'AuthFailed', - 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', - ], + ['errorCode' => 'AuthFailed', 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', 'description' => '授权失败，请检查RAM权限配置'], ], 408 => [ - [ - 'errorCode' => 'Timeout', - 'errorMessage' => 'The request has timed out.', - ], + ['errorCode' => 'Timeout', 'errorMessage' => 'The request has timed out.', 'description' => '请求超时，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'The service is unavailable.', - ], + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'The service is unavailable.', 'description' => '服务不可用，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"DA7CAFEB-0A37-4496-9CDF-E3DBB6309CB2\\"\\n}","errorExample":""},{"type":"xml","example":"DA7CAFEB-0A37-4496-9CDF-E3DBB6309CB2","errorExample":""}]', - 'title' => '删除人脸样本', - 'summary' => '本文介绍删除人脸样本DeleteFaceEntity的语法及示例。', + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"4C6080B0-64C4-488E-BBA6-245749CA11AD\\",\\n \\"Data\\": {\\n \\"ImageURL\\": \\"http://viapi-cn-shanghai-dha-segmenter.oss-cn-shanghai.aliyuncs.com/upload/result_FaceBlur/2020-8-5/invi_FaceBlur_015966077063461060948_IBdDsq.jpg?Expires=1596609506&OSSAccessKeyId=LTAI****************&Signature=x8n3jq1X91Sq7BKWE4vRHSu6g9****\\",\\n \\"MaskURL\\": \\"http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/person-image-cartoonizer/59697D68-2A6E-4553-89BD-0FADD07881E8_7ee5_20201027-070958.jpg?Expires=1603784400&OSSAccessKeyId=LTAI****************&Signature=ut2kn46Lz%2FRwqJ9jWJ0RBDut12****\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n 4C6080B0-64C4-488E-BBA6-245749CA11AD\\n \\n http://viapi-cn-shanghai-dha-segmenter.oss-cn-shanghai.aliyuncs.com/upload/result_FaceBlur/2020-8-5/invi_FaceBlur_015966077063461060948_IBdDsq.jpg?Expires=1596609506&OSSAccessKeyId=LTAI****************&Signature=x8n3jq1X91Sq7BKWE4vRHSu6g9****\\n http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/person-image-cartoonizer/59697D68-2A6E-4553-89BD-0FADD07881E8_7ee5_20201027-070958.jpg?Expires=1603784400&OSSAccessKeyId=LTAI****************&Signature=ut2kn46Lz%2FRwqJ9jWJ0RBDut12****\\n \\n","errorExample":""}]', + 'title' => '人脸信息脱敏', + 'summary' => '本文介绍人脸信息脱敏BlurFace的语法及示例。', 'description' => '## 功能描述'."\n" - .'删除人脸样本能力用于删除人脸数据库中的人脸样本数据。'."\n" - ."\n" - .'>'."\n" + .'人脸信息脱敏能力对输入图像中的人脸进行模糊处理，输出脱敏后的图像。'."\n" ."\n" - .'- 删除人脸样本，样本中的人脸数据也会被删除，且不可恢复，请谨慎操作。'."\n" - .'- 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" + .'> - 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" + .'- 当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击[立即试用](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=BlurFace)对该能力进行更直观试用以及在线购买。'."\n" .'- 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。'."\n" ."\n" - .'>'."\n" - ."\n" .'## 接入指引'."\n" .'1. 注册阿里云账号：打开[阿里云官网](https://www.aliyun.com)，在阿里云官网右上角，单击**立即注册**，按照操作提示完成账号注册。'."\n" .'2. 开通能力：请确保您已开通[人脸人体服务](https://vision.aliyun.com/facebody)，若未开通服务请[立即开通](https://common-buy.aliyun.com/?commodityCode=viapi_facebody_public_cn#/open)。'."\n" - .'>'."\n" - .'本能力支持企业或个人认证用户开通。更多实名认证操作信息，请参见[实名认证](https://help.aliyun.com/knowledge_list/37170.html)。'."\n" - .'>'."\n" - ."\n" + .'> 本能力支持企业或个人认证用户开通。更多实名认证操作信息，请参见[实名认证](https://help.aliyun.com/knowledge_list/37170.html)。'."\n" .'3. 创建AccessKey：请确保您已[创建AccessKey](~~175144~~)，如果您使用的是子账号AccessKey，您需要给子账号赋予AliyunVIAPIFullAccess权限，具体操作，请参见[RAM授权](~~145025~~)。'."\n" - .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/facebody/2019-12-30/DeleteFaceEntity?lang=JAVA)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" + .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/facebody/2019-12-30/BlurFace?lang=JAVA&sdkStyle=dara¶ms=%7B%22ImageURL%22%3A%22http%3A%2F%2Fviapi-test.oss-cn-shanghai.aliyuncs.com%2Fviapi-3.0domepic%2Ffacebody%2FBlurFace%2FBlurFace1.png%22%7D&tab=DEMO)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" .'5. 开发接入步骤：'."\n" .'- 在[SDK总览](~~145033~~)中选择您要接入使用的SDK语言。'."\n" .'- 在对应语言的SDK文档中找到AI类目为人脸人体（facebody）的SDK包进行安装。'."\n" @@ -967,32 +762,45 @@ .'- [Android端直接调用](~~467781~~)'."\n" .'- [iOS端直接调用](~~467782~~)'."\n" ."\n" - .'## 限制说明'."\n" - .'删除人脸样本接口提交任务并发默认为2QPS。'."\n" - ."\n\n" - .'## 计费说明'."\n" - .'删除人脸样本能力可免费调用。', - 'requestParamsDescription' => ' ', + .'## 输入限制'."\n" + ."\n" + .'- 图像格式：JPEG、JPG、PNG、BMP。'."\n" + .'- 图像大小：不超过3 MB。'."\n" + .'- 图像分辨率：大于32x32像素，小于2000×2000像素。'."\n" + .'- URL地址中不能包含中文字符。'."\n" + ."\n" + .'> 当图像分辨率超过最大限制时，请先将图片进行缩放，调整图片大小，具体请参见[图片缩放](~~44688~~)。'."\n" + ."\n" + .'## 计费说明'."\n" + .'关于人脸信息脱敏的计费方式及报价，请参见[计费介绍](~~184049~~)。'."\n" + .'> 下方调试接口为付费接口，如需免费体验调试请前往[体验中心](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=BlurFace)。'."\n", + 'requestParamsDescription' => ' ', 'responseParamsDescription' => '## SDK参考'."\n" - .'阿里云视觉AI人脸人体类目下的删除人脸样本能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。', + .'阿里云视觉AI人脸人体类目下的人脸信息脱敏能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。', 'extraInfo' => '## 错误码'."\n" - .'关于删除人脸样本的错误码，详情请参见[常见错误码](~~146756~~)。'."\n" + .'关于人脸信息脱敏的错误码，详情请参见[常见错误码](~~146756~~)。'."\n" ."\n" .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" - .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。'."\n" - .'- 平台不存储用户在使用服务过程中涉及的原始人脸图片或文件信息。'."\n" - .'- 平台针对超过6个月及以上没有API服务调用的用户的人脸特征向量数据进行冻结，确保无服务调用的客户信息安全。如需解冻，请通过钉钉群（23109592）联系我们。', - ], - 'UpdateFaceEntity' => [ - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', + .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-facebody:BlurFace', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + ], + 'BodyPosture' => [ + 'methods' => ['post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -1000,39 +808,12 @@ ], 'operationType' => 'read', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'update', - ], + 'systemTags' => [], 'parameters' => [ [ - 'name' => 'DbName', - 'in' => 'formData', - 'schema' => [ - 'description' => '数据库名称。', - 'type' => 'string', - 'required' => true, - 'example' => 'default', - ], - ], - [ - 'name' => 'EntityId', - 'in' => 'formData', - 'schema' => [ - 'description' => '实体ID，如用户ID、员工ID等。', - 'type' => 'string', - 'required' => true, - 'example' => 'mm2', - ], - ], - [ - 'name' => 'Labels', + 'name' => 'ImageURL', 'in' => 'formData', - 'schema' => [ - 'description' => '自定义标签，最多可以添加10个标签。', - 'type' => 'string', - 'required' => false, - 'example' => '视觉智能', - ], + 'schema' => ['description' => '图像URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。', 'type' => 'string', 'required' => true, 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/BodyPosture/BodyPosture4.jpg', 'isFileTransferUrl' => true], ], ], 'responses' => [ @@ -1040,60 +821,107 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'DA7CAFEB-0A37-4496-9CDF-E3DBB6309CB2', + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'B854094B-9231-4A54-89AB-C377CB0D237D'], + 'Data' => [ + 'description' => '返回的结果数据内容。', + 'type' => 'object', + 'properties' => [ + 'Outputs' => [ + 'description' => '检测结果。', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'HumanCount' => ['description' => '人体的个数。', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'Results' => [ + 'description' => '检测结果。', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'Bodies' => [ + 'description' => '检测到的人体关键点信息。', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'Positions' => [ + 'description' => '关键点坐标，为相对坐标，即相对于图像尺寸的坐标。', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'Points' => [ + 'type' => 'array', + 'items' => ['description' => '关键点\\[x,y]坐标。'."\n" + .'- x坐标，取值范围[0, 1]，相对于图像宽度width的相对坐标，实际坐标为x*width。'."\n" + .'- y坐标，取值范围[0, 1]，相对于图像高度height的相对坐标，实际坐标为y*height。', 'type' => 'number', 'format' => 'float', 'example' => '[0.46296295523643494, 0.1304347813129425]'], + 'description' => '', + ], + ], + 'description' => '', + ], + ], + 'Confident' => ['description' => '关键点置信度。', 'type' => 'number', 'format' => 'float', 'example' => '0.91309475898742676'], + 'Label' => ['description' => '关键点的标签。包括如下类型：`nose、neck、right_shoulder、right_elbow、right_wrist、left_shoulder、left_elbow、left_wrist、right_hip、right_knee、right_ankle、left_hip、left_knee、left_ankle、right_eye、left_eye、right_ear、left_ear`。', 'type' => 'string', 'example' => 'nose'], + ], + 'description' => '', + ], + ], + ], + 'description' => '', + ], + ], + ], + 'description' => '', + ], + ], + 'MetaObject' => [ + 'description' => '图像基本信息。', + 'type' => 'object', + 'properties' => [ + 'Width' => ['description' => '图像宽度，单位像素。', 'type' => 'integer', 'format' => 'int32', 'example' => '500'], + 'Height' => ['description' => '图像高度，单位像素。', 'type' => 'integer', 'format' => 'int32', 'example' => '500'], + ], + ], + ], ], ], + 'description' => '', ], ], ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'ParameterError', - 'errorMessage' => 'The parameter is invalid. Please check again.', - ], + ['errorCode' => 'ParameterError', 'errorMessage' => 'The parameter is invalid. Please check again.', 'description' => '参数错误，请检查参数值'], ], 403 => [ - [ - 'errorCode' => 'AuthFailed', - 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', - ], + ['errorCode' => 'AuthFailed', 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', 'description' => '授权失败，请检查RAM权限配置'], ], 408 => [ - [ - 'errorCode' => 'Timeout', - 'errorMessage' => 'The request has timed out.', - ], + ['errorCode' => 'Timeout', 'errorMessage' => 'The request has timed out.', 'description' => '请求超时，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'The service is unavailable.', - ], + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'The service is unavailable.', 'description' => '服务不可用，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"DA7CAFEB-0A37-4496-9CDF-E3DBB6309CB2\\"\\n}","errorExample":""},{"type":"xml","example":"DA7CAFEB-0A37-4496-9CDF-E3DBB6309CB2","errorExample":""}]', - 'title' => '更新人脸样本', - 'summary' => '更更新人脸样本。', + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"B854094B-9231-4A54-89AB-C377CB0D237D\\",\\n \\"Data\\": {\\n \\"Outputs\\": [\\n {\\n \\"HumanCount\\": 1,\\n \\"Results\\": [\\n {\\n \\"Bodies\\": [\\n {\\n \\"Positions\\": [\\n {\\n \\"Points\\": [\\n 0\\n ]\\n }\\n ],\\n \\"Confident\\": 0.9130947589874268,\\n \\"Label\\": \\"nose\\"\\n }\\n ]\\n }\\n ]\\n }\\n ],\\n \\"MetaObject\\": {\\n \\"Width\\": 500,\\n \\"Height\\": 500\\n }\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n B854094B-9231-4A54-89AB-C377CB0D237D\\n \\n \\n 500\\n 500\\n \\n \\n \\n \\n 0.91309475898742676\\n \\n \\n 0.46296295523643494\\n 0.1304347813129425\\n \\n \\n \\n 0.7284882664680481\\n \\n \\n 0.47685185074806213\\n 0.22282609343528748\\n \\n \\n \\n 0.78919297456741333\\n \\n \\n 0.3888888955116272\\n 0.239130437374115\\n \\n \\n \\n 1\\n \\n \\n","errorExample":""}]', + 'title' => '人体姿态关键点', + 'summary' => '本文介绍人体姿态关键点BodyPosture的语法及示例。', 'description' => '## 功能描述'."\n" - .'更新人脸样本能力用于更新人脸数据库中的人脸样本数据。'."\n" + .'人体姿态关键点能力可以获取人体的十八个关键点信息。包括：nose、neck、right_shoulder、right_elbow、right_wrist、left_shoulder、left_elbow、left_wrist、right_hip、right_knee、right_ankle、left_hip、left_knee、left_ankle、right_eye、left_eye、right_ear、left_ear。'."\n" ."\n" .'> - 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" + .'- 当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击[立即试用](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=BodyPosture)对该能力进行更直观试用以及在线购买。'."\n" .'- 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。'."\n" ."\n" .'## 接入指引'."\n" .'1. 注册阿里云账号：打开[阿里云官网](https://www.aliyun.com)，在阿里云官网右上角，单击**立即注册**，按照操作提示完成账号注册。'."\n" .'2. 开通能力：请确保您已开通[人脸人体服务](https://vision.aliyun.com/facebody)，若未开通服务请[立即开通](https://common-buy.aliyun.com/?commodityCode=viapi_facebody_public_cn#/open)。'."\n" - ."\n" - .'>'."\n" - .'本能力支持企业或个人认证用户开通。更多实名认证操作信息，请参见[实名认证](https://help.aliyun.com/knowledge_list/37170.html)。'."\n" - .'>'."\n" + .'> 本能力支持企业或个人认证用户开通。更多实名认证操作信息，请参见[实名认证](https://help.aliyun.com/knowledge_list/37170.html)。'."\n" ."\n" .'3. 创建AccessKey：请确保您已[创建AccessKey](~~175144~~)，如果您使用的是子账号AccessKey，您需要给子账号赋予AliyunVIAPIFullAccess权限，具体操作，请参见[RAM授权](~~145025~~)。'."\n" - .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/facebody/2019-12-30/UpdateFaceEntity?lang=JAVA)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" + .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/facebody/2019-12-30/BodyPosture?&lang=JAVA&sdkStyle=old¶ms=%7B%22ImageURL%22%3A%22http%3A%2F%2Fviapi-test.oss-cn-shanghai.aliyuncs.com%2Fviapi-3.0domepic%2Ffacebody%2FBodyPosture%2FBodyPosture1.jpg%22%7D&tab=DEMO)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" .'5. 开发接入步骤：'."\n" .'- 在[SDK总览](~~145033~~)中选择您要接入使用的SDK语言。'."\n" .'- 在对应语言的SDK文档中找到AI类目为人脸人体（facebody）的SDK包进行安装。'."\n" @@ -1105,33 +933,46 @@ .'- [Android端直接调用](~~467781~~)'."\n" .'- [iOS端直接调用](~~467782~~)'."\n" ."\n" - .'## 限制说明'."\n" - .'更新人脸样本接口提交任务并发默认为2QPS。'."\n" + .'## 输入限制'."\n" + .'- 图像格式：JPEG、JPG、BMP、PNG。'."\n" + .'- 图像大小：不超过3 MB。'."\n" + .'- URL地址中不能包含中文字符。'."\n" ."\n" .'## 计费说明'."\n" - .'更新人脸样本能力可免费调用。', + .'关于人体姿态关键点的计费方式及报价，请参见[计费介绍](~~184049~~)。'."\n" + ."\n" + .'> 下方调试接口为付费接口，如需免费体验调试请前往[体验中心](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=BodyPosture)。', 'requestParamsDescription' => ' ', 'responseParamsDescription' => '## SDK参考'."\n" - .'阿里云视觉AI人脸人体类目下的更新人脸样本能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。', + .'阿里云视觉AI人脸人体类目下的人体姿态关键点能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。', 'extraInfo' => '## 错误码'."\n" - .'关于更新人脸样本的错误码。详情请参见[常见错误码](~~146756~~)。'."\n" + .'关于人体姿态关键点的错误码，详情请参见[常见错误码](~~146756~~)。'."\n" + ."\n" + .'## 开源模型体验'."\n" + .'更多开源免费模型体验及下载，详见魔搭社区：[HRNet人体关键点-2D](https://www.modelscope.cn/models/damo/cv_hrnetv2w32_body-2d-keypoints_image/summary)和[全身关键点检测-通用领域-2D](https://www.modelscope.cn/models/damo/cv_hrnetw48_human-wholebody-keypoint_image/summary)。'."\n" ."\n" .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" - .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。'."\n" - .'- 平台不存储用户在使用服务过程中涉及的原始人脸图片或文件信息。'."\n" - .'- 平台针对超过6个月及以上没有API服务调用的用户的人脸特征向量数据进行冻结，确保无服务调用的客户信息安全。如需解冻，请通过钉钉群（23109592）联系我们。', - ], - 'SearchFace' => [ - 'summary' => '本文介绍人脸搜索SearchFace的语法及示例。', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', + .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-facebody:BodyPosture', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + ], + 'CompareFace' => [ + 'summary' => '本文介绍人脸比对CompareFace的语法及示例。', + 'methods' => ['post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -1139,80 +980,37 @@ ], 'operationType' => 'read', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'get', - ], + 'systemTags' => [], 'parameters' => [ [ - 'name' => 'DbName', - 'in' => 'formData', - 'schema' => [ - 'description' => '数据库名称。'."\n" - ."\n" - .'> **DbName**与**DbNames**二选一，如果同时配置了两个参数，**DbNames**优先级高于**DbName**。', - 'type' => 'string', - 'required' => false, - 'example' => 'default', - ], - ], - [ - 'name' => 'ImageUrl', + 'name' => 'QualityScoreThreshold', 'in' => 'formData', - 'schema' => [ - 'description' => '图像URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。URL长度不超过1024个字符。', - 'type' => 'string', - 'required' => true, - 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/SearchFace/SearchFace1.png', - 'isFileTransferUrl' => true, - ], + 'schema' => ['title' => '质量分阈值，取值范围 [0.0, 100.0], 0.0或空 表示不做质量分判断逻辑。', 'description' => '质量分阈值，对人脸图片进行质量分析判断，若某张人脸质量分小于该阈值，则会在返回结果上增加MessageTips说明。', 'type' => 'number', 'format' => 'float', 'required' => false, 'example' => '98.5'], ], [ - 'name' => 'Limit', + 'name' => 'ImageURLA', 'in' => 'formData', - 'schema' => [ - 'description' => '单个人脸列表中搜索人脸结果数量限制，取值范围1~100。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => true, - 'maximum' => '1000', - 'minimum' => '0', - 'example' => '2', - 'pattern' => '^\\d+$', - ], + 'schema' => ['description' => '图像A的URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。'."\n" + ."\n" + .'> **ImageURLA**与**ImageDataA**二选一，当URL方式与Base64编码方式共存时，URL方式优先。', 'type' => 'string', 'required' => false, 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/CompareFace/CompareFace-right1.png', 'isFileTransferUrl' => true], ], [ - 'name' => 'DbNames', + 'name' => 'ImageURLB', 'in' => 'formData', - 'schema' => [ - 'description' => '数据库名称列表，以英文逗号（,）分割，可以实现跨库查询，最大支持10个数据库。'."\n" - .'> **DbName**与**DbNames**二选一，如果同时配置了两个参数，**DbNames**优先级高于**DbName**。', - 'type' => 'string', - 'required' => false, - 'example' => 'test1,test2,test3', - 'maxLength' => 4096, - ], + 'schema' => ['description' => '图像B的URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。'."\n" + .'> **ImageURLB**与**ImageDataB**二选一，当URL方式与Base64编码方式共存时，URL方式优先。', 'type' => 'string', 'required' => false, 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/CompareFace/CompareFace-left1.png', 'isFileTransferUrl' => true], ], [ - 'name' => 'QualityScoreThreshold', + 'name' => 'ImageDataA', 'in' => 'formData', - 'schema' => [ - 'description' => '质量分阈值。对人脸图片进行质量分析判断，得到的质量分小于该阈值则表示人脸图片质量不符合要求，比对失败。取值范围\\[0.0,100.0]。0.0或空则表示不做质量分判断逻辑。', - 'type' => 'number', - 'format' => 'float', - 'required' => false, - 'example' => '50.0', - ], + 'schema' => ['description' => '图像A的Base64编码字符串。当与URL方式共存时，URL方式优先。文件的Base64编码处理操作，请参见[文件Base64处理](~~468191~~)。'."\n" + .'> **ImageURLA**与**ImageDataA**二选一，当URL方式与Base64编码方式共存时，URL方式优先。', 'type' => 'string', 'required' => false, 'example' => '/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAgGBgcGBQgHBwcJCQgK****'], ], [ - 'name' => 'MaxFaceNum', + 'name' => 'ImageDataB', 'in' => 'formData', - 'schema' => [ - 'description' => '对输入图像中多少个人脸进行检索比对，控制人脸样本列表个数，取值范围1~10，默认为5。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '5', - ], + 'schema' => ['description' => '图像B的Base64编码字符串。当与URL方式共存时，URL方式优先。文件的Base64编码处理操作，请参见[文件Base64处理](~~468191~~)。'."\n" + .'> **ImageURLB**与**ImageDataB**二选一，当URL方式与Base64编码方式共存时，URL方式优先。', 'type' => 'string', 'required' => false, 'example' => '/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAgGBgcGBQgHBwcJCQgQ****'], ], ], 'responses' => [ @@ -1221,102 +1019,52 @@ 'description' => '1', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '4159e64a-0fe8-436c-a8de-ee531555db3c', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'B352CD68-C847-5C48-BE68-3F266356FDD7'], 'Data' => [ 'description' => '返回的结果数据内容。', 'type' => 'object', 'properties' => [ - 'MatchList' => [ - 'description' => '匹配的结果列表，如果输入图像中多个人脸，则这里会返回多个数据。', + 'Thresholds' => [ + 'description' => '1', 'type' => 'array', - 'items' => [ - 'description' => '1', - 'type' => 'object', - 'properties' => [ - 'FaceItems' => [ - 'description' => '匹配的人脸数据列表。', - 'type' => 'array', - 'items' => [ - 'description' => '1', - 'type' => 'object', - 'properties' => [ - 'EntityId' => [ - 'description' => '实体ID，用来标识用户的唯一性，如用户ID、员工ID等。每个实体可包含多张人脸图片。支持大小写字母、数字、下划线的组合，长度为1~64。', - 'type' => 'string', - 'example' => 'U1', - ], - 'FaceId' => [ - 'description' => '人脸图片数据ID，需要全局唯一，不可重复。支持小写字母、数字和下划线的组合。长度为1~64。', - 'type' => 'string', - 'example' => '001', - ], - 'Score' => [ - 'description' => '人脸的相似度，取值范围-1.0~1.0，取小数点后6位，数值越大相似度越高。建议的三个参考阈值为0.35，0.45和0.6，分别对应千分之一，万分之一和十万分之一的误识率。阈值设置越高，误识率越低，通过率也越低，对安全性要求越高的场合，可以设置越高的阈值。', - 'type' => 'number', - 'format' => 'float', - 'example' => '0.892133', - ], - 'ExtraData' => [ - 'description' => '自定义信息（字符串）。支持字母、数字、标点符号和汉字。不超过512个字符。', - 'type' => 'string', - 'example' => '王小二', - ], - 'DbName' => [ - 'description' => '数据库名称。', - 'type' => 'string', - 'example' => 'default', - ], - 'Confidence' => [ - 'description' => '转换后的置信度 ，取值范围0.0~100.0，数值越大相似度越高，建议的三个参考阈值为60.48，67.87和72.62，分别对应千分之一，万分之一和十万分之一的误识率，阈值设置越高，误识率越低，通过率也越低，对安全性要求越高的场合，可以设置越高的阈值。', - 'type' => 'number', - 'format' => 'float', - 'example' => '36.820168', - ], - ], - ], - ], - 'Location' => [ - 'description' => '输入图像中的人脸坐标信息。', - 'type' => 'object', - 'properties' => [ - 'Width' => [ - 'description' => '宽度，单位像素。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '200', - ], - 'Height' => [ - 'description' => '高度，单位像素。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '200', - ], - 'Y' => [ - 'description' => '左上角y坐标。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '6', - ], - 'X' => [ - 'description' => '左上角x坐标。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '5', - ], - ], - ], - 'QualitieScore' => [ - 'description' => '输入图像中的人脸质量分。', - 'type' => 'number', - 'format' => 'float', - 'example' => '71.7349', - ], - ], - ], + 'items' => ['description' => '误识率在1/1000，1/10000，1/100000的情况下分别对应的置信度阈值。例如`[61.0,69.0,75.0]`，表示误识率为1/1000的情况下，置信度（Confidence）超过61%就可以认为是同一个人。', 'type' => 'number', 'format' => 'float', 'example' => '[61,69,75]'], + ], + 'RectBList' => [ + 'description' => '1', + 'type' => 'array', + 'items' => ['description' => '图片B中最大人脸矩形框`[left, top, width, height]`，例如`[169,48,125,162]`。', 'type' => 'integer', 'format' => 'int32', 'example' => '[169,48,125,162]'], + ], + 'Confidence' => ['description' => '两张图片中的最大人脸属于同一个人的置信度，取值范围0~100。供参考的三个阈值是61，69和75，分别对应千分之一，万分之一和十万分之一误识率。阈值设置越高，误识率越低，通过率也越低，对安全性要求越高的场合，可以设置更高的阈值。如果某张图片中没有人脸，则报错误信息。', 'type' => 'number', 'format' => 'float', 'example' => '88.4831771850586'], + 'RectAList' => [ + 'description' => '1', + 'type' => 'array', + 'items' => ['description' => '图片A中最大人脸矩形框`[left, top, width, height]`，例如`[157,82,147,188]`。', 'type' => 'integer', 'format' => 'int32', 'example' => '[157,82,147,188]'], + ], + 'QualityScoreA' => ['title' => '输入图像A的质量分', 'description' => '输入图像A的质量分。', 'type' => 'number', 'format' => 'float', 'example' => '99.65772247314453'], + 'QualityScoreB' => ['title' => '输入图像A的质量分', 'description' => '输入图像B的质量分。', 'type' => 'number', 'format' => 'float', 'example' => '98.01177978515625'], + 'MessageTips' => ['title' => '信息提示信息，纯文字描述，目前支持质量分的提示信息', 'description' => '提示信息，纯文字描述，以下提示信息单独出现或是几条提示信息的组合。'."\n" + .'质量相关提示（某张人脸质量分小于请求参数质量分阈值时会出现）：'."\n" + .'- `imageA quality score less threshold`：图像A的质量分小于输入参数设置的阈值。'."\n" + .'- `imageB quality score less threshold`：图像B的质量分小于输入参数设置的阈值。'."\n" + ."\n" + .'人脸尺寸相关提示（检测到人脸且人脸宽或高小于50像素时会有该提示信息。出现该提示信息时，请尽可能输入像素数大于64x64的人脸，并请酌情参考返回的对比置信度Confidence值）：'."\n" + .'- `face in imageA is too small`：图像A中的人脸太小。'."\n" + .'- `face in imageB is too small`：图像B中的人脸太小。', 'type' => 'string', 'example' => 'imageB quality score less threshold'], + 'IsMaskA' => ['description' => '图片A中的人脸是否戴口罩。'."\n" + .'- 0：不戴口罩。'."\n" + .'- 1：戴口罩。', 'type' => 'integer', 'format' => 'int64', 'example' => '0'], + 'IsMaskB' => ['description' => '图片B中的人脸是否戴口罩。'."\n" + .'- 0：不戴口罩。'."\n" + .'- 1：戴口罩。', 'type' => 'integer', 'format' => 'int64', 'example' => '0'], + 'LandmarksAList' => [ + 'type' => 'array', + 'items' => ['description' => '图片A人脸框所对应的人脸关键点坐标，顺序分别为左眼水平坐标，左眼垂直坐标，右眼水平坐标，右眼垂直坐标，鼻尖水平坐标，鼻尖垂直坐标，左嘴角水平坐标，左嘴角垂直坐标，右嘴角水平坐标，右嘴角垂直坐标。', 'type' => 'integer', 'format' => 'int64', 'example' => '[201,146,266,159,222,190,187,208,255,219]'], + 'description' => '', + ], + 'LandmarksBList' => [ + 'type' => 'array', + 'items' => ['description' => '图片B人脸框所对应的人脸关键点坐标，顺序分别为左眼水平坐标，左眼垂直坐标，右眼水平坐标，右眼垂直坐标，鼻尖水平坐标，鼻尖垂直坐标，左嘴角水平坐标，左嘴角垂直坐标，右嘴角水平坐标，右嘴角垂直坐标。', 'type' => 'integer', 'format' => 'int64', 'example' => '[199,115,248,109,215,146,206,167,260,162]'], + 'description' => '', ], ], ], @@ -1326,93 +1074,83 @@ ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'ParameterError', - 'errorMessage' => 'The parameter is invalid. Please check again.', - ], + ['errorCode' => 'ParameterError', 'errorMessage' => 'The parameter is invalid. Please check again.', 'description' => '参数错误，请检查参数值'], ], 403 => [ - [ - 'errorCode' => 'AuthFailed', - 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', - ], + ['errorCode' => 'AuthFailed', 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', 'description' => '授权失败，请检查RAM权限配置'], ], 408 => [ - [ - 'errorCode' => 'Timeout', - 'errorMessage' => 'The request has timed out.', - ], + ['errorCode' => 'Timeout', 'errorMessage' => 'The request has timed out.', 'description' => '请求超时，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'The service is unavailable.', - ], + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'The service is unavailable.', 'description' => '服务不可用，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"4159e64a-0fe8-436c-a8de-ee531555db3c\\",\\n \\"Data\\": {\\n \\"MatchList\\": [\\n {\\n \\"FaceItems\\": [\\n {\\n \\"EntityId\\": \\"U1\\",\\n \\"FaceId\\": \\"001\\",\\n \\"Score\\": 0.892133,\\n \\"ExtraData\\": \\"王小二\\",\\n \\"DbName\\": \\"default\\",\\n \\"Confidence\\": 36.820168\\n }\\n ],\\n \\"Location\\": {\\n \\"Width\\": 200,\\n \\"Height\\": 200,\\n \\"Y\\": 6,\\n \\"X\\": 5\\n },\\n \\"QualitieScore\\": 71.7349\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n 4159e64a-0fe8-436c-a8de-ee531555db3c\\n \\n \\n \\n U1\\n 001\\n 0.892133\\n 王小二\\n default\\n 36.820168\\n \\n \\n 200\\n 200\\n 6\\n 5\\n \\n 71.7349\\n \\n \\n","errorExample":""}]', - 'title' => '搜索人脸', + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"B352CD68-C847-5C48-BE68-3F266356FDD7\\",\\n \\"Data\\": {\\n \\"Thresholds\\": [\\n 0\\n ],\\n \\"RectBList\\": [\\n 0\\n ],\\n \\"Confidence\\": 88.4831771850586,\\n \\"RectAList\\": [\\n 0\\n ],\\n \\"QualityScoreA\\": 99.65772247314453,\\n \\"QualityScoreB\\": 98.01177978515625,\\n \\"MessageTips\\": \\"imageB quality score less threshold\\",\\n \\"IsMaskA\\": 0,\\n \\"IsMaskB\\": 0,\\n \\"LandmarksAList\\": [\\n 0\\n ],\\n \\"LandmarksBList\\": [\\n 0\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n B352CD68-C847-5C48-BE68-3F266356FDD7\\n \\n 61\\n 69\\n 75\\n 169\\n 48\\n 125\\n 162\\n 88.4831771850586\\n 157\\n 82\\n 147\\n 188\\n 99.65772247314453\\n 98.01177978515625\\n 0\\n 0\\n 201\\n 146\\n 266\\n 159\\n 222\\n 190\\n 187\\n 208\\n 255\\n 219\\n 199\\n 115\\n 248\\n 109\\n 215\\n 146\\n 206\\n 167\\n 260\\n 162\\n \\n","errorExample":""}]', + 'title' => '人脸比对', 'description' => '## 功能描述'."\n" - .'人脸搜索能力可以根据输入图片，在数据库中搜索并返回相似的人脸图片数据。单次搜索最多可支持10个人脸数据库的同时搜索（跨库搜索）。该能力根据人脸特征来进行识别，通过把人脸图像特征化，然后比较人脸特征的相似程度。'."\n" + .'人脸比对1:1能力基于您输入的两张图片，分别挑选两张图片中的最大人脸进行比较，判断是否为同一人。'."\n" + .'- 两张人脸图片对比：比对两张图片中人脸的相似度，返回这两个人脸的矩形框坐标、人脸五点关键点坐标、比对的置信度，以及不同误识率的置信度阈值。'."\n" + .'- 支持多种图片类型：支持生活照、证件照、身份证芯片照、带网纹照等类型的人脸对比。'."\n" + ."\n" + .'关于该接口功能的示例图如下：'."\n" + .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20221227/ghxo/CompareFace.png" width="500)'."\n" ."\n" .'> - 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" - .'- 当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击[立即试用](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=SearchFace)对该能力进行更直观试用以及在线购买。'."\n" + .'- 当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击[立即试用](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=CompareFace)对该能力进行更直观试用以及在线购买。'."\n" .'- 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。'."\n" ."\n" + .'## 应用场景'."\n" + .'- 金融业务：比对用户身份证照片和现场拍摄的已获授权的照片，判断用户信息真实性，可提供快速安全的身份核验流程，适用于互联网远程开户、刷脸支付等金融业务。'."\n" + .'- 员工考勤：无接触式刷脸考勤，疫情防控场景下企业考勤首选，且能有效防止代打卡等作弊行为。'."\n" + .'- 公共服务：客户直接刷脸办理业务，通过人脸比对识别身份信息，减少身份证查验、复印存档等环节，提高公共服务窗口办理业务的效率。'."\n" + .'- 酒店自助入住：住客刷脸自助办理入住，将现场授权获取的照片，与身份证提取的照片进行1:1比对，确保住客身份的真实性的同时，减少人工核查和服务成本，向住客提供便捷的入住体验。'."\n" + ."\n" .'## 特色优势'."\n" - .'- 识别精度高：人脸检测识别等算法精度处于业内领先水平。'."\n" - .'- 识别效率高：毫秒级响应，支持实时识别。'."\n" + .'- 高精度识别： 人脸检测识别算法精度处于业内领先水平。'."\n" + .'- 平台服务稳定：提供在高并发、大流量下的毫秒级识别响应和保障。'."\n" + .'- 关键点精准定位：支持眼睛、鼻子、嘴部五官位置的高精度精准定位。'."\n" + .'- 简单易用：可直接调用的 API 接口，服务简单易用，易被集成，兼容性强。'."\n" ."\n" .'## 接入指引'."\n" .'1. 注册阿里云账号：打开[阿里云官网](https://www.aliyun.com)，在阿里云官网右上角，单击**立即注册**，按照操作提示完成账号注册。'."\n" .'2. 开通能力：请确保您已开通[人脸人体服务](https://vision.aliyun.com/facebody)，若未开通服务请[立即开通](https://common-buy.aliyun.com/?commodityCode=viapi_facebody_public_cn#/open)。'."\n" - ."\n" - .'>'."\n" - ."\n" - .'- 本能力支持企业或个人认证用户开通。更多实名认证操作信息，请参见[实名认证](https://help.aliyun.com/knowledge_list/37170.html)。'."\n" - .'- 如果您是已经在使用的老客户，需要使用海量人脸建库和搜索的能力，请通过钉钉群（23109592）联系我们。'."\n" - ."\n" - .'>'."\n" + .'> 本能力支持企业或个人认证用户开通。更多实名认证操作信息，请参见[实名认证](https://help.aliyun.com/knowledge_list/37170.html)。'."\n" ."\n" .'3. 创建AccessKey：请确保您已[创建AccessKey](~~175144~~)，如果您使用的是子账号AccessKey，您需要给子账号赋予AliyunVIAPIFullAccess权限，具体操作，请参见[RAM授权](~~145025~~)。'."\n" - .'4. 前提条件：'."\n" - .'- 已通过[创建人脸数据库](~~159141~~)（CreateFaceDb）接口创建了数据库名称（DbName）。'."\n" - .'- 已通过[添加人脸样本](~~161144~~)（AddFaceEntity）接口创建了实体ID（EntityId）。'."\n" - .'- 已通过[添加人脸数据](~~159216~~)（AddFace）接口给数据库（DbName）下的实体ID（EntityId）添加了人脸图片。'."\n" - ."\n" - .'5. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/facebody/2019-12-30/SearchFace?lang=JAVA&sdkStyle=dara¶ms=%7B%7D&tab=DEMO)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" - .'6. 开发接入步骤：'."\n" + .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/facebody/2019-12-30/CompareFace?lang=JAVA&sdkStyle=dara¶ms=%7B%22ImageURLA%22%3A%22http%3A%2F%2Fviapi-test.oss-cn-shanghai.aliyuncs.com%2Fviapi-3.0domepic%2Ffacebody%2FCompareFace%2FCompareFace-right1.png%22%2C%22ImageURLB%22%3A%22http%3A%2F%2Fviapi-test.oss-cn-shanghai.aliyuncs.com%2Fviapi-3.0domepic%2Ffacebody%2FCompareFace%2FCompareFace-left1.png%22%7D&tab=DEMO)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" + .'5. 开发接入步骤：'."\n" .'- 在[SDK总览](~~145033~~)中选择您要接入使用的SDK语言。'."\n" .'- 在对应语言的SDK文档中找到AI类目为人脸人体（facebody）的SDK包进行安装。'."\n" .'- 参考文档中提供的示例代码进行适当修改后调用。'."\n" ."\n" - .'7. 示例代码：该能力常用语言的示例代码，请参见[人脸搜索示例代码](~~478011~~)。'."\n" + .'6. 示例代码：该能力常用语言的示例代码，请参见[人脸比对1:1示例代码](~~465557~~)。'."\n" ."\n" - .'8. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" + .'7. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" .'- [Web前端直接调用](~~467779~~)'."\n" .'- [小程序场景下直接调用](~~467780~~)'."\n" .'- [Android端直接调用](~~467781~~)'."\n" .'- [iOS端直接调用](~~467782~~)'."\n" ."\n" .'## 输入限制'."\n" - .'- 图像格式：JPG、JPEG、PNG。'."\n" + .'- 图像格式：JPEG、JPG、PNG、BMP、WEBP。'."\n" .'- 图像大小：不超过5 MB。'."\n" - .'- 图像分辨率：大于32×32像素，小于4096×4096像素。人脸占比不低于64×64像素。'."\n" + .'- 图像分辨率：大于32×32像素，小于4096×4096像素，人脸占比不低于64×64像素。'."\n" .'- URL地址中不能包含中文字符。'."\n" - .'- 支持图片中包含最多10个人脸，超过部分会被忽略。'."\n" - .'>当图像分辨率超过最大限制时，请先将图片进行缩放，调整图片大小，具体请参见[图片缩放](~~44688~~)。 '."\n" + .'- 可使用URL与Base64编码字符串混合输入。例如：输入ImageURLA和ImageDataB的值，不输入ImageURLB和ImageDataA的值。'."\n" + .'> 当图像分辨率超过最大限制时，请先将图片进行缩放，调整图片大小，具体请参见[图片缩放](~~44688~~)。'."\n" ."\n" .'## 计费说明'."\n" - .'关于人脸搜索1:N的计费方式及报价，请参见[计费介绍](~~184049~~)。人脸搜索1:N能力中仅本接口（SearchFace）收费，其他接口可免费调用。'."\n" - .'> 下方调试接口为付费接口，如需免费体验调试请前往[体验中心](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=SearchFace)。', + .'关于人脸比对的计费方式及报价，详情请参见[计费介绍](~~184049~~)。'."\n" + .'> 下方调试接口为付费接口，如需免费体验调试请前往[体验中心](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=CompareFace)。', 'requestParamsDescription' => ' ', 'responseParamsDescription' => '## SDK参考'."\n" - .'阿里云视觉AI人脸人体类目下的人脸搜索能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。'."\n" + .'阿里云视觉AI人脸人体类目下的人脸比对1:1能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。'."\n" ."\n" .'## 示例代码'."\n" - .'该能力常用语言的示例代码，请参见[人脸搜索示例代码](~~478011~~)。', + .'该能力常用语言的示例代码，请参见[人脸比对1:1示例代码](~~465557~~)。', 'extraInfo' => '## 错误码'."\n" - .'关于人脸搜索的错误码，详情请参见[常见错误码](~~146756~~)。'."\n" + .'关于人脸比对1:1的错误码，详情请参见[常见错误码](~~146756~~)。'."\n" ."\n" .'## 开源模型体验'."\n" .'更多开源免费模型体验及下载，详见魔搭社区：[人脸识别OOD模型](https://modelscope.cn/models/damo/cv_ir_face-recognition-ood_rts/summary)、[ArcFace人脸识别模型](https://modelscope.cn/models/damo/cv_ir50_face-recognition_arcface/summary)、[IR人脸识别模型FRIR](https://modelscope.cn/models/damo/cv_manual_face-recognition_frir/summary)、[口罩人脸识别模型FRFM-large](https://modelscope.cn/models/damo/cv_manual_face-recognition_frfm/summary)、[口罩人脸识别模型FaceMask](https://modelscope.cn/models/damo/cv_resnet_face-recognition_facemask/summary)。'."\n" @@ -1420,93 +1158,108 @@ .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。'."\n" - .'- 平台不存储用户在使用服务过程中涉及的原始人脸图片或文件信息。'."\n" - .'- 平台针对超过6个月及以上没有API服务调用的用户的人脸特征向量数据进行冻结，确保无服务调用的客户信息安全。如需解冻，请通过钉钉群（23109592）联系我们。', - ], - 'GetFaceEntity' => [ - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', + .'- 平台不存储用户在使用服务过程中涉及的原始人脸图片或文件信息。', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-facebody:CompareFace', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + ], + 'CompareFaceWithMask' => [ + 'summary' => '本文介绍口罩人脸比对1:1CompareFaceWithMask的语法及示例。', + 'methods' => ['post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'get', - ], + 'systemTags' => [], 'parameters' => [ [ - 'name' => 'DbName', + 'name' => 'ImageURLA', 'in' => 'formData', - 'schema' => [ - 'description' => '数据库名称。', - 'type' => 'string', - 'required' => true, - 'example' => 'default', - ], + 'schema' => ['description' => '图像A的URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。', 'type' => 'string', 'required' => true, 'example' => 'https://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/CompareFaceWithMask/CompareFaceWithMask-left1.jpeg', 'isFileTransferUrl' => true], ], [ - 'name' => 'EntityId', + 'name' => 'ImageURLB', 'in' => 'formData', - 'schema' => [ - 'description' => '实体ID。可以包含数字、字母和下划线。', - 'type' => 'string', - 'required' => true, - 'example' => '66', - ], + 'schema' => ['description' => '图像B的URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。', 'type' => 'string', 'required' => true, 'example' => 'https://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/CompareFaceWithMask/CompareFaceWithMask-right1.jpeg', 'isFileTransferUrl' => true], + ], + [ + 'name' => 'QualityScoreThreshold', + 'in' => 'formData', + 'schema' => ['description' => '质量分阈值，对人脸图片进行质量分析判断，若某张人脸质量分小于该阈值，则会在返回结果上增加MessageTips说明。', 'type' => 'number', 'format' => 'float', 'required' => false, 'example' => '97.0'], ], ], 'responses' => [ 200 => [ 'schema' => [ + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'DA7CAFEB-0A37-4496-9CDF-E3DBB6309CB2', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => 'C6499918-E932-41B3-96F5-A18F50D262DD'], 'Data' => [ 'description' => '返回的结果数据内容。', 'type' => 'object', 'properties' => [ - 'DbName' => [ - 'description' => '数据库名称。', - 'type' => 'string', - 'example' => 'default', + 'Confidence' => ['description' => '两张图片中的最大人脸属于同一个人的置信度，取值范围0~100。供参考的三个阈值是61，69，75分别对应千分之一，万分之一和十万分之一误识率。阈值设置越高，误识率越低，通过率也越低，对安全性要求越高的场合，可以设置更高的阈值。如果某张图片中没有人脸则报错误信息。', 'type' => 'number', 'format' => 'float', 'example' => '88.025604248046875'], + 'IsMaskA' => ['description' => '图片A中的人脸是否戴口罩。'."\n" + ."\n" + .'- 0：不戴口罩'."\n" + .'- 1：戴口罩', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], + 'IsMaskB' => ['description' => '图片B中的人脸是否戴口罩。'."\n" + ."\n" + .'- 0：不戴口罩'."\n" + .'- 1：戴口罩', 'type' => 'integer', 'format' => 'int64', 'example' => '0'], + 'LandmarksAList' => [ + 'description' => '图片A人脸框所对应的人脸关键点坐标数组。', + 'type' => 'array', + 'items' => ['description' => '图片A人脸框所对应的人脸关键点坐标，顺序分别为左眼水平坐标，左眼垂直坐标，右眼水平坐标，右眼垂直坐标，鼻尖水平坐标，鼻尖垂直坐标，左嘴角水平坐标，左嘴角垂直坐标，右嘴角水平坐标，右嘴角垂直坐标。', 'type' => 'integer', 'format' => 'int64', 'example' => '[348,490,523,478,446,577,386,677,514,668]'], + ], + 'LandmarksBList' => [ + 'description' => '图片B人脸框所对应的人脸关键点坐标数组。', + 'type' => 'array', + 'items' => ['description' => '图片B人脸框所对应的人脸关键点坐标，顺序分别为左眼水平坐标，左眼垂直坐标，右眼水平坐标，右眼垂直坐标，鼻尖水平坐标，鼻尖垂直坐标，左嘴角水平坐标，左嘴角垂直坐标，右嘴角水平坐标，右嘴角垂直坐标。', 'type' => 'integer', 'format' => 'int64', 'example' => '[356,590,487,589,410,676,368,754,476,753]'], ], - 'EntityId' => [ - 'description' => '实体ID。', - 'type' => 'string', - 'example' => '66', + 'QualityScoreA' => ['description' => '输入图像A的质量分。', 'type' => 'number', 'format' => 'float', 'example' => '75.891258239746094'], + 'QualityScoreB' => ['description' => '输入图像B的质量分。', 'type' => 'number', 'format' => 'float', 'example' => '98.716880798339844'], + 'RectAList' => [ + 'description' => '图片A中最大人脸矩形框。', + 'type' => 'array', + 'items' => ['description' => '图片A中最大人脸矩形框\\[left, top, width, height]，例如\\[238,310,388,492]。', 'type' => 'integer', 'format' => 'int64', 'example' => '[238,310,388,492]'], ], - 'Labels' => [ - 'description' => '查询到的人脸标签。', - 'type' => 'string', - 'example' => '工厂', + 'RectBList' => [ + 'description' => '图片B中最大人脸矩形框。', + 'type' => 'array', + 'items' => ['description' => '图片B中最大人脸矩形框\\[left, top, width, height]，例如\\[284,467,293,373]。', 'type' => 'integer', 'format' => 'int64', 'example' => '[284,467,293,373]'], ], - 'Faces' => [ - 'description' => '查询到的人脸数据。', + 'Thresholds' => [ + 'description' => '不同误识率下置信度结果数组。', 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'FaceId' => [ - 'description' => '人脸数据ID。', - 'type' => 'string', - 'example' => '3', - ], - ], - ], + 'items' => ['description' => '误识率在1/1000，1/10000，1/100000的情况下分别对应的置信度阈值。例如`[61.0,69.0,75.0]`，表示误识率为1/1000的情况下，置信度（Confidence）超过61%就可以认为是同一个人。', 'type' => 'integer', 'format' => 'int64', 'example' => '[61, 69, 75]'], ], + 'MessageTips' => ['description' => '提示信息，纯文字描述，以下提示信息单独出现或是几条提示信息的组合。'."\n" + .'质量相关提示（某张人脸质量分小于请求参数质量分阈值时会出现）：'."\n" + ."\n" + .'- `imageA quality score less threshold`：图像A的质量分小于输入参数设置的阈值。'."\n" + .'- `imageB quality score less threshold`：图像B的质量分小于输入参数设置的阈值。'."\n" + ."\n" + .'人脸尺寸相关提示（检测到人脸且人脸宽或高小于50像素时会有该提示信息。出现该提示信息时，请尽可能输入像素数大于64x64的人脸，并请酌情参考返回的对比置信度Confidence值）：'."\n" + ."\n" + .'- `face in imageA is too small`：图像A中的人脸太小。'."\n" + .'- `face in imageB is too small`：图像B中的人脸太小。', 'type' => 'string', 'example' => 'imageB quality score less threshold'], ], ], ], @@ -1515,86 +1268,114 @@ ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'ParameterError', - 'errorMessage' => 'The parameter is invalid. Please check again.', - ], + ['errorCode' => 'ParameterError', 'errorMessage' => 'The parameter is invalid. Please check again.', 'description' => '参数错误，请检查参数值'], ], 403 => [ - [ - 'errorCode' => 'AuthFailed', - 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', - ], + ['errorCode' => 'AuthFailed', 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', 'description' => '授权失败，请检查RAM权限配置'], ], 408 => [ - [ - 'errorCode' => 'Timeout', - 'errorMessage' => 'The request has timed out.', - ], + ['errorCode' => 'Timeout', 'errorMessage' => 'The request has timed out.', 'description' => '请求超时，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'The service is unavailable.', - ], + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'The service is unavailable.', 'description' => '服务不可用，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"DA7CAFEB-0A37-4496-9CDF-E3DBB6309CB2\\",\\n \\"Data\\": {\\n \\"DbName\\": \\"default\\",\\n \\"EntityId\\": \\"66\\",\\n \\"Labels\\": \\"工厂\\",\\n \\"Faces\\": [\\n {\\n \\"FaceId\\": \\"3\\"\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"DA7CAFEB-0A37-4496-9CDF-E3DBB6309CB2\\n\\n default\\n 66\\n 工厂\\n \\n 3\\n \\n","errorExample":""}]', - 'title' => '查询人脸样本', - 'summary' => '本文介绍查询人脸样本GetFaceEntity的语法及示例。', + 'staticInfo' => ['returnType' => 'synchronous'], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"C6499918-E932-41B3-96F5-A18F50D262DD\\",\\n \\"Data\\": {\\n \\"Confidence\\": 88.02560424804688,\\n \\"IsMaskA\\": 1,\\n \\"IsMaskB\\": 0,\\n \\"LandmarksAList\\": [\\n 0\\n ],\\n \\"LandmarksBList\\": [\\n 0\\n ],\\n \\"QualityScoreA\\": 75.8912582397461,\\n \\"QualityScoreB\\": 98.71688079833984,\\n \\"RectAList\\": [\\n 0\\n ],\\n \\"RectBList\\": [\\n 0\\n ],\\n \\"Thresholds\\": [\\n 0\\n ],\\n \\"MessageTips\\": \\"imageB quality score less threshold\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n C6499918-E932-41B3-96F5-A18F50D262DD\\n \\n 88.025604\\n 1\\n 0\\n 348\\n 490\\n 523\\n 478\\n 446\\n 577\\n 386\\n 677\\n 514\\n 668\\n 356\\n 590\\n 487\\n 589\\n 410\\n 676\\n 368\\n 754\\n 476\\n 753\\n 75.89126\\n 98.71688\\n 238\\n 310\\n 388\\n 492\\n 284\\n 467\\n 293\\n 373\\n 61\\n 69\\n 75\\n imageB quality score less threshold\\n \\n","errorExample":""}]', + 'title' => '口罩人脸比对1:1', 'description' => '## 功能描述'."\n" - .'查询人脸样本能力用于查询人脸数据库中的人脸样本数据。'."\n" + .'口罩人脸比对1:1能力基于您输入的两张图片，分别挑选两张图片中的最大人脸进行比较，判断是否为同一人。融合戴口罩生成、抗遮挡关键点定位、抗遮挡特征注意力三大技术优化，实现戴口罩时的极速人脸识别。'."\n" + ."\n" + .'- 两张人脸图片对比：比对两张图片中人脸的相似度，返回这两个人脸的矩形框坐标、人脸五点关键点坐标、比对的置信度，以及不同误识率的置信度阈值。'."\n" + .'- 支持多种图片类型：支持生活照、证件照等类型的人脸对比。'."\n" + .'- 支持佩戴口罩场景：针对佩戴口罩场景对带口罩的人脸进行对比识别。'."\n" + ."\n" + .'关于该接口功能的示意图如下：'."\n" + .' ![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20230206/cenz/CompareFaceWithMask.png" width="500)'."\n" ."\n" .'> - 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" + .'- 当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击[立即试用](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=CompareFaceWithMask)对该能力进行更直观试用以及在线购买。'."\n" .'- 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。'."\n" ."\n" + .'## 应用场景'."\n" + ."\n" + .'- 员工考勤：无接触式刷脸考勤，疫情防控场景下企业考勤首选，且能有效防止代打卡等作弊行为。'."\n" + .'- 公共服务：佩戴口罩客户直接刷脸办理业务，通过人脸比对识别身份信息，减少身份证查验、复印存档等环节，提高公共服务窗口办理业务的效率。'."\n" + .'- 外卖骑手人脸核验：戴口罩外卖骑手送餐业务人脸打卡和定期本身人脸核验，现场授权采集的戴口罩人脸照片，与本人认证照片进行1:1比对，确保外卖骑手身份真实性，提供不摘口罩人脸识别便捷体验。'."\n" + ."\n" + .'## 特色优势'."\n" + .'- 平台服务稳定：提供在高并发，大流量下的毫秒级识别响应和保障。'."\n" + .'- 抗遮挡五官定位：支持戴口罩、大部分遮挡情况下，实现准确度自评估的鲁棒性关键点定位。'."\n" + .'- 抗遮挡特征建模：支持戴口罩、大部分遮挡情况下，实现基于注意力机制的鲁棒性特征建模。'."\n" + .'- 简单易用：可直接调用的 API 接口，服务简单易用，易被集成，兼容性强。'."\n" + .'- 佩戴口罩场景优化：针对佩戴口罩场景，优化戴口罩遮挡情境下的人脸比对。'."\n" + ."\n" .'## 接入指引'."\n" .'1. 注册阿里云账号：打开[阿里云官网](https://www.aliyun.com)，在阿里云官网右上角，单击**立即注册**，按照操作提示完成账号注册。'."\n" .'2. 开通能力：请确保您已开通[人脸人体服务](https://vision.aliyun.com/facebody)，若未开通服务请[立即开通](https://common-buy.aliyun.com/?commodityCode=viapi_facebody_public_cn#/open)。'."\n" - ."\n" .'>'."\n" - .'本能力支持企业或个人认证用户开通。更多实名认证操作信息，请参见[实名认证](https://help.aliyun.com/zh/account/user-guide/real-name-authentication/)。'."\n" + .'本能力仅限企业认证用户开通。更多实名认证操作信息，请参见[实名认证](https://help.aliyun.com/knowledge_list/37170.html)。'."\n" .'>'."\n" ."\n" .'3. 创建AccessKey：请确保您已[创建AccessKey](~~175144~~)，如果您使用的是子账号AccessKey，您需要给子账号赋予AliyunVIAPIFullAccess权限，具体操作，请参见[RAM授权](~~145025~~)。'."\n" - .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/facebody/2019-12-30/GetFaceEntity?lang=JAVA)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" + .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/facebody/2019-12-30/CompareFaceWithMask?lang=JAVA)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" .'5. 开发接入步骤：'."\n" .'- 在[SDK总览](~~145033~~)中选择您要接入使用的SDK语言。'."\n" .'- 在对应语言的SDK文档中找到AI类目为人脸人体（facebody）的SDK包进行安装。'."\n" .'- 参考文档中提供的示例代码进行适当修改后调用。'."\n" ."\n" - .'6. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" + .'6. 示例代码：该能力常用语言的示例代码，请参见[口罩人脸比对1:1示例代码](~~601387~~)。'."\n" + ."\n" + .'7. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" .'- [Web前端直接调用](~~467779~~)'."\n" .'- [小程序场景下直接调用](~~467780~~)'."\n" .'- [Android端直接调用](~~467781~~)'."\n" .'- [iOS端直接调用](~~467782~~)'."\n" ."\n" - .'## 限制说明'."\n" - .'查询人脸样本接口提交任务并发默认为2QPS。'."\n" + .'## 输入限制'."\n" + .'- 图像格式：JPEG、JPG、PNG、BMP、WEBP。'."\n" + .'- 图像大小：不超过3 MB。'."\n" + .'- 图像分辨率：大于32×32像素，小于4096×4096像素，人脸占比不低于64×64像素。'."\n" + .'- URL地址中不能包含中文字符。'."\n" + .'> 当图像分辨率超过最大限制时，请先将图片进行缩放，调整图片大小，具体请参见[图片缩放](~~44688~~)。'."\n" ."\n" .'## 计费说明'."\n" - .'查询人脸样本能力可免费调用。', - 'requestParamsDescription' => ' ', + .'关于口罩人脸比对1:1的计费方式及报价，请参见[计费介绍](~~184049~~)。'."\n" + .'> 下方调试接口为付费接口，如需免费体验调试请前往[体验中心](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=CompareFaceWithMask)。'."\n" + ."\n", 'responseParamsDescription' => '## SDK参考'."\n" - .'阿里云视觉AI人脸人体类目下的查询人脸样本能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。', + .'阿里云视觉AI人脸人体类目下的口罩人脸比对1:1能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。'."\n" + ."\n" + .'## 示例代码'."\n" + .'该能力常用语言的示例代码，请参见[口罩人脸比对1:1示例代码](~~601387~~)。', 'extraInfo' => '## 错误码'."\n" - .'关于查询人脸样本的错误码，详情请参见[常见错误码](~~146756~~)。'."\n" + .'关于口罩人脸比对1:1的错误码，详情请参见[常见错误码](~~146756~~)。'."\n" + ."\n" + .'## 开源模型体验'."\n" + .'更多开源免费模型体验及下载，详见魔搭社区：[人脸识别OOD模型](https://modelscope.cn/models/damo/cv_ir_face-recognition-ood_rts/summary)、[ArcFace人脸识别模型](https://modelscope.cn/models/damo/cv_ir50_face-recognition_arcface/summary)、[IR人脸识别模型FRIR](https://modelscope.cn/models/damo/cv_manual_face-recognition_frir/summary)、[口罩人脸识别模型FRFM-large](https://modelscope.cn/models/damo/cv_manual_face-recognition_frfm/summary)、[口罩人脸识别模型FaceMask](https://modelscope.cn/models/damo/cv_resnet_face-recognition_facemask/summary)。'."\n" ."\n" .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。'."\n" - .'- 平台不存储用户在使用服务过程中涉及的原始人脸图片或文件信息。'."\n" - .'- 平台针对超过6个月及以上没有API服务调用的用户的人脸特征向量数据进行冻结，确保无服务调用的客户信息安全。如需解冻，请通过钉钉群（23109592）联系我们。', - ], - 'ListFaceEntities' => [ - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', + .'- 平台不存储用户在使用服务过程中涉及的原始人脸图片或文件信息。', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-facebody:CompareFaceWithMask', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + ], + 'CreateFaceDb' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -1602,187 +1383,45 @@ ], 'operationType' => 'read', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'get', - ], + 'systemTags' => ['operationType' => 'create'], 'parameters' => [ [ - 'name' => 'DbName', - 'in' => 'formData', - 'schema' => [ - 'description' => '数据库名称。', - 'type' => 'string', - 'required' => true, - 'example' => 'default', - ], - ], - [ - 'name' => 'Offset', + 'name' => 'Name', 'in' => 'formData', - 'schema' => [ - 'description' => '起始记录，取值范围0~2000。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '1', - ], + 'schema' => ['description' => '数据库名称。支持字母、数字和下划线的组合，长度为1~64。', 'type' => 'string', 'required' => true, 'example' => 'default'], ], - [ - 'name' => 'Limit', - 'in' => 'formData', + ], + 'responses' => [ + 200 => [ 'schema' => [ - 'description' => '每页最多显示的样本数目，取值范围1~200。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '50', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '818D24A6-E368-46B3-99C5-3CF36D98CCA3'], + ], + 'description' => '', ], ], - [ - 'name' => 'Token', - 'in' => 'formData', - 'schema' => [ - 'description' => '当查询结果超过2000条时，需要使用上一次请求返回的Token作为请求下一页的参数。', - 'type' => 'string', - 'required' => false, - 'example' => '2', - ], + ], + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'ParameterError', 'errorMessage' => 'The parameter is invalid. Please check again.', 'description' => '参数错误，请检查参数值'], ], - [ - 'name' => 'Labels', - 'in' => 'formData', - 'schema' => [ - 'description' => '自定义标签，最多支持10个标签，多个标签以英文逗号（,）分割。', - 'type' => 'string', - 'required' => false, - 'example' => '视觉智能', - ], + 403 => [ + ['errorCode' => 'AuthFailed', 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', 'description' => '授权失败，请检查RAM权限配置'], ], - [ - 'name' => 'EntityIdPrefix', - 'in' => 'formData', - 'schema' => [ - 'description' => '样本ID前缀，包含数字、字母和下划线。', - 'type' => 'string', - 'required' => false, - 'example' => 'U1', - ], + 408 => [ + ['errorCode' => 'Timeout', 'errorMessage' => 'The request has timed out.', 'description' => '请求超时，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], - [ - 'name' => 'Order', - 'in' => 'formData', - 'schema' => [ - 'description' => '排列方式。包括asc（升序）和desc（降序）。', - 'type' => 'string', - 'required' => false, - 'example' => 'asc', - ], + 503 => [ + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'The service is unavailable.', 'description' => '服务不可用，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], ], - 'responses' => [ - 200 => [ - 'schema' => [ - 'type' => 'object', - 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'DA7CAFEB-0A37-4496-9CDF-E3DBB6309CB2', - ], - 'Data' => [ - 'description' => '返回的结果数据内容。', - 'type' => 'object', - 'properties' => [ - 'Token' => [ - 'description' => '当查询结果超过2000条时，可以使用Token来查询下一页的数据。', - 'type' => 'string', - 'example' => '2', - ], - 'TotalCount' => [ - 'description' => '人脸样本的总数量。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '200', - ], - 'Entities' => [ - 'description' => '查询到的实体数据。', - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'DbName' => [ - 'description' => '人脸样本所在的数据库名称。', - 'type' => 'string', - 'example' => 'default', - ], - 'EntityId' => [ - 'description' => '实体ID，如员工编号。', - 'type' => 'string', - 'example' => '222', - ], - 'Labels' => [ - 'description' => '查询到的人脸数据标签。', - 'type' => 'string', - 'example' => '视觉智能', - ], - 'CreatedAt' => [ - 'description' => '人脸样本的创建时间。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1589203871832', - ], - 'FaceCount' => [ - 'description' => '人脸样本包含的人脸数量。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '3', - ], - 'UpdatedAt' => [ - 'description' => '人脸样本的更新时间。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1589203871832', - ], - ], - ], - ], - ], - ], - ], - ], - ], - ], - 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'ParameterError', - 'errorMessage' => 'The parameter is invalid. Please check again.', - ], - ], - 403 => [ - [ - 'errorCode' => 'AuthFailed', - 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', - ], - ], - 408 => [ - [ - 'errorCode' => 'Timeout', - 'errorMessage' => 'The request has timed out.', - ], - ], - 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'The service is unavailable.', - ], - ], - ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"DA7CAFEB-0A37-4496-9CDF-E3DBB6309CB2\\",\\n \\"Data\\": {\\n \\"Token\\": \\"2\\",\\n \\"TotalCount\\": 200,\\n \\"Entities\\": [\\n {\\n \\"DbName\\": \\"default\\",\\n \\"EntityId\\": \\"222\\",\\n \\"Labels\\": \\"视觉智能\\",\\n \\"CreatedAt\\": 1589203871832,\\n \\"FaceCount\\": 3,\\n \\"UpdatedAt\\": 1589203871832\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n DA7CAFEB-0A37-4496-9CDF-E3DBB6309CB2\\n \\n 2\\n 200\\n \\n default\\n 222\\n 视觉智能\\n 1589203871832\\n 3\\n 1589203871832\\n \\n \\n","errorExample":""}]', - 'title' => '查询人脸样本列表', - 'summary' => '本文介绍查询人脸样本列表ListFaceEntities的语法及示例。', + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"818D24A6-E368-46B3-99C5-3CF36D98CCA3\\"\\n}","errorExample":""},{"type":"xml","example":"818D24A6-E368-46B3-99C5-3CF36D98CCA3","errorExample":""}]', + 'title' => '创建人脸数据库', + 'summary' => '本文介绍创建人脸数据库CreateFaceDb的语法及示例。', 'description' => '## 功能描述'."\n" - .'查询人脸样本列表能力用于查询人脸数据库中的人脸样本列表。'."\n" + .'创建人脸数据库能力可以创建人脸数据库用来存放人脸数据。每个阿里云账号可以创建10个人脸数据库，10个人脸数据库支持最多50万张人脸照片的入库，单个人脸数据库支持最多5万张人脸照片入库，单次搜索可支持最多10个人脸数据库的同时搜索（跨库搜索）。'."\n" + .'人脸数据库、人脸照片入库量、单次搜索的人脸总数以及单次搜索的人脸数据库暂不支持扩容。'."\n" ."\n" .'> - 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" .'- 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。'."\n" @@ -1795,44 +1434,58 @@ .'>'."\n" ."\n" .'3. 创建AccessKey：请确保您已[创建AccessKey](~~175144~~)，如果您使用的是子账号AccessKey，您需要给子账号赋予AliyunVIAPIFullAccess权限，具体操作，请参见[RAM授权](~~145025~~)。'."\n" - .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/facebody/2019-12-30/ListFaceEntities?lang=JAVA)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" + .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/facebody/2019-12-30/CreateFaceDb?lang=JAVA)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" .'5. 开发接入步骤：'."\n" .'- 在[SDK总览](~~145033~~)中选择您要接入使用的SDK语言。'."\n" .'- 在对应语言的SDK文档中找到AI类目为人脸人体（facebody）的SDK包进行安装。'."\n" .'- 参考文档中提供的示例代码进行适当修改后调用。'."\n" ."\n" - .'6. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" + .'6. 示例代码：该能力常用语言的示例代码，请参见[创建人脸数据库示例代码](~~477924~~)。'."\n" + ."\n" + .'7. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" .'- [Web前端直接调用](~~467779~~)'."\n" .'- [小程序场景下直接调用](~~467780~~)'."\n" .'- [Android端直接调用](~~467781~~)'."\n" .'- [iOS端直接调用](~~467782~~)'."\n" ."\n" .'## 限制说明'."\n" - .'查询人脸样本列表接口提交任务并发默认为2QPS。'."\n" + .'创建人脸数据库接口提交任务并发默认为2QPS。'."\n" ."\n" .'## 计费说明'."\n" - .'查询人脸样本列表能力可免费调用。', + .'创建人脸数据库能力可免费调用。', 'requestParamsDescription' => ' ', 'responseParamsDescription' => '## SDK参考'."\n" - .'阿里云视觉AI人脸人体类目下的查询人脸样本列表能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。', + .'阿里云视觉AI人脸人体类目下的创建人脸数据库能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。'."\n" + ."\n" + .'## 示例代码'."\n" + .'该能力常用语言的示例代码，请参见[创建人脸数据库示例代码](~~477924~~)。', 'extraInfo' => '## 错误码'."\n" - .'关于查询人脸样本列表的错误码，详情请参见[常见错误码](~~146756~~)。'."\n" + .'关于创建人脸数据库的错误码，详情请参见[常见错误码](~~146756~~)。'."\n" ."\n" .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。'."\n" .'- 平台不存储用户在使用服务过程中涉及的原始人脸图片或文件信息。'."\n" .'- 平台针对超过6个月及以上没有API服务调用的用户的人脸特征向量数据进行冻结，确保无服务调用的客户信息安全。如需解冻，请通过钉钉群（23109592）联系我们。', - ], - 'ListFaceDbs' => [ - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'viapi-facebody:CreateFaceDb', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + ], + 'DeepfakeFace' => [ + 'summary' => '本文介绍人脸人体（facebody）类目下的换脸鉴别DeepfakeFace的语法及示例。', + 'methods' => ['post'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], @@ -1840,59 +1493,86 @@ ], 'operationType' => 'read', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'get', - ], + 'systemTags' => ['operationType' => 'none'], 'parameters' => [ [ - 'name' => 'Offset', - 'in' => 'formData', - 'schema' => [ - 'description' => '默认起始页从0开始，不填写默认从0页开始返回数据。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '1', - ], - ], - [ - 'name' => 'Limit', + 'name' => 'Tasks', 'in' => 'formData', + 'style' => 'repeatList', 'schema' => [ - 'description' => '每页最多显示的样本数目，范围1~200，默认200。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '50', + 'description' => '输入人脸数据。', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'ImageURL' => ['description' => '待检测的图像URL地址。JSON数组中的每个元素是一个图片检测任务结构体（image表）。最多支持10个元素，即同时最多对10张图片进行检测。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。'."\n" + ."\n" + .'> 对于该接口，系统会自动将OSS链接地址转成内网地址然后再下载文件，所以调用该接口并不会产生OSS流量计费。', 'type' => 'string', 'required' => false, 'example' => 'https://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/DeepfakeFace/DeepfakeFace1.jpg', 'isFileTransferUrl' => true], + 'ImageData' => ['description' => '图像Base64编码字符串。当与URL方式共存时，URL方式优先。'."\n" + .'文件的Base64编码处理操作，请参见[文件Base64处理](~~468191~~)。', 'type' => 'string', 'required' => false, 'example' => '/9j/4AAQSkZJRgABAQAAAQABAAD/2****'], + ], + 'required' => false, + 'description' => '', + ], + 'required' => true, + 'maxItems' => 10, ], ], ], 'responses' => [ 200 => [ 'schema' => [ + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '2B93C43A-F824-40C8-AF79-844342B0F43A', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => '8E6F65D5-62A1-1E5B-BC0B-00508034AC92'], 'Data' => [ - 'description' => '返回的数据内容。', + 'description' => '返回的结果数据内容。', 'type' => 'object', 'properties' => [ - 'DbList' => [ - 'description' => '数据库列表。', + 'Elements' => [ + 'description' => '返回识别的元素。', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ - 'Name' => [ - 'description' => '数据库名称。', - 'type' => 'string', - 'example' => 'default', + 'ImageURL' => ['description' => '对应请求中的图像URL地址。', 'type' => 'string', 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/DeepfakeFace/DeepfakeFace1.jpg'], + 'TaskId' => ['description' => '该检测任务的ID。', 'type' => 'string', 'example' => '8E6F65D5-62A1-1E5B-BC0B-00508034AC92'], + 'Results' => [ + 'description' => '返回结果。调用成功时返回结果中包含一个或多个元素。', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'Label' => ['description' => '检测结果的分类，取值包括：'."\n" + ."\n" + .'- normalface：真脸照片'."\n" + .'- deepfakeface：换脸照片'."\n" + ."\n" + .'如果未检测到人脸，则Label返回为`deepfake`。', 'type' => 'string', 'example' => 'normalface'], + 'Confidence' => ['description' => '取值范围为\\[0.00,100.00]。数值越低表示属于真脸的概率越大。', 'type' => 'number', 'format' => 'float', 'example' => '36.6455'], + 'Rect' => [ + 'description' => '人脸检测框信息。', + 'type' => 'object', + 'properties' => [ + 'Left' => ['description' => '检测框左上角的点x坐标。', 'type' => 'integer', 'format' => 'int64', 'example' => '373'], + 'Top' => ['description' => '检测框左上角的点y坐标。', 'type' => 'integer', 'format' => 'int64', 'example' => '111'], + 'Width' => ['description' => '检测框宽度。', 'type' => 'integer', 'format' => 'int64', 'example' => '207'], + 'Height' => ['description' => '检测框高度。', 'type' => 'integer', 'format' => 'int64', 'example' => '284'], + ], + ], + 'MessageTips' => ['description' => '提示信息。'."\n" + .'- 如输入模糊、遮挡或大角度等的人脸，则返回提示信息：`blurred, occluded or large angle face, please check.` '."\n" + .'- 如未检测到人脸，则返回提示信息：`no face detected, try again please.`', 'type' => 'string', 'example' => 'blurred, occluded or large angle face, please check.'], + ], + 'description' => '', + ], ], + 'FaceNumber' => ['description' => '单张图片检测到的人脸数量。'."\n" + .'如果未检测到人脸，FaceNumber返回为0。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], ], + 'description' => '', ], ], ], @@ -1903,48 +1583,59 @@ ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'ParameterError', - 'errorMessage' => 'The parameter is invalid. Please check again.', - ], + ['errorCode' => 'ParameterError', 'errorMessage' => 'The parameter is invalid. Please check again.', 'description' => '参数错误，请检查参数值'], ], 403 => [ - [ - 'errorCode' => 'AuthFailed', - 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', - ], + ['errorCode' => 'AuthFailed', 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', 'description' => '授权失败，请检查RAM权限配置'], ], 408 => [ - [ - 'errorCode' => 'Timeout', - 'errorMessage' => 'The request has timed out.', - ], + ['errorCode' => 'Timeout', 'errorMessage' => 'The request has timed out.', 'description' => '请求超时，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'The service is unavailable.', - ], + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'The service is unavailable.', 'description' => '服务不可用，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"2B93C43A-F824-40C8-AF79-844342B0F43A\\",\\n \\"Data\\": {\\n \\"DbList\\": [\\n {\\n \\"Name\\": \\"default\\"\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n 2B93C43A-F824-40C8-AF79-844342B0F43A\\n \\n \\n default\\n \\n \\n","errorExample":""}]', - 'title' => '查看人脸数据库列表', - 'summary' => '本文介绍查看数据库列表ListFaceDbs的语法及示例。', + 'staticInfo' => ['returnType' => 'synchronous'], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"8E6F65D5-62A1-1E5B-BC0B-00508034AC92\\",\\n \\"Data\\": {\\n \\"Elements\\": [\\n {\\n \\"ImageURL\\": \\"http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/DeepfakeFace/DeepfakeFace1.jpg\\",\\n \\"TaskId\\": \\"8E6F65D5-62A1-1E5B-BC0B-00508034AC92\\",\\n \\"Results\\": [\\n {\\n \\"Label\\": \\"normalface\\",\\n \\"Confidence\\": 36.6455,\\n \\"Rect\\": {\\n \\"Left\\": 373,\\n \\"Top\\": 111,\\n \\"Width\\": 207,\\n \\"Height\\": 284\\n },\\n \\"MessageTips\\": \\"blurred, occluded or large angle face, please check.\\"\\n }\\n ],\\n \\"FaceNumber\\": 1\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n 8E6F65D5-62A1-1E5B-BC0B-00508034AC92\\n \\n \\n http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/DeepfakeFace/DeepfakeFace1.jpg\\n 8E6F65D5-62A1-1E5B-BC0B-00508034AC92\\n \\n \\n 36.6455\\n \\n 373\\n 111\\n 207\\n 284\\n \\n blurred, occluded or large angle face, please check.\\n \\n 1\\n \\n \\n","errorExample":""}]', + 'title' => '换脸鉴别', 'description' => '## 功能描述'."\n" - .'本能力用于查询人脸数据库列表。人脸数据库最多只能返回200条记录。'."\n" + .'换脸鉴别基于图像算法AI技术，实现对图片人脸的真伪进行灵敏检测和深度分析。能力范围支持：'."\n" + ."\n" + .'1. 鉴别图片中的人脸是否为AI换脸算法所深度合成的假脸。'."\n" + .'2. 鉴别图片中的人脸是否为AI人脸属性编辑生成类算法所深度合成的假脸。深度伪造技术是指利用深度学习实现图片或视频换脸、人脸编辑生成的技术。'."\n" + ."\n" + .'关于该接口功能的示例图如下：'."\n" + ."\n" + .'- 未经算法合成：'."\n" + .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20231109/kpoj/real2.png)'."\n" + .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20231109/rvyz/real1.jpg)'."\n" + ."\n" + .'- 经过算法合成：'."\n" + .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20231109/vcgh/fake1.png)'."\n" + .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20231109/xgjj/fake2.png)'."\n" ."\n" .'> - 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" + .'- 当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击[立即试用](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=DeepfakeFace)对该能力进行更直观试用以及在线购买。'."\n" .'- 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。'."\n" ."\n" + .'## 应用场景'."\n" + .'- 打击换脸视频网络传播：互联网娱乐性质换脸小程序、APP应用爆火，换脸鉴别技术可以识别出网络短视频中的伪造视频人脸，杜绝视频换脸造假。'."\n" + .'- 打击互联网ID换脸诈骗：深度伪造技术高频使用，假视频与社交网络结合深深影响舆论走向和诱导诈骗。换脸鉴别可识别网上业务办理中的人脸伪造视频，减少网络诈骗。'."\n" + .'- 打击色情娱乐等黑灰产业：互联网的深度伪造合成的色情视频数量巨大，换脸鉴别可以识别此类伪造视频，减少伪造视频人脸色情内容传播，切断色情传播链路。'."\n" + .'- 人脸特征编辑鉴别：真人ID版权核验，通过换脸鉴别可以识别出版权素材库中人脸属性编辑生成算法所深度合成的假脸图片素材，杜绝换脸造假，杜绝人脸版权侵权行为。'."\n" + ."\n" + .'## 特色优势'."\n" + .'- 反制AI技术滥用：换脸鉴别基于达摩院人脸图像算法和Deepfake鉴别技术，提供对图像中的人脸特征进行全方位分析，利用AI技术反制换脸、合成脸、人脸特征编辑生成这类AI技术的滥用，保护用户合法权益、维护社会公共安全。'."\n" + .'- 领先鉴别技术：基于图片中人像目标的高维度全量特征，换脸鉴别服务涵盖依据视频图像的像素、纹理级别的低阶特征，到具有全局语义的高阶特征，对图像进行全方位、高语义、多层次组合分析，攻防一体式的训练，极大提升合成人脸图片检出率。'."\n" + .'- 准确率高：换脸鉴别结合阿里云多年人脸识别技术能力和大数据安全技术能力，能对视频图像中 AI 换脸、AI人脸生成等技术进行准确识别判断，对AI换脸攻击识别准确率高。'."\n" + .'- 支持单个或多个人脸判断逻辑，可直接调用的API接口，服务简单易用，易被集成，兼容性强。'."\n" + ."\n" .'## 接入指引'."\n" .'1. 注册阿里云账号：打开[阿里云官网](https://www.aliyun.com)，在阿里云官网右上角，单击**立即注册**，按照操作提示完成账号注册。'."\n" .'2. 开通能力：请确保您已开通[人脸人体服务](https://vision.aliyun.com/facebody)，若未开通服务请[立即开通](https://common-buy.aliyun.com/?commodityCode=viapi_facebody_public_cn#/open)。'."\n" - .'>'."\n" - .'本能力支持企业或个人认证用户开通。更多实名认证操作信息，请参见[实名认证](https://help.aliyun.com/knowledge_list/37170.html)。'."\n" - .'>'."\n" - ."\n" + .'> 本能力支持企业或个人认证用户开通。更多实名认证操作信息，请参见[实名认证](https://help.aliyun.com/knowledge_list/37170.html)。'."\n" .'3. 创建AccessKey：请确保您已[创建AccessKey](~~175144~~)，如果您使用的是子账号AccessKey，您需要给子账号赋予AliyunVIAPIFullAccess权限，具体操作，请参见[RAM授权](~~145025~~)。'."\n" - .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/facebody/2019-12-30/ListFaceDbs?lang=JAVA)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" + .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/facebody/2019-12-30/DeepfakeFace)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" .'5. 开发接入步骤：'."\n" .'- 在[SDK总览](~~145033~~)中选择您要接入使用的SDK语言。'."\n" .'- 在对应语言的SDK文档中找到AI类目为人脸人体（facebody）的SDK包进行安装。'."\n" @@ -1956,705 +1647,501 @@ .'- [Android端直接调用](~~467781~~)'."\n" .'- [iOS端直接调用](~~467782~~)'."\n" ."\n" - .'## 限制说明'."\n" - .'查询人脸数据库列表接口提交任务并发默认为2QPS。'."\n" + .'## 输入限制'."\n" + ."\n" + .'- 图像格式：PNG、JPG、JPEG、BMP、GIF、WEBP。'."\n" + .'- 图像大小：不超过10 MB。'."\n" + .'- 图像分辨率：建议大于256×256像素，人脸区域大于128*128，像素过低可能会影响识别效果。'."\n" + .'- URL地址中不能包含中文字符。'."\n" + ."\n" + .'> 当图像分辨率超过最大限制时，请先将图片进行缩放，调整图片大小，具体请参见[图片缩放](~~44688~~)。'."\n" + ."\n" + .'## 检测说明'."\n" + ."\n" + .'- 最长检测时间是5秒，如果在该时间内没有完成检测，系统会强制返回超时错误码。'."\n" + .'- 图像下载时间限制为3秒，如果下载时间超过3秒，系统会返回下载超时。'."\n" + .'- 图像检测接口响应时间依赖图像的下载时间。请保证被检测图像所在的存储服务稳定可靠，建议您使用阿里云OSS存储或者CDN缓存。'."\n" + .'- 最多可检测10张图像。'."\n" ."\n" .'## 计费说明'."\n" - .'查询人脸数据库列表能力可免费调用。', - 'requestParamsDescription' => ' ', + .'换脸鉴别能力目前处于公测期，可免费调用。', 'responseParamsDescription' => '## SDK参考'."\n" - .'阿里云视觉AI人脸人体类目下的查询人脸数据库列表能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。', - 'extraInfo' => '## 错误码'."\n" - .'关于查询人脸数据库列表的错误码，详情请参见[常见错误码](~~146756~~)。'."\n" + .'阿里云视觉AI人脸人体类目下的换脸鉴别能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。', + 'extraInfo' => '## 换脸鉴别阈值参考'."\n" + .'接口返回Label默认按照Confidence的阈值为50，当Confidence小于50，**Label**为`normalface`；当Confidence大于50，**Label**为`deepfakeface`。'."\n" + .'Confidence为模型置信度，取值范围是\\[0,100]，越低表示属于真脸的概率越大。您也可以通过卡Confidence阈值的方法匹配不同使用场景更灵活使用，内部实验参考数据如下。'."\n" + ."\n" + .'| Confidence阈值 | 伪造人脸拦截率 | 真实人脸通过率 |'."\n" + .'| ---- | ------------ | ---- |'."\n" + .'|15 |98.21% |80.27% |'."\n" + .'|30 |97.56% |87.59% |'."\n" + .'|40 |97.04% |90.67% |'."\n" + .'|50（默认） |95.09% |96.61% |'."\n" + .'|60 |92.50% |98.13% |'."\n" + .'|70 |90.59% |98.77% |'."\n" + ."\n" + .'关于以上数值的概念定义：'."\n" + .'- 伪造人脸拦截率：如98%，代表100次作弊伪造人脸攻击，会有98次被API识破拒绝。'."\n" + .'- 真实人脸通过率：如98%，代表100次真实人脸请求，会有98次顺利通过活体验证。'."\n" + ."\n" + .'> 内部实验数据测算，仅供参考。'."\n" + ."\n" + .'## 错误码'."\n" + .'关于换脸鉴别的错误码，详情请参见[常见错误码](~~146756~~)。'."\n" ."\n" .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。'."\n" - .'- 平台不存储用户在使用服务过程中涉及的原始人脸图片或文件信息。'."\n" - .'- 平台针对超过6个月及以上没有API服务调用的用户的人脸特征向量数据进行冻结，确保无服务调用的客户信息安全。如需解冻，请通过钉钉群（23109592）联系我们。', - ], - 'AddFaceImageTemplate' => [ - 'summary' => '本文介绍图像人脸融合模板增加AddFaceImageTemplate的语法及示例。', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'http', - 'https', + .'- 平台不存储用户在使用服务过程中涉及的原始人脸图片或文件信息。', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'viapi-facebody:DeepfakeFace', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + ], + 'DeleteFace' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], + 'operationType' => 'read', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'create', - ], + 'systemTags' => ['operationType' => 'delete'], 'parameters' => [ [ - 'name' => 'ImageURL', + 'name' => 'DbName', 'in' => 'formData', - 'schema' => [ - 'description' => '人脸模板的图像地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。'."\n" - .'输入限制：'."\n" - .'- 图像格式：JPG、JPEG、PNG。'."\n" - .'- 图像大小：不超过20 MB。'."\n" - .'- 图像分辨率：大于等于128×128像素，小于等于2000×2000像素，最长边小于等于2000像素。'."\n" - .'- URL地址中不能包含中文字符。'."\n" - .'- 支持输入多人图像，建议图像中人脸个数不超过5个。', - 'type' => 'string', - 'required' => true, - 'example' => 'https://invi-label.oss-cn-shanghai.aliyuncs.com/label/temp/faceswap/img_facefusion/template/sucai1.jpg', - 'isFileTransferUrl' => true, - ], + 'schema' => ['description' => '数据库名称。', 'type' => 'string', 'required' => true, 'example' => 'default'], + ], + [ + 'name' => 'FaceId', + 'in' => 'formData', + 'schema' => ['description' => '人脸数据ID。', 'type' => 'string', 'required' => true, 'example' => '001'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '798A721D-7C7F-4D87-A125-1D04B3055C2C', - ], - 'Data' => [ - 'description' => '返回的结果数据内容。', - 'type' => 'object', - 'properties' => [ - 'TemplateId' => [ - 'description' => '模板ID。', - 'type' => 'string', - 'example' => '6cd509ea-54fa-4730-8e9d-c94cadcda048', - ], - 'FaceInfos' => [ - 'description' => '用户输入图为多个人脸时，返回各人脸ID和位置信息。'."\n" - ."\n" - .'> 只有在多人脸场景中，才会返回**FaceInfos**参数。', - 'type' => 'array', - 'items' => [ - 'description' => '用户输入图为多个人脸时，返回各人脸ID和位置信息。'."\n" - ."\n" - .'> 只有在多人脸场景中，才会返回**FaceInfos**参数。', - 'type' => 'object', - 'properties' => [ - 'TemplateFaceID' => [ - 'description' => '人脸对应的子模板ID。', - 'type' => 'string', - 'example' => 'string 6cd509ea-54fa-4730-8e9d-c94cadcda048_0', - ], - 'FaceRect' => [ - 'description' => '人脸对应的位置信息。', - 'type' => 'object', - 'properties' => [ - 'X' => [ - 'description' => '人脸框左上角横坐标。', - 'type' => 'string', - 'example' => '254', - ], - 'Y' => [ - 'description' => '人脸框左上角纵坐标。', - 'type' => 'string', - 'example' => '318', - ], - 'Height' => [ - 'description' => '人脸框高度。', - 'type' => 'string', - 'example' => '94', - ], - 'Width' => [ - 'description' => '人脸框宽度。', - 'type' => 'string', - 'example' => '89', - ], - ], - ], - ], - ], - ], - ], - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'FAC90D32-2F04-5AD4-B94B-BAA163AB3724'], ], + 'description' => '', ], ], ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'ParameterError', - 'errorMessage' => 'The parameter is invalid. Please check again.', - ], + ['errorCode' => 'ParameterError', 'errorMessage' => 'The parameter is invalid. Please check again.', 'description' => '参数错误，请检查参数值'], ], 403 => [ - [ - 'errorCode' => 'AuthFailed', - 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', - ], + ['errorCode' => 'AuthFailed', 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', 'description' => '授权失败，请检查RAM权限配置'], ], 408 => [ - [ - 'errorCode' => 'Timeout', - 'errorMessage' => 'The request has timed out.', - ], + ['errorCode' => 'Timeout', 'errorMessage' => 'The request has timed out.', 'description' => '请求超时，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'The service is unavailable.', - ], + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'The service is unavailable.', 'description' => '服务不可用，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"798A721D-7C7F-4D87-A125-1D04B3055C2C\\",\\n \\"Data\\": {\\n \\"TemplateId\\": \\"6cd509ea-54fa-4730-8e9d-c94cadcda048\\",\\n \\"FaceInfos\\": [\\n {\\n \\"TemplateFaceID\\": \\"string 6cd509ea-54fa-4730-8e9d-c94cadcda048_0\\",\\n \\"FaceRect\\": {\\n \\"X\\": \\"254\\",\\n \\"Y\\": \\"318\\",\\n \\"Height\\": \\"94\\",\\n \\"Width\\": \\"89\\"\\n }\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n 7BC58484-6724-508F-857D-0E7035AD5DEA\\n \\n 30f738a9-1e69-4ecb-8bbc-50bf0aa75e60\\n \\n","errorExample":""}]', - 'title' => '添加人脸图像模板', + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"FAC90D32-2F04-5AD4-B94B-BAA163AB3724\\"\\n}","errorExample":""},{"type":"xml","example":"\\n FAC90D32-2F04-5AD4-B94B-BAA163AB3724\\n","errorExample":""}]', + 'title' => '删除人脸', + 'summary' => '本文介绍删除人脸DeleteFace的语法及示例。', 'description' => '## 功能描述'."\n" - .'图像人脸融合模板增加功能可以将已通过内容审核的人脸图像，作为人脸融合的模板图，供图像人脸融合功能使用。'."\n" + .'删除人脸能力可以删除指定数据库中的人脸图片信息。'."\n" ."\n" - .'> - 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" + .'>'."\n" + ."\n" + .'- 人脸图片信息删除后不可恢复，请谨慎操作。'."\n" + .'- 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" .'- 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。'."\n" ."\n" + .'>'."\n" + ."\n" .'## 接入指引'."\n" .'1. 注册阿里云账号：打开[阿里云官网](https://www.aliyun.com)，在阿里云官网右上角，单击**立即注册**，按照操作提示完成账号注册。'."\n" .'2. 开通能力：请确保您已开通[人脸人体服务](https://vision.aliyun.com/facebody)，若未开通服务请[立即开通](https://common-buy.aliyun.com/?commodityCode=viapi_facebody_public_cn#/open)。'."\n" + ."\n" .'>'."\n" - .'本能力仅限企业认证用户开通。更多实名认证操作信息，请参见[实名认证](https://help.aliyun.com/knowledge_list/37170.html)。'."\n" + .'本能力支持企业或个人认证用户开通。更多实名认证操作信息，请参见[实名认证](https://help.aliyun.com/knowledge_list/37170.html)。'."\n" .'>'."\n" ."\n" .'3. 创建AccessKey：请确保您已[创建AccessKey](~~175144~~)，如果您使用的是子账号AccessKey，您需要给子账号赋予AliyunVIAPIFullAccess权限，具体操作，请参见[RAM授权](~~145025~~)。'."\n" - ."\n" - .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/facebody/2019-12-30/AddFaceImageTemplate?lang=JAVA&sdkStyle=old¶ms=%7B%7D&tab=DEMO)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" + .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/facebody/2019-12-30/DeleteFace?lang=JAVA)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" .'5. 开发接入步骤：'."\n" .'- 在[SDK总览](~~145033~~)中选择您要接入使用的SDK语言。'."\n" .'- 在对应语言的SDK文档中找到AI类目为人脸人体（facebody）的SDK包进行安装。'."\n" .'- 参考文档中提供的示例代码进行适当修改后调用。'."\n" ."\n" - .'6. 示例代码：该能力常用语言的示例代码，请参见[图像人脸融合模板增加示例代码](~~478119~~)。'."\n" - ."\n" - .'7. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" + .'6. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" .'- [Web前端直接调用](~~467779~~)'."\n" .'- [小程序场景下直接调用](~~467780~~)'."\n" .'- [Android端直接调用](~~467781~~)'."\n" .'- [iOS端直接调用](~~467782~~)'."\n" ."\n" - .'## 输入限制'."\n" - .'- 图像格式：JPG、JPEG、PNG。'."\n" - .'- 图像大小：不超过20 MB。'."\n" - .'- 图像分辨率：大于等于128×128像素，小于等于2000×2000像素，最长边小于等于2000像素。'."\n" - .'- URL地址中不能包含中文字符。'."\n" - .'- 支持输入多人图像，建议图像中人脸个数不超过5个。'."\n" - .'- 不限制可以增加的模板数量。'."\n" - ."\n" - .'## 图像质量建议'."\n" - .'- 要求保证图像中的人脸清晰。图像中人脸尺寸建议大于64×64像素，人脸区域建议不大于全图区域的2/3。'."\n" - .'- 建议图像中人脸五官区域轮廓完整，无明显遮挡。人脸融合算法支持人脸偏侧一定角度，在偏侧角度不超过30度的情况下能取得更佳效果。'."\n" - ."\n" - .'推荐图像示例：'."\n" - .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20221114/jris/MergeImageFacetuijian.png" width="300)'."\n" - .'不推荐图像示例：'."\n" - .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20221114/rkbx/MergeImageFacebutuijian.png" width="300)'."\n" + .'## 限制说明'."\n" + .'删除人脸接口提交任务并发默认为2QPS。'."\n" ."\n" .'## 计费说明'."\n" - .'图像人脸融合模板增加能力可免费调用。', + .'删除人脸能力可免费调用。', + 'requestParamsDescription' => ' ', 'responseParamsDescription' => '## SDK参考'."\n" - .'阿里云视觉AI人脸人体类目下的图像人脸融合模板增加能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。'."\n" - ."\n" - .'## 示例代码'."\n" - .'该能力常用语言的示例代码，请参见[图像人脸融合模板增加示例代码](~~478119~~)。', + .'阿里云视觉AI人脸人体类目下的删除人脸能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。', 'extraInfo' => '## 错误码'."\n" - .'关于图像人脸融合模板增加的错误码，详情请参见[常见错误码](~~146756~~)。'."\n" + .'关于删除人脸的错误码，详情请参见[常见错误码](~~146756~~)。'."\n" ."\n" .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" - .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。', - ], - 'DeleteFaceImageTemplate' => [ - 'summary' => '本文介绍图像人脸融合模板删除DeleteFaceImageTemplate的语法及示例。', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'http', - 'https', + .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。'."\n" + .'- 平台不存储用户在使用服务过程中涉及的原始人脸图片或文件信息。'."\n" + .'- 平台针对超过6个月及以上没有API服务调用的用户的人脸特征向量数据进行冻结，确保无服务调用的客户信息安全。如需解冻，请通过钉钉群（23109592）联系我们。', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => 'delete', + 'ramAction' => [ + 'action' => 'viapi-facebody:DeleteFace', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + ], + 'DeleteFaceDb' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], + 'operationType' => 'write', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'delete', - ], + 'systemTags' => ['operationType' => 'delete'], 'parameters' => [ [ - 'name' => 'TemplateId', + 'name' => 'Name', 'in' => 'formData', - 'schema' => [ - 'description' => '待删除的模板ID。', - 'type' => 'string', - 'required' => true, - 'example' => '6cd509ea-54fa-4730-8e9d-c94cadcda048', - ], + 'schema' => ['description' => '数据库名称。', 'type' => 'string', 'required' => true, 'example' => 'default'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'F9E76786-3A85-43C3-B79C-3175B4536252', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '203AE658-CFE1-507D-B105-F88CD1F1F71B'], ], + 'description' => '', ], ], ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'ParameterError', - 'errorMessage' => 'The parameter is invalid. Please check again.', - ], + ['errorCode' => 'ParameterError', 'errorMessage' => 'The parameter is invalid. Please check again.', 'description' => '参数错误，请检查参数值'], ], 403 => [ - [ - 'errorCode' => 'AuthFailed', - 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', - ], + ['errorCode' => 'AuthFailed', 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', 'description' => '授权失败，请检查RAM权限配置'], ], 408 => [ - [ - 'errorCode' => 'Timeout', - 'errorMessage' => 'The request has timed out.', - ], + ['errorCode' => 'Timeout', 'errorMessage' => 'The request has timed out.', 'description' => '请求超时，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'The service is unavailable.', - ], + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'The service is unavailable.', 'description' => '服务不可用，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"F9E76786-3A85-43C3-B79C-3175B4536252\\"\\n}","errorExample":""},{"type":"xml","example":"F9E76786-3A85-43C3-B79C-3175B4536252","errorExample":""}]', - 'title' => '图像人脸融合模板删除', + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"203AE658-CFE1-507D-B105-F88CD1F1F71B\\"\\n}","errorExample":""},{"type":"xml","example":"\\n 203AE658-CFE1-507D-B105-F88CD1F1F71B\\n","errorExample":""}]', + 'title' => '删除人脸数据库', + 'summary' => '本文介绍删除数据库DeleteFaceDb的语法及示例。', 'description' => '## 功能描述'."\n" - .'图像人脸融合模板删除功能可以删除用户添加过的人脸模板。'."\n" + .'删除数据库能力用于删除指定的人脸数据库。'."\n" ."\n" - .'> - 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" + .'>'."\n" + ."\n" + .'- 数据库删除后不可恢复，请谨慎操作。'."\n" + .'- 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" .'- 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。'."\n" ."\n" + .'>'."\n" + ."\n" .'## 接入指引'."\n" .'1. 注册阿里云账号：打开[阿里云官网](https://www.aliyun.com)，在阿里云官网右上角，单击**立即注册**，按照操作提示完成账号注册。'."\n" .'2. 开通能力：请确保您已开通[人脸人体服务](https://vision.aliyun.com/facebody)，若未开通服务请[立即开通](https://common-buy.aliyun.com/?commodityCode=viapi_facebody_public_cn#/open)。'."\n" + ."\n" .'>'."\n" - .'本能力仅限企业认证用户开通。更多实名认证操作信息，请参见[实名认证](https://help.aliyun.com/knowledge_list/37170.html)。'."\n" + .'本能力支持企业或个人认证用户开通。更多实名认证操作信息，请参见[实名认证](https://help.aliyun.com/knowledge_list/37170.html)。'."\n" .'>'."\n" ."\n" .'3. 创建AccessKey：请确保您已[创建AccessKey](~~175144~~)，如果您使用的是子账号AccessKey，您需要给子账号赋予AliyunVIAPIFullAccess权限，具体操作，请参见[RAM授权](~~145025~~)。'."\n" - .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/facebody/2019-12-30/DeleteFaceImageTemplate?lang=JAVA&sdkStyle=old¶ms=%7B%7D&tab=DEMO)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" - .'5. 前提条件：已通过[图像人脸融合模板增加接口](~~203512~~)（AddFaceImageTemplate）创建生成了TemplateId。'."\n" - .'6. 开发接入步骤：'."\n" + .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/facebody/2019-12-30/DeleteFaceDb?lang=JAVA)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" + .'5. 开发接入步骤：'."\n" .'- 在[SDK总览](~~145033~~)中选择您要接入使用的SDK语言。'."\n" .'- 在对应语言的SDK文档中找到AI类目为人脸人体（facebody）的SDK包进行安装。'."\n" .'- 参考文档中提供的示例代码进行适当修改后调用。'."\n" ."\n" - .'7. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" + .'6. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" .'- [Web前端直接调用](~~467779~~)'."\n" .'- [小程序场景下直接调用](~~467780~~)'."\n" .'- [Android端直接调用](~~467781~~)'."\n" - .'- [iOS端直接调用](~~467782~~)'."\n", + .'- [iOS端直接调用](~~467782~~)'."\n" + ."\n" + .'## 限制说明'."\n" + .'删除数据库接口提交任务并发默认为2QPS。'."\n" + ."\n" + .'## 计费说明'."\n" + .'删除数据库能力可免费调用。', + 'requestParamsDescription' => ' ', 'responseParamsDescription' => '## SDK参考'."\n" - .'阿里云视觉AI人脸人体类目下的图像人脸融合模板删除能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。', + .'阿里云视觉AI人脸人体类目下的删除数据库能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。', 'extraInfo' => '## 错误码'."\n" - .'关于图像人脸融合模板删除的错误码，详情请参见[常见错误码](~~146756~~)。'."\n" - ."\n\n" + .'关于删除数据库的错误码，详情请参见[常见错误码](~~146756~~)。'."\n" + ."\n" .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" - .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。', - ], - 'QueryFaceImageTemplate' => [ - 'summary' => '本文介绍图像人脸融合模板查询QueryFaceImageTemplate的语法及示例。', - 'methods' => [ - 'get', - ], - 'schemes' => [ - 'http', - 'https', + .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。'."\n" + .'- 平台不存储用户在使用服务过程中涉及的原始人脸图片或文件信息。'."\n" + .'- 平台针对超过6个月及以上没有API服务调用的用户的人脸特征向量数据进行冻结，确保无服务调用的客户信息安全。如需解冻，请通过钉钉群（23109592）联系我们。', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => 'delete', + 'ramAction' => [ + 'action' => 'viapi-facebody:DeleteFaceDb', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + ], + 'DeleteFaceEntity' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], + 'operationType' => 'read', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'get', - ], + 'systemTags' => ['operationType' => 'delete'], 'parameters' => [ [ - 'name' => 'TemplateId', - 'in' => 'query', - 'schema' => [ - 'description' => '待查询的模板ID。如果未传TemplateId，返回该用户的模板列表；如果传入TemplateId，仅返回对应的结果。', - 'type' => 'string', - 'required' => false, - 'example' => '6cd509ea-54fa-4730-8e9d-c94cadcda048', - ], - ], - [ - 'name' => 'PageNo', - 'in' => 'query', - 'schema' => [ - 'description' => '当前页数设置，默认第1页。取值范围为1~5000。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'maximum' => '5000', - 'minimum' => '1', - 'example' => '1', - 'default' => '1', - ], + 'name' => 'DbName', + 'in' => 'formData', + 'schema' => ['description' => '数据库名称。', 'type' => 'string', 'required' => true, 'example' => 'default'], ], [ - 'name' => 'PageSize', - 'in' => 'query', - 'schema' => [ - 'description' => '当前页条数设置，默认100条。取值范围为1~500。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'maximum' => '500', - 'minimum' => '1', - 'example' => '100', - 'default' => '100', - ], + 'name' => 'EntityId', + 'in' => 'formData', + 'schema' => ['description' => '实体ID，如员工编号。可以包含数字、字母和下划线。', 'type' => 'string', 'required' => true, 'example' => 'wood'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '7C29675C-751F-4D2F-86FB-2BD8D69AC860', - ], - 'Data' => [ - 'description' => '返回的结果数据内容。', - 'type' => 'object', - 'properties' => [ - 'Total' => [ - 'description' => '当前账号下的可用模板总数量。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '20', - ], - 'Elements' => [ - 'description' => '模板列表。', - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'CreateTime' => [ - 'description' => '模板创建时间。', - 'type' => 'string', - 'example' => '2021-01-29 10:19:05', - ], - 'UpdateTime' => [ - 'description' => '模板更新时间。', - 'type' => 'string', - 'example' => '2021-01-29 10:19:05', - ], - 'UserId' => [ - 'description' => '用户ID。', - 'type' => 'string', - 'example' => 'zhangsan', - ], - 'TemplateId' => [ - 'description' => '模板ID。', - 'type' => 'string', - 'example' => '6cd509ea-54fa-4730-8e9d-c94cadcda048', - ], - 'TemplateURL' => [ - 'description' => '新增模板时设置的人脸模板图像地址。', - 'type' => 'string', - 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/MergeImageFace/MergeImageFace-1.png', - ], - 'FaceInfos' => [ - 'description' => '用户输入图为多个人脸时，返回各人脸ID和位置信息。', - 'type' => 'array', - 'items' => [ - 'description' => '用户输入图为多个人脸时，返回各人脸ID和位置信息。', - 'type' => 'object', - 'properties' => [ - 'TemplateFaceID' => [ - 'description' => '人脸对应的子模板ID。', - 'type' => 'string', - 'example' => '6cd509ea-54fa-4730-8e9d-c94cadcda048', - ], - 'FaceRect' => [ - 'description' => '人脸对应的位置信息。', - 'type' => 'object', - 'properties' => [ - 'X' => [ - 'description' => '人脸框左上角横坐标。', - 'type' => 'string', - 'example' => '254', - ], - 'Y' => [ - 'description' => '人脸框左上角纵坐标。', - 'type' => 'string', - 'example' => '318', - ], - 'Height' => [ - 'description' => '人脸框高度。', - 'type' => 'string', - 'example' => '94', - ], - 'Width' => [ - 'description' => '人脸框宽度。', - 'type' => 'string', - 'example' => '89', - ], - ], - ], - ], - ], - ], - ], - ], - ], - ], - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'DA7CAFEB-0A37-4496-9CDF-E3DBB6309CB2'], ], + 'description' => '', ], ], ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'ParameterError', - 'errorMessage' => 'The parameter is invalid. Please check again.', - ], + ['errorCode' => 'ParameterError', 'errorMessage' => 'The parameter is invalid. Please check again.', 'description' => '参数错误，请检查参数值'], ], 403 => [ - [ - 'errorCode' => 'AuthFailed', - 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', - ], + ['errorCode' => 'AuthFailed', 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', 'description' => '授权失败，请检查RAM权限配置'], ], 408 => [ - [ - 'errorCode' => 'Timeout', - 'errorMessage' => 'The request has timed out.', - ], + ['errorCode' => 'Timeout', 'errorMessage' => 'The request has timed out.', 'description' => '请求超时，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'The service is unavailable.', - ], + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'The service is unavailable.', 'description' => '服务不可用，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"7C29675C-751F-4D2F-86FB-2BD8D69AC860\\",\\n \\"Data\\": {\\n \\"Total\\": 20,\\n \\"Elements\\": [\\n {\\n \\"CreateTime\\": \\"2021-01-29 10:19:05\\",\\n \\"UpdateTime\\": \\"2021-01-29 10:19:05\\",\\n \\"UserId\\": \\"zhangsan\\",\\n \\"TemplateId\\": \\"6cd509ea-54fa-4730-8e9d-c94cadcda048\\",\\n \\"TemplateURL\\": \\"http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/MergeImageFace/MergeImageFace-1.png\\",\\n \\"FaceInfos\\": [\\n {\\n \\"TemplateFaceID\\": \\"6cd509ea-54fa-4730-8e9d-c94cadcda048\\",\\n \\"FaceRect\\": {\\n \\"X\\": \\"254\\",\\n \\"Y\\": \\"318\\",\\n \\"Height\\": \\"94\\",\\n \\"Width\\": \\"89\\"\\n }\\n }\\n ]\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n 7C29675C-751F-4D2F-86FB-2BD8D69AC860\\n \\n 20\\n \\n 2021-01-29 10:19:05\\n 2021-01-29 10:19:05\\n zhangsan\\n 6cd509ea-54fa-4730-8e9d-c94cadcda048\\n http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/MergeImageFace/MergeImageFace-1.png\\n \\n 6cd509ea-54fa-4730-8e9d-c94cadcda048\\n \\n 254\\n 318\\n 94\\n 89\\n \\n \\n \\n \\n","errorExample":""}]', - 'title' => '查询人脸图像模板', + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"DA7CAFEB-0A37-4496-9CDF-E3DBB6309CB2\\"\\n}","errorExample":""},{"type":"xml","example":"DA7CAFEB-0A37-4496-9CDF-E3DBB6309CB2","errorExample":""}]', + 'title' => '删除人脸样本', + 'summary' => '本文介绍删除人脸样本DeleteFaceEntity的语法及示例。', 'description' => '## 功能描述'."\n" - .'图像人脸融合模板查询功能可以查询用户添加过的人脸模板图。'."\n" + .'删除人脸样本能力用于删除人脸数据库中的人脸样本数据。'."\n" ."\n" - .'> - 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" + .'>'."\n" + ."\n" + .'- 删除人脸样本，样本中的人脸数据也会被删除，且不可恢复，请谨慎操作。'."\n" + .'- 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" .'- 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。'."\n" ."\n" + .'>'."\n" + ."\n" .'## 接入指引'."\n" - .'1. 注册阿里云账号：打开[阿里云官网](https://www.aliyun.com)，在阿里云官网右上角，单击**立即注册**，按照操作提示完成账号注册。'."\n" - .'2. 开通能力：请确保您已开通[人脸人体服务](https://vision.aliyun.com/facebody)，若未开通服务请[立即开通](https://common-buy.aliyun.com/?commodityCode=viapi_facebody_public_cn#/open)。'."\n" + .'1. 注册阿里云账号：打开[阿里云官网](https://www.aliyun.com)，在阿里云官网右上角，单击**立即注册**，按照操作提示完成账号注册。'."\n" + .'2. 开通能力：请确保您已开通[人脸人体服务](https://vision.aliyun.com/facebody)，若未开通服务请[立即开通](https://common-buy.aliyun.com/?commodityCode=viapi_facebody_public_cn#/open)。'."\n" .'>'."\n" - .'本能力仅限企业认证用户开通。更多实名认证操作信息，请参见[实名认证](https://help.aliyun.com/knowledge_list/37170.html)。'."\n" + .'本能力支持企业或个人认证用户开通。更多实名认证操作信息，请参见[实名认证](https://help.aliyun.com/knowledge_list/37170.html)。'."\n" .'>'."\n" ."\n" .'3. 创建AccessKey：请确保您已[创建AccessKey](~~175144~~)，如果您使用的是子账号AccessKey，您需要给子账号赋予AliyunVIAPIFullAccess权限，具体操作，请参见[RAM授权](~~145025~~)。'."\n" - .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/facebody/2019-12-30/QueryFaceImageTemplate?lang=JAVA&sdkStyle=old¶ms=%7B%7D&tab=DEMO)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" - .'5. 前提条件：已通过[图像人脸融合模板增加接口](~~203512~~)（AddFaceImageTemplate）创建生成了TemplateId。'."\n" - .'6. 开发接入步骤：'."\n" + .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/facebody/2019-12-30/DeleteFaceEntity?lang=JAVA)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" + .'5. 开发接入步骤：'."\n" .'- 在[SDK总览](~~145033~~)中选择您要接入使用的SDK语言。'."\n" .'- 在对应语言的SDK文档中找到AI类目为人脸人体（facebody）的SDK包进行安装。'."\n" .'- 参考文档中提供的示例代码进行适当修改后调用。'."\n" ."\n" - .'7. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" + .'6. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" .'- [Web前端直接调用](~~467779~~)'."\n" .'- [小程序场景下直接调用](~~467780~~)'."\n" .'- [Android端直接调用](~~467781~~)'."\n" .'- [iOS端直接调用](~~467782~~)'."\n" ."\n" + .'## 限制说明'."\n" + .'删除人脸样本接口提交任务并发默认为2QPS。'."\n" + ."\n\n" .'## 计费说明'."\n" - .'图像人脸融合模板查询能力可免费调用。', + .'删除人脸样本能力可免费调用。', + 'requestParamsDescription' => ' ', 'responseParamsDescription' => '## SDK参考'."\n" - .'阿里云视觉AI人脸人体类目下的图像人脸融合模板查询能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。', + .'阿里云视觉AI人脸人体类目下的删除人脸样本能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。', 'extraInfo' => '## 错误码'."\n" - .'关于图像人脸融合模板查询的错误码，详情请参见[常见错误码](~~146756~~)。'."\n" - ."\n\n" + .'关于删除人脸样本的错误码，详情请参见[常见错误码](~~146756~~)。'."\n" + ."\n" .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" - .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。', - ], - 'BlurFace' => [ - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', + .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。'."\n" + .'- 平台不存储用户在使用服务过程中涉及的原始人脸图片或文件信息。'."\n" + .'- 平台针对超过6个月及以上没有API服务调用的用户的人脸特征向量数据进行冻结，确保无服务调用的客户信息安全。如需解冻，请通过钉钉群（23109592）联系我们。', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => 'delete', + 'ramAction' => [ + 'action' => 'viapi-facebody:DeleteFaceEntity', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + ], + 'DeleteFaceImageTemplate' => [ + 'summary' => '本文介绍图像人脸融合模板删除DeleteFaceImageTemplate的语法及示例。', + 'methods' => ['post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', 'deprecated' => false, - 'systemTags' => [], + 'systemTags' => ['operationType' => 'delete'], 'parameters' => [ [ - 'name' => 'ImageURL', + 'name' => 'TemplateId', 'in' => 'formData', - 'schema' => [ - 'description' => '图像URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。', - 'type' => 'string', - 'required' => true, - 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/BlurFace/BlurFace1.png', - 'isFileTransferUrl' => true, - ], + 'schema' => ['description' => '待删除的模板ID。', 'type' => 'string', 'required' => true, 'example' => '6cd509ea-54fa-4730-8e9d-c94cadcda048'], ], ], 'responses' => [ 200 => [ 'schema' => [ + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '4C6080B0-64C4-488E-BBA6-245749CA11AD', - ], - 'Data' => [ - 'description' => '结果数据内容。', - 'type' => 'object', - 'properties' => [ - 'ImageURL' => [ - 'description' => '脱敏后的图片URL地址。'."\n" - .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。', - 'type' => 'string', - 'example' => 'http://viapi-cn-shanghai-dha-segmenter.oss-cn-shanghai.aliyuncs.com/upload/result_FaceBlur/2020-8-5/invi_FaceBlur_015966077063461060948_IBdDsq.jpg?Expires=1596609506&OSSAccessKeyId=LTAI****************&Signature=x8n3jq1X91Sq7BKWE4vRHSu6g9****', - ], - 'MaskURL' => [ - 'description' => '脱敏后的图片Mask地址。'."\n" - .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。', - 'type' => 'string', - 'example' => 'http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/person-image-cartoonizer/59697D68-2A6E-4553-89BD-0FADD07881E8_7ee5_20201027-070958.jpg?Expires=1603784400&OSSAccessKeyId=LTAI****************&Signature=ut2kn46Lz%2FRwqJ9jWJ0RBDut12****', - ], - ], - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => 'F9E76786-3A85-43C3-B79C-3175B4536252'], ], ], ], ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'ParameterError', - 'errorMessage' => 'The parameter is invalid. Please check again.', - ], + ['errorCode' => 'ParameterError', 'errorMessage' => 'The parameter is invalid. Please check again.', 'description' => '参数错误，请检查参数值'], ], 403 => [ - [ - 'errorCode' => 'AuthFailed', - 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', - ], + ['errorCode' => 'AuthFailed', 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', 'description' => '授权失败，请检查RAM权限配置'], ], 408 => [ - [ - 'errorCode' => 'Timeout', - 'errorMessage' => 'The request has timed out.', - ], + ['errorCode' => 'Timeout', 'errorMessage' => 'The request has timed out.', 'description' => '请求超时，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'The service is unavailable.', - ], + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'The service is unavailable.', 'description' => '服务不可用，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"4C6080B0-64C4-488E-BBA6-245749CA11AD\\",\\n \\"Data\\": {\\n \\"ImageURL\\": \\"http://viapi-cn-shanghai-dha-segmenter.oss-cn-shanghai.aliyuncs.com/upload/result_FaceBlur/2020-8-5/invi_FaceBlur_015966077063461060948_IBdDsq.jpg?Expires=1596609506&OSSAccessKeyId=LTAI****************&Signature=x8n3jq1X91Sq7BKWE4vRHSu6g9****\\",\\n \\"MaskURL\\": \\"http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/person-image-cartoonizer/59697D68-2A6E-4553-89BD-0FADD07881E8_7ee5_20201027-070958.jpg?Expires=1603784400&OSSAccessKeyId=LTAI****************&Signature=ut2kn46Lz%2FRwqJ9jWJ0RBDut12****\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n 4C6080B0-64C4-488E-BBA6-245749CA11AD\\n \\n http://viapi-cn-shanghai-dha-segmenter.oss-cn-shanghai.aliyuncs.com/upload/result_FaceBlur/2020-8-5/invi_FaceBlur_015966077063461060948_IBdDsq.jpg?Expires=1596609506&OSSAccessKeyId=LTAI****************&Signature=x8n3jq1X91Sq7BKWE4vRHSu6g9****\\n http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/person-image-cartoonizer/59697D68-2A6E-4553-89BD-0FADD07881E8_7ee5_20201027-070958.jpg?Expires=1603784400&OSSAccessKeyId=LTAI****************&Signature=ut2kn46Lz%2FRwqJ9jWJ0RBDut12****\\n \\n","errorExample":""}]', - 'title' => '人脸信息脱敏', - 'summary' => '本文介绍人脸信息脱敏BlurFace的语法及示例。', + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"F9E76786-3A85-43C3-B79C-3175B4536252\\"\\n}","errorExample":""},{"type":"xml","example":"F9E76786-3A85-43C3-B79C-3175B4536252","errorExample":""}]', + 'title' => '图像人脸融合模板删除', 'description' => '## 功能描述'."\n" - .'人脸信息脱敏能力对输入图像中的人脸进行模糊处理，输出脱敏后的图像。'."\n" + .'图像人脸融合模板删除功能可以删除用户添加过的人脸模板。'."\n" ."\n" .'> - 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" - .'- 当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击[立即试用](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=BlurFace)对该能力进行更直观试用以及在线购买。'."\n" .'- 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。'."\n" ."\n" .'## 接入指引'."\n" .'1. 注册阿里云账号：打开[阿里云官网](https://www.aliyun.com)，在阿里云官网右上角，单击**立即注册**，按照操作提示完成账号注册。'."\n" .'2. 开通能力：请确保您已开通[人脸人体服务](https://vision.aliyun.com/facebody)，若未开通服务请[立即开通](https://common-buy.aliyun.com/?commodityCode=viapi_facebody_public_cn#/open)。'."\n" - .'> 本能力支持企业或个人认证用户开通。更多实名认证操作信息，请参见[实名认证](https://help.aliyun.com/knowledge_list/37170.html)。'."\n" + .'>'."\n" + .'本能力仅限企业认证用户开通。更多实名认证操作信息，请参见[实名认证](https://help.aliyun.com/knowledge_list/37170.html)。'."\n" + .'>'."\n" + ."\n" .'3. 创建AccessKey：请确保您已[创建AccessKey](~~175144~~)，如果您使用的是子账号AccessKey，您需要给子账号赋予AliyunVIAPIFullAccess权限，具体操作，请参见[RAM授权](~~145025~~)。'."\n" - .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/facebody/2019-12-30/BlurFace?lang=JAVA&sdkStyle=dara¶ms=%7B%22ImageURL%22%3A%22http%3A%2F%2Fviapi-test.oss-cn-shanghai.aliyuncs.com%2Fviapi-3.0domepic%2Ffacebody%2FBlurFace%2FBlurFace1.png%22%7D&tab=DEMO)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" - .'5. 开发接入步骤：'."\n" + .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/facebody/2019-12-30/DeleteFaceImageTemplate?lang=JAVA&sdkStyle=old¶ms=%7B%7D&tab=DEMO)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" + .'5. 前提条件：已通过[图像人脸融合模板增加接口](~~203512~~)（AddFaceImageTemplate）创建生成了TemplateId。'."\n" + .'6. 开发接入步骤：'."\n" .'- 在[SDK总览](~~145033~~)中选择您要接入使用的SDK语言。'."\n" .'- 在对应语言的SDK文档中找到AI类目为人脸人体（facebody）的SDK包进行安装。'."\n" .'- 参考文档中提供的示例代码进行适当修改后调用。'."\n" ."\n" - .'6. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" + .'7. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" .'- [Web前端直接调用](~~467779~~)'."\n" .'- [小程序场景下直接调用](~~467780~~)'."\n" .'- [Android端直接调用](~~467781~~)'."\n" - .'- [iOS端直接调用](~~467782~~)'."\n" - ."\n" - .'## 输入限制'."\n" - ."\n" - .'- 图像格式：JPEG、JPG、PNG、BMP。'."\n" - .'- 图像大小：不超过3 MB。'."\n" - .'- 图像分辨率：大于32x32像素，小于2000×2000像素。'."\n" - .'- URL地址中不能包含中文字符。'."\n" - ."\n" - .'> 当图像分辨率超过最大限制时，请先将图片进行缩放，调整图片大小，具体请参见[图片缩放](~~44688~~)。'."\n" - ."\n" - .'## 计费说明'."\n" - .'关于人脸信息脱敏的计费方式及报价，请参见[计费介绍](~~184049~~)。'."\n" - .'> 下方调试接口为付费接口，如需免费体验调试请前往[体验中心](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=BlurFace)。'."\n", - 'requestParamsDescription' => ' ', + .'- [iOS端直接调用](~~467782~~)'."\n", 'responseParamsDescription' => '## SDK参考'."\n" - .'阿里云视觉AI人脸人体类目下的人脸信息脱敏能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。', + .'阿里云视觉AI人脸人体类目下的图像人脸融合模板删除能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。', 'extraInfo' => '## 错误码'."\n" - .'关于人脸信息脱敏的错误码，详情请参见[常见错误码](~~146756~~)。'."\n" - ."\n" + .'关于图像人脸融合模板删除的错误码，详情请参见[常见错误码](~~146756~~)。'."\n" + ."\n\n" .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。', - ], - 'CompareFace' => [ - 'summary' => '本文介绍人脸比对CompareFace的语法及示例。', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'http', - 'https', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => 'delete', + 'ramAction' => [ + 'action' => 'viapi-facebody:DeleteFaceImageTemplate', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + ], + 'DetectBodyCount' => [ + 'methods' => ['post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -2665,248 +2152,67 @@ 'systemTags' => [], 'parameters' => [ [ - 'name' => 'QualityScoreThreshold', - 'in' => 'formData', - 'schema' => [ - 'title' => '质量分阈值，取值范围 [0.0, 100.0], 0.0或空 表示不做质量分判断逻辑。', - 'description' => '质量分阈值，对人脸图片进行质量分析判断，若某张人脸质量分小于该阈值，则会在返回结果上增加MessageTips说明。', - 'type' => 'number', - 'format' => 'float', - 'required' => false, - 'example' => '98.5', - ], - ], - [ - 'name' => 'ImageURLA', - 'in' => 'formData', - 'schema' => [ - 'description' => '图像A的URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。'."\n" - ."\n" - .'> **ImageURLA**与**ImageDataA**二选一，当URL方式与Base64编码方式共存时，URL方式优先。', - 'type' => 'string', - 'required' => false, - 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/CompareFace/CompareFace-right1.png', - 'isFileTransferUrl' => true, - ], - ], - [ - 'name' => 'ImageURLB', - 'in' => 'formData', - 'schema' => [ - 'description' => '图像B的URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。'."\n" - .'> **ImageURLB**与**ImageDataB**二选一，当URL方式与Base64编码方式共存时，URL方式优先。', - 'type' => 'string', - 'required' => false, - 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/CompareFace/CompareFace-left1.png', - 'isFileTransferUrl' => true, - ], - ], - [ - 'name' => 'ImageDataA', - 'in' => 'formData', - 'schema' => [ - 'description' => '图像A的Base64编码字符串。当与URL方式共存时，URL方式优先。文件的Base64编码处理操作，请参见[文件Base64处理](~~468191~~)。'."\n" - .'> **ImageURLA**与**ImageDataA**二选一，当URL方式与Base64编码方式共存时，URL方式优先。', - 'type' => 'string', - 'required' => false, - 'example' => '/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAgGBgcGBQgHBwcJCQgK****', - ], - ], - [ - 'name' => 'ImageDataB', + 'name' => 'ImageURL', 'in' => 'formData', - 'schema' => [ - 'description' => '图像B的Base64编码字符串。当与URL方式共存时，URL方式优先。文件的Base64编码处理操作，请参见[文件Base64处理](~~468191~~)。'."\n" - .'> **ImageURLB**与**ImageDataB**二选一，当URL方式与Base64编码方式共存时，URL方式优先。', - 'type' => 'string', - 'required' => false, - 'example' => '/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAgGBgcGBQgHBwcJCQgQ****', - ], + 'schema' => ['description' => '图像URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。', 'type' => 'string', 'required' => true, 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/DetectBodyCount/DetectBodyCount3.jpg', 'isFileTransferUrl' => true], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'description' => '1', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'B352CD68-C847-5C48-BE68-3F266356FDD7', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '1C709078-8886-4C91-AEDE-4E04EED0A689'], 'Data' => [ 'description' => '返回的结果数据内容。', 'type' => 'object', 'properties' => [ - 'Thresholds' => [ - 'description' => '1', - 'type' => 'array', - 'items' => [ - 'description' => '误识率在1/1000，1/10000，1/100000的情况下分别对应的置信度阈值。例如`[61.0,69.0,75.0]`，表示误识率为1/1000的情况下，置信度（Confidence）超过61%就可以认为是同一个人。', - 'type' => 'number', - 'format' => 'float', - 'example' => '[61,69,75]', - ], - ], - 'RectBList' => [ - 'description' => '1', - 'type' => 'array', - 'items' => [ - 'description' => '图片B中最大人脸矩形框`[left, top, width, height]`，例如`[169,48,125,162]`。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '[169,48,125,162]', - ], - ], - 'Confidence' => [ - 'description' => '两张图片中的最大人脸属于同一个人的置信度，取值范围0~100。供参考的三个阈值是61，69和75，分别对应千分之一，万分之一和十万分之一误识率。阈值设置越高，误识率越低，通过率也越低，对安全性要求越高的场合，可以设置更高的阈值。如果某张图片中没有人脸，则报错误信息。', - 'type' => 'number', - 'format' => 'float', - 'example' => '88.4831771850586', - ], - 'RectAList' => [ - 'description' => '1', - 'type' => 'array', - 'items' => [ - 'description' => '图片A中最大人脸矩形框`[left, top, width, height]`，例如`[157,82,147,188]`。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '[157,82,147,188]', - ], - ], - 'QualityScoreA' => [ - 'title' => '输入图像A的质量分', - 'description' => '输入图像A的质量分。', - 'type' => 'number', - 'format' => 'float', - 'example' => '99.65772247314453', - ], - 'QualityScoreB' => [ - 'title' => '输入图像A的质量分', - 'description' => '输入图像B的质量分。', - 'type' => 'number', - 'format' => 'float', - 'example' => '98.01177978515625', - ], - 'MessageTips' => [ - 'title' => '信息提示信息，纯文字描述，目前支持质量分的提示信息', - 'description' => '提示信息，纯文字描述，以下提示信息单独出现或是几条提示信息的组合。'."\n" - .'质量相关提示（某张人脸质量分小于请求参数质量分阈值时会出现）：'."\n" - .'- `imageA quality score less threshold`：图像A的质量分小于输入参数设置的阈值。'."\n" - .'- `imageB quality score less threshold`：图像B的质量分小于输入参数设置的阈值。'."\n" - ."\n" - .'人脸尺寸相关提示（检测到人脸且人脸宽或高小于50像素时会有该提示信息。出现该提示信息时，请尽可能输入像素数大于64x64的人脸，并请酌情参考返回的对比置信度Confidence值）：'."\n" - .'- `face in imageA is too small`：图像A中的人脸太小。'."\n" - .'- `face in imageB is too small`：图像B中的人脸太小。', - 'type' => 'string', - 'example' => 'imageB quality score less threshold', - ], - 'IsMaskA' => [ - 'description' => '图片A中的人脸是否戴口罩。'."\n" - .'- 0：不戴口罩。'."\n" - .'- 1：戴口罩。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '0', - ], - 'IsMaskB' => [ - 'description' => '图片B中的人脸是否戴口罩。'."\n" - .'- 0：不戴口罩。'."\n" - .'- 1：戴口罩。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '0', - ], - 'LandmarksAList' => [ - 'type' => 'array', - 'items' => [ - 'description' => '图片A人脸框所对应的人脸关键点坐标，顺序分别为左眼水平坐标，左眼垂直坐标，右眼水平坐标，右眼垂直坐标，鼻尖水平坐标，鼻尖垂直坐标，左嘴角水平坐标，左嘴角垂直坐标，右嘴角水平坐标，右嘴角垂直坐标。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '[201,146,266,159,222,190,187,208,255,219]', - ], - ], - 'LandmarksBList' => [ - 'type' => 'array', - 'items' => [ - 'description' => '图片B人脸框所对应的人脸关键点坐标，顺序分别为左眼水平坐标，左眼垂直坐标，右眼水平坐标，右眼垂直坐标，鼻尖水平坐标，鼻尖垂直坐标，左嘴角水平坐标，左嘴角垂直坐标，右嘴角水平坐标，右嘴角垂直坐标。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '[199,115,248,109,215,146,206,167,260,162]', - ], - ], + 'PersonNumber' => ['description' => '人体的个数。', 'type' => 'integer', 'format' => 'int32', 'example' => '6'], ], ], ], + 'description' => '', ], ], ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'ParameterError', - 'errorMessage' => 'The parameter is invalid. Please check again.', - ], + ['errorCode' => 'ParameterError', 'errorMessage' => 'The parameter is invalid. Please check again.', 'description' => '参数错误，请检查参数值'], ], 403 => [ - [ - 'errorCode' => 'AuthFailed', - 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', - ], + ['errorCode' => 'AuthFailed', 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', 'description' => '授权失败，请检查RAM权限配置'], ], 408 => [ - [ - 'errorCode' => 'Timeout', - 'errorMessage' => 'The request has timed out.', - ], + ['errorCode' => 'Timeout', 'errorMessage' => 'The request has timed out.', 'description' => '请求超时，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'The service is unavailable.', - ], + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'The service is unavailable.', 'description' => '服务不可用，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"B352CD68-C847-5C48-BE68-3F266356FDD7\\",\\n \\"Data\\": {\\n \\"Thresholds\\": [\\n 0\\n ],\\n \\"RectBList\\": [\\n 0\\n ],\\n \\"Confidence\\": 88.4831771850586,\\n \\"RectAList\\": [\\n 0\\n ],\\n \\"QualityScoreA\\": 99.65772247314453,\\n \\"QualityScoreB\\": 98.01177978515625,\\n \\"MessageTips\\": \\"imageB quality score less threshold\\",\\n \\"IsMaskA\\": 0,\\n \\"IsMaskB\\": 0,\\n \\"LandmarksAList\\": [\\n 0\\n ],\\n \\"LandmarksBList\\": [\\n 0\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n B352CD68-C847-5C48-BE68-3F266356FDD7\\n \\n 61\\n 69\\n 75\\n 169\\n 48\\n 125\\n 162\\n 88.4831771850586\\n 157\\n 82\\n 147\\n 188\\n 99.65772247314453\\n 98.01177978515625\\n 0\\n 0\\n 201\\n 146\\n 266\\n 159\\n 222\\n 190\\n 187\\n 208\\n 255\\n 219\\n 199\\n 115\\n 248\\n 109\\n 215\\n 146\\n 206\\n 167\\n 260\\n 162\\n \\n","errorExample":""}]', - 'title' => '人脸比对', + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"1C709078-8886-4C91-AEDE-4E04EED0A689\\",\\n \\"Data\\": {\\n \\"PersonNumber\\": 6\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n 1C709078-8886-4C91-AEDE-4E04EED0A689\\n \\n 6\\n \\n","errorExample":""}]', + 'title' => '人体计数', + 'summary' => '本文为您介绍人体计数DetectBodyCount的语法及示例。', 'description' => '## 功能描述'."\n" - .'人脸比对1:1能力基于您输入的两张图片，分别挑选两张图片中的最大人脸进行比较，判断是否为同一人。'."\n" - .'- 两张人脸图片对比：比对两张图片中人脸的相似度，返回这两个人脸的矩形框坐标、人脸五点关键点坐标、比对的置信度，以及不同误识率的置信度阈值。'."\n" - .'- 支持多种图片类型：支持生活照、证件照、身份证芯片照、带网纹照等类型的人脸对比。'."\n" - ."\n" - .'关于该接口功能的示例图如下：'."\n" - .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20221227/ghxo/CompareFace.png" width="500)'."\n" + .'人体计数能力可以检测输入图片中人体的个数。'."\n" ."\n" .'> - 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" - .'- 当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击[立即试用](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=CompareFace)对该能力进行更直观试用以及在线购买。'."\n" + .'- 当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击[立即试用](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=DetectBodyCount)对该能力进行更直观试用以及在线购买。'."\n" .'- 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。'."\n" ."\n" - .'## 应用场景'."\n" - .'- 金融业务：比对用户身份证照片和现场拍摄的已获授权的照片，判断用户信息真实性，可提供快速安全的身份核验流程，适用于互联网远程开户、刷脸支付等金融业务。'."\n" - .'- 员工考勤：无接触式刷脸考勤，疫情防控场景下企业考勤首选，且能有效防止代打卡等作弊行为。'."\n" - .'- 公共服务：客户直接刷脸办理业务，通过人脸比对识别身份信息，减少身份证查验、复印存档等环节，提高公共服务窗口办理业务的效率。'."\n" - .'- 酒店自助入住：住客刷脸自助办理入住，将现场授权获取的照片，与身份证提取的照片进行1:1比对，确保住客身份的真实性的同时，减少人工核查和服务成本，向住客提供便捷的入住体验。'."\n" - ."\n" - .'## 特色优势'."\n" - .'- 高精度识别： 人脸检测识别算法精度处于业内领先水平。'."\n" - .'- 平台服务稳定：提供在高并发、大流量下的毫秒级识别响应和保障。'."\n" - .'- 关键点精准定位：支持眼睛、鼻子、嘴部五官位置的高精度精准定位。'."\n" - .'- 简单易用：可直接调用的 API 接口，服务简单易用，易被集成，兼容性强。'."\n" - ."\n" .'## 接入指引'."\n" .'1. 注册阿里云账号：打开[阿里云官网](https://www.aliyun.com)，在阿里云官网右上角，单击**立即注册**，按照操作提示完成账号注册。'."\n" .'2. 开通能力：请确保您已开通[人脸人体服务](https://vision.aliyun.com/facebody)，若未开通服务请[立即开通](https://common-buy.aliyun.com/?commodityCode=viapi_facebody_public_cn#/open)。'."\n" + ."\n" .'> 本能力支持企业或个人认证用户开通。更多实名认证操作信息，请参见[实名认证](https://help.aliyun.com/knowledge_list/37170.html)。'."\n" ."\n" .'3. 创建AccessKey：请确保您已[创建AccessKey](~~175144~~)，如果您使用的是子账号AccessKey，您需要给子账号赋予AliyunVIAPIFullAccess权限，具体操作，请参见[RAM授权](~~145025~~)。'."\n" - .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/facebody/2019-12-30/CompareFace?lang=JAVA&sdkStyle=dara¶ms=%7B%22ImageURLA%22%3A%22http%3A%2F%2Fviapi-test.oss-cn-shanghai.aliyuncs.com%2Fviapi-3.0domepic%2Ffacebody%2FCompareFace%2FCompareFace-right1.png%22%2C%22ImageURLB%22%3A%22http%3A%2F%2Fviapi-test.oss-cn-shanghai.aliyuncs.com%2Fviapi-3.0domepic%2Ffacebody%2FCompareFace%2FCompareFace-left1.png%22%7D&tab=DEMO)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" + .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/facebody/2019-12-30/DetectBodyCount?lang=JAVA&sdkStyle=old¶ms=%7B%22ImageURL%22%3A%22http%3A%2F%2Fviapi-test.oss-cn-shanghai.aliyuncs.com%2Fviapi-3.0domepic%2Ffacebody%2FDetectBodyCount%2FDetectBodyCount1.jpg%22%7D&tab=DEMO)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" .'5. 开发接入步骤：'."\n" .'- 在[SDK总览](~~145033~~)中选择您要接入使用的SDK语言。'."\n" .'- 在对应语言的SDK文档中找到AI类目为人脸人体（facebody）的SDK包进行安装。'."\n" .'- 参考文档中提供的示例代码进行适当修改后调用。'."\n" ."\n" - .'6. 示例代码：该能力常用语言的示例代码，请参见[人脸比对1:1示例代码](~~465557~~)。'."\n" + .'6. 示例代码：该能力常用语言的示例代码，请参见[人体计数示例代码](~~478769~~)。'."\n" ."\n" .'7. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" .'- [Web前端直接调用](~~467779~~)'."\n" @@ -2915,41 +2221,46 @@ .'- [iOS端直接调用](~~467782~~)'."\n" ."\n" .'## 输入限制'."\n" - .'- 图像格式：JPEG、JPG、PNG、BMP、WEBP。'."\n" - .'- 图像大小：不超过5 MB。'."\n" - .'- 图像分辨率：大于32×32像素，小于4096×4096像素，人脸占比不低于64×64像素。'."\n" + ."\n" + .'- 图像格式：JPEG、JPG、BMP、PNG。'."\n" + .'- 图像大小：不超过3 MB。'."\n" .'- URL地址中不能包含中文字符。'."\n" - .'- 可使用URL与Base64编码字符串混合输入。例如：输入ImageURLA和ImageDataB的值，不输入ImageURLB和ImageDataA的值。'."\n" - .'> 当图像分辨率超过最大限制时，请先将图片进行缩放，调整图片大小，具体请参见[图片缩放](~~44688~~)。'."\n" ."\n" .'## 计费说明'."\n" - .'关于人脸比对的计费方式及报价，详情请参见[计费介绍](~~184049~~)。'."\n" - .'> 下方调试接口为付费接口，如需免费体验调试请前往[体验中心](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=CompareFace)。', + .'关于人体计数的计费方式及报价，请参见[计费介绍](~~184049~~)。'."\n" + ."\n" + .'> 下方调试接口为付费接口，如需免费体验调试请前往[体验中心](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=DetectBodyCount)。', 'requestParamsDescription' => ' ', 'responseParamsDescription' => '## SDK参考'."\n" - .'阿里云视觉AI人脸人体类目下的人脸比对1:1能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。'."\n" + .'阿里云视觉AI人脸人体类目下的人体计数能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。'."\n" ."\n" .'## 示例代码'."\n" - .'该能力常用语言的示例代码，请参见[人脸比对1:1示例代码](~~465557~~)。', + .'该能力常用语言的示例代码，请参见[人体计数示例代码](~~478769~~)。'."\n", 'extraInfo' => '## 错误码'."\n" - .'关于人脸比对1:1的错误码，详情请参见[常见错误码](~~146756~~)。'."\n" - ."\n" - .'## 开源模型体验'."\n" - .'更多开源免费模型体验及下载，详见魔搭社区：[人脸识别OOD模型](https://modelscope.cn/models/damo/cv_ir_face-recognition-ood_rts/summary)、[ArcFace人脸识别模型](https://modelscope.cn/models/damo/cv_ir50_face-recognition_arcface/summary)、[IR人脸识别模型FRIR](https://modelscope.cn/models/damo/cv_manual_face-recognition_frir/summary)、[口罩人脸识别模型FRFM-large](https://modelscope.cn/models/damo/cv_manual_face-recognition_frfm/summary)、[口罩人脸识别模型FaceMask](https://modelscope.cn/models/damo/cv_resnet_face-recognition_facemask/summary)。'."\n" - ."\n" + .'关于人体计数的错误码，详情请参见[常见错误码](~~146756~~)。'."\n" + ."\n\n" .'## 安全声明'."\n" + ."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" - .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。'."\n" - .'- 平台不存储用户在使用服务过程中涉及的原始人脸图片或文件信息。', - ], - 'DetectFace' => [ - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'http', - 'https', + .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-facebody:DetectBodyCount', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + ], + 'DetectCelebrity' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -2957,63 +2268,169 @@ ], 'operationType' => 'read', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'none', - ], + 'systemTags' => [], 'parameters' => [ [ 'name' => 'ImageURL', 'in' => 'formData', - 'schema' => [ - 'description' => '图像URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。', - 'type' => 'string', - 'required' => true, - 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/DetectFace/DetectFace1.png', - 'isFileTransferUrl' => true, - ], - ], - [ - 'name' => 'Landmark', - 'in' => 'formData', - 'schema' => [ - 'description' => '是否需要返回人脸的特征点定位，取值true或false。', - 'type' => 'boolean', - 'required' => false, - 'example' => 'true', - ], - ], - [ - 'name' => 'Quality', - 'in' => 'formData', - 'schema' => [ - 'description' => '是否需要返回人脸质量，取值true或false。', - 'type' => 'boolean', - 'required' => false, - 'example' => 'true', - ], + 'schema' => ['description' => '图像URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。', 'type' => 'string', 'required' => true, 'example' => 'https://viapi-oss.oss-cn-shanghai.aliyuncs.com/doc/facebody/xxx.jpg', 'isFileTransferUrl' => true], ], - [ - 'name' => 'Pose', - 'in' => 'formData', + ], + 'responses' => [ + 200 => [ 'schema' => [ - 'description' => '是否需要返回人脸的姿态，取值true或false。', - 'type' => 'boolean', - 'required' => false, - 'example' => 'true', - ], - ], - [ + 'description' => '1', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '4E92C0D4-BB0F-4F25-AD13-E87D02FAA205'], + 'Data' => [ + 'description' => '返回的结果数据内容。', + 'type' => 'object', + 'properties' => [ + 'FaceRecognizeResults' => [ + 'description' => '识别结果数据。', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'FaceBoxes' => [ + 'description' => '1', + 'type' => 'array', + 'items' => ['description' => '人脸框坐标信息。格式为`[x，y，width，height]`。x和y为人脸框的左上角坐标，width和height为人脸框的宽和高。x、y、width和height四个值均为人脸框与输入图像宽和高的等比值。', 'type' => 'number', 'format' => 'float', 'example' => '[0.285,0.202,0.534,0.721]'], + ], + 'Name' => ['description' => '识别出的人物名称。', 'type' => 'string', 'example' => '张三'], + ], + 'description' => '', + ], + ], + 'Width' => ['description' => '图像宽度，单位像素。', 'type' => 'integer', 'format' => 'int32', 'example' => '1000'], + 'Height' => ['description' => '图像高度，单位像素。', 'type' => 'integer', 'format' => 'int32', 'example' => '1000'], + ], + ], + ], + ], + ], + ], + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'ParameterError', 'errorMessage' => 'The parameter is invalid. Please check again.', 'description' => '参数错误，请检查参数值'], + ], + 403 => [ + ['errorCode' => 'AuthFailed', 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', 'description' => '授权失败，请检查RAM权限配置'], + ], + 408 => [ + ['errorCode' => 'Timeout', 'errorMessage' => 'The request has timed out.', 'description' => '请求超时，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], + ], + 503 => [ + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'The service is unavailable.', 'description' => '服务不可用，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], + ], + ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"4E92C0D4-BB0F-4F25-AD13-E87D02FAA205\\",\\n \\"Data\\": {\\n \\"FaceRecognizeResults\\": [\\n {\\n \\"FaceBoxes\\": [\\n 0\\n ],\\n \\"Name\\": \\"张三\\"\\n }\\n ],\\n \\"Width\\": 1000,\\n \\"Height\\": 1000\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n 4E92C0D4-BB0F-4F25-AD13-E87D02FAA205\\n \\n \\n 0.285\\n 0.202\\n 0.534\\n 0.721\\n 张三\\n \\n 1000\\n 1000\\n \\n","errorExample":""}]', + 'title' => '明星识别', + 'summary' => '本文介绍明星识别DetectCelebrity的语法及示例。', + 'description' => '## 功能描述'."\n" + .'明星识别能力可以识别图像中的明星人物。可以识别超过2.7万个明星人物。'."\n" + ."\n" + .'> - 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" + .'- 当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击[立即试用](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=DetectCelebrity)对该能力进行更直观试用以及在线购买。'."\n" + .'- 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。'."\n" + ."\n" + .'## 接入指引'."\n" + .'1. 注册阿里云账号：打开[阿里云官网](https://www.aliyun.com)，在阿里云官网右上角，单击**立即注册**，按照操作提示完成账号注册。'."\n" + .'2. 开通能力：'."\n" + .'- 请确保您已开通[人脸人体服务](https://vision.aliyun.com/facebody)，若未开通服务请[立即开通](https://common-buy.aliyun.com/?commodityCode=viapi_facebody_public_cn#/open)。'."\n" + .'- 开通服务后请[提交申请](https://vision.console.aliyun.com/cn-shanghai/applyopen/facebody/DetectCelebrity)，申请通过后方可使用。'."\n" + ."\n" + .'>'."\n" + .'本能力仅限企业认证用户开通。更多实名认证操作信息，请参见[实名认证](https://help.aliyun.com/knowledge_list/37170.html)。'."\n" + .'>'."\n" + ."\n" + .'3. 创建AccessKey：请确保您已[创建AccessKey](~~175144~~)，如果您使用的是子账号AccessKey，您需要给子账号赋予AliyunVIAPIFullAccess权限，具体操作，请参见[RAM授权](~~145025~~)。'."\n" + .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/facebody/2019-12-30/DetectCelebrity?lang=JAVA&sdkStyle=dara¶ms=%7B%22ImageURL%22%3A%22%22%7D&tab=DEMO)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" + .'5. 开发接入步骤：'."\n" + .'- 在[SDK总览](~~145033~~)中选择您要接入使用的SDK语言。'."\n" + .'- 在对应语言的SDK文档中找到AI类目为人脸人体（facebody）的SDK包进行安装。'."\n" + .'- 参考文档中提供的示例代码进行适当修改后调用。'."\n" + ."\n" + .'6. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" + .'- [Web前端直接调用](~~467779~~)'."\n" + .'- [小程序场景下直接调用](~~467780~~)'."\n" + .'- [Android端直接调用](~~467781~~)'."\n" + .'- [iOS端直接调用](~~467782~~)'."\n" + ."\n" + .'## 输入限制'."\n" + .'- 图像格式：JPEG、JPG、PNG。'."\n" + .'- 图像大小：不超过3 MB。'."\n" + .'- URL地址不能包含中文字符。'."\n" + ."\n" + .'## 计费说明'."\n" + .'关于明星识别的计费方式及报价，请参见[计费介绍](~~184049~~)。'."\n" + ."\n" + .'> 下方调试接口为付费接口，如需免费体验调试请前往[体验中心](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=DetectCelebrity)。', + 'requestParamsDescription' => ' ', + 'responseParamsDescription' => '## SDK参考'."\n" + .'阿里云视觉AI人脸人体类目下的明星识别能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。', + 'extraInfo' => '## 错误码'."\n" + .'关于明星识别的错误码，详情请参见[常见错误码](~~146756~~)。'."\n" + ."\n" + .'## 开源模型体验'."\n" + .'更多开源免费模型体验及下载，详见魔搭社区：[人脸识别OOD模型](https://modelscope.cn/models/damo/cv_ir_face-recognition-ood_rts/summary)、[ArcFace人脸识别模型](https://modelscope.cn/models/damo/cv_ir50_face-recognition_arcface/summary)、[IR人脸识别模型FRIR](https://modelscope.cn/models/damo/cv_manual_face-recognition_frir/summary)、[口罩人脸识别模型FRFM-large](https://modelscope.cn/models/damo/cv_manual_face-recognition_frfm/summary)、[口罩人脸识别模型FaceMask](https://modelscope.cn/models/damo/cv_resnet_face-recognition_facemask/summary)。'."\n" + ."\n\n" + .'## 安全声明'."\n" + .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" + .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。'."\n" + .'- 平台不存储用户在使用服务过程中涉及的原始人脸图片或文件信息。', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-facebody:DetectCelebrity', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + ], + ], + 'DetectFace' => [ + 'methods' => ['post'], + 'schemes' => ['http', 'https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'read', + 'deprecated' => false, + 'systemTags' => ['operationType' => 'none'], + 'parameters' => [ + [ + 'name' => 'ImageURL', + 'in' => 'formData', + 'schema' => ['description' => '图像URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。', 'type' => 'string', 'required' => true, 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/DetectFace/DetectFace1.png', 'isFileTransferUrl' => true], + ], + [ + 'name' => 'Landmark', + 'in' => 'formData', + 'schema' => ['description' => '是否需要返回人脸的特征点定位，取值true或false。', 'type' => 'boolean', 'required' => false, 'example' => 'true'], + ], + [ + 'name' => 'Quality', + 'in' => 'formData', + 'schema' => ['description' => '是否需要返回人脸质量，取值true或false。', 'type' => 'boolean', 'required' => false, 'example' => 'true'], + ], + [ + 'name' => 'Pose', + 'in' => 'formData', + 'schema' => ['description' => '是否需要返回人脸的姿态，取值true或false。', 'type' => 'boolean', 'required' => false, 'example' => 'true'], + ], + [ 'name' => 'MaxFaceNumber', 'in' => 'formData', - 'schema' => [ - 'description' => '设置图片中人脸的最大返回数量，取值范围1~30。若想返回多个人脸检测结果，请正确设置。默认按返回参数FaceProbabilityList进行降序排列。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'maximum' => '40', - 'minimum' => '1', - 'example' => '1', - ], + 'schema' => ['description' => '设置图片中人脸的最大返回数量，取值范围1~30。若想返回多个人脸检测结果，请正确设置。默认按返回参数FaceProbabilityList进行降序排列。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'maximum' => '40', 'minimum' => '1', 'example' => '1'], ], ], 'responses' => [ @@ -3022,11 +2439,7 @@ 'description' => '1', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '26B5334B-FD8A-5994-A1DA-3CA8F7B25676', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '26B5334B-FD8A-5994-A1DA-3CA8F7B25676'], 'Data' => [ 'description' => '返回的结果数据内容。', 'type' => 'object', @@ -3034,83 +2447,44 @@ 'FaceProbabilityList' => [ 'description' => '1', 'type' => 'array', - 'items' => [ - 'description' => '截图中包含人脸的概率，取值范围0~1。如有多个人脸，则依次返回。例如有两个人脸则返回`[face_prob1, face_prob2]`。图像中人脸区域分辨率越大，人脸越清晰，人脸正视，对应的该值越大。', - 'type' => 'number', - 'format' => 'float', - 'example' => '0.96', - ], + 'items' => ['description' => '截图中包含人脸的概率，取值范围0~1。如有多个人脸，则依次返回。例如有两个人脸则返回`[face_prob1, face_prob2]`。图像中人脸区域分辨率越大，人脸越清晰，人脸正视，对应的该值越大。', 'type' => 'number', 'format' => 'float', 'example' => '0.96'], ], 'Pupils' => [ 'description' => '1', 'type' => 'array', - 'items' => [ - 'description' => '左右两个瞳孔的中心点坐标和半径，每个人脸6个浮点数，顺序为`[left_iris_cenpt.x, left_iris_cenpt.y, left_iris_radius, right_iris_cenpt.x, right_iris_cenpt.y, right_iris_radis]`。', - 'type' => 'number', - 'format' => 'double', - 'example' => '[417.83, 226.09, 8.15, 517.46, 231.53, 8.15]', - ], + 'items' => ['description' => '左右两个瞳孔的中心点坐标和半径，每个人脸6个浮点数，顺序为`[left_iris_cenpt.x, left_iris_cenpt.y, left_iris_radius, right_iris_cenpt.x, right_iris_cenpt.y, right_iris_radis]`。', 'type' => 'number', 'format' => 'double', 'example' => '[417.83, 226.09, 8.15, 517.46, 231.53, 8.15]'], ], 'FaceRectangles' => [ 'description' => '1', 'type' => 'array', - 'items' => [ - 'description' => '返回人脸矩形框，分别是`[left, top, width, height]`。如有多个人脸，则依次顺延，返回矩形框。例如有两个人脸则返回`[left1, top1, width1, height1, left2, top2, width2, height2]`。'."\n" - .'left-top: 表示以图片左上角为坐标原点，目标框所对应的左上角点位置（x,y），表示框的第一个点距离图片左边界x像素，距离上边界y个像素。'."\n" - .'width-height：表示目标框的宽和高。'."\n" - .'目标框面积为width*height，目标框右下角坐标为（left+width,top+height）。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '[358, 141, 207, 255]', - ], - ], - 'FaceCount' => [ - 'description' => '检测出的人脸个数。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', + 'items' => ['description' => '返回人脸矩形框，分别是`[left, top, width, height]`。如有多个人脸，则依次顺延，返回矩形框。例如有两个人脸则返回`[left1, top1, width1, height1, left2, top2, width2, height2]`。'."\n" + .'left-top: 表示以图片左上角为坐标原点，目标框所对应的左上角点位置（x,y），表示框的第一个点距离图片左边界x像素，距离上边界y个像素。'."\n" + .'width-height：表示目标框的宽和高。'."\n" + .'目标框面积为width*height，目标框右下角坐标为（left+width,top+height）。', 'type' => 'integer', 'format' => 'int32', 'example' => '[358, 141, 207, 255]'], ], + 'FaceCount' => ['description' => '检测出的人脸个数。', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], 'PoseList' => [ 'description' => '1', 'type' => 'array', - 'items' => [ - 'description' => '返回人脸姿态角度，格式为`[yaw, pitch, roll]`。如有多个人脸，则依次顺延。'."\n" - ."\n" - .'- yaw为左右角度，取值范围-90~90。'."\n" - ."\n" - .'- pitch为上下角度，取值范围-90~90。'."\n" - ."\n" - .'- roll为平面旋转角度，取值范围-180~180。', - 'type' => 'number', - 'format' => 'float', - 'example' => '[5.02, -3.95, 2.41]', - ], + 'items' => ['description' => '返回人脸姿态角度，格式为`[yaw, pitch, roll]`。如有多个人脸，则依次顺延。'."\n" + ."\n" + .'- yaw为左右角度，取值范围-90~90。'."\n" + ."\n" + .'- pitch为上下角度，取值范围-90~90。'."\n" + ."\n" + .'- roll为平面旋转角度，取值范围-180~180。', 'type' => 'number', 'format' => 'float', 'example' => '[5.02, -3.95, 2.41]'], ], 'Landmarks' => [ 'description' => '1', 'type' => 'array', - 'items' => [ - 'description' => '人脸特征点定位结果，每个人脸返回一组特征点位置，表示方式为`（x0, y0, x1, y1, ……）`；如有多个人脸，则依次顺延，返回定位浮点数。', - 'type' => 'number', - 'format' => 'float', - 'example' => '[381.1, 201.72, 448.09, 205.17, 415.19, 191.2, 415.28, 201.64, 391.35, 196.03, 403.15, 191.57, 426.94, 194.07, 438.42, 197.65, ......]', - ], + 'items' => ['description' => '人脸特征点定位结果，每个人脸返回一组特征点位置，表示方式为`（x0, y0, x1, y1, ……）`；如有多个人脸，则依次顺延，返回定位浮点数。', 'type' => 'number', 'format' => 'float', 'example' => '[381.1, 201.72, 448.09, 205.17, 415.19, 191.2, 415.28, 201.64, 391.35, 196.03, 403.15, 191.57, 426.94, 194.07, 438.42, 197.65, ......]'], ], 'LandmarkScore' => [ 'type' => 'array', - 'items' => [ - 'description' => '关键点检测综合分值，取值范围(0, 100]，推荐采用85的阈值（您可以按实际应用场景判断设置阈值与否及相应阈值大小），该分值越大，对应脸的关键点的质量越好，越有利于识别，可用来筛选人脸样本。', - 'type' => 'number', - 'format' => 'float', - 'example' => '95.89', - ], - ], - 'LandmarkCount' => [ - 'description' => '人脸特征点数目，目前固定为105点。依次为：眉毛24点，眼睛32点，鼻子6点，嘴巴34点，外轮廓9点。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '105', + 'items' => ['description' => '关键点检测综合分值，取值范围(0, 100]，推荐采用85的阈值（您可以按实际应用场景判断设置阈值与否及相应阈值大小），该分值越大，对应脸的关键点的质量越好，越有利于识别，可用来筛选人脸样本。', 'type' => 'number', 'format' => 'float', 'example' => '95.89'], + 'description' => '', ], + 'LandmarkCount' => ['description' => '人脸特征点数目，目前固定为105点。依次为：眉毛24点，眼睛32点，鼻子6点，嘴巴34点，外轮廓9点。', 'type' => 'integer', 'format' => 'int32', 'example' => '105'], 'Qualities' => [ 'description' => '人脸质量情况，分数越高表示越有利于识别。', 'type' => 'object', @@ -3118,82 +2492,42 @@ 'ScoreList' => [ 'description' => '1', 'type' => 'array', - 'items' => [ - 'description' => '质量综合分数，分数越高越有利于识别，取值范围\\(0,100]。如有多张人脸，则依次返回。在识别时，推荐设置阈值大于等于85（您可以按实际应用场景判断设置阈值与否及相应阈值大小），大于85代表图片综合质量越高，小于85代表图片综合质量越低。', - 'type' => 'number', - 'format' => 'float', - 'example' => '99.92', - ], + 'items' => ['description' => '质量综合分数，分数越高越有利于识别，取值范围\\(0,100]。如有多张人脸，则依次返回。在识别时，推荐设置阈值大于等于85（您可以按实际应用场景判断设置阈值与否及相应阈值大小），大于85代表图片综合质量越高，小于85代表图片综合质量越低。', 'type' => 'number', 'format' => 'float', 'example' => '99.92'], ], 'BlurList' => [ 'description' => '1', 'type' => 'array', - 'items' => [ - 'description' => '人脸模糊度对识别的影响分数，分数越高越有利于识别，取值范围\\(0,100]。如有多个人脸，则依次顺延。在识别时，推荐设置阈值大于等于85（您可以按实际应用场景判断设置阈值与否及相应阈值大小），大于85代表图片模糊的概率越低，小于85代表图片模糊的概率越高。', - 'type' => 'number', - 'format' => 'float', - 'example' => '99.21', - ], + 'items' => ['description' => '人脸模糊度对识别的影响分数，分数越高越有利于识别，取值范围\\(0,100]。如有多个人脸，则依次顺延。在识别时，推荐设置阈值大于等于85（您可以按实际应用场景判断设置阈值与否及相应阈值大小），大于85代表图片模糊的概率越低，小于85代表图片模糊的概率越高。', 'type' => 'number', 'format' => 'float', 'example' => '99.21'], ], 'FnfList' => [ 'description' => '1', 'type' => 'array', - 'items' => [ - 'description' => '目标是否为人脸及其对识别的影响分数，分数越高越有利于识别，取值范围\\(0,100]。如有多个人脸，则依次顺延。在识别时，推荐设置阈值大于等于85（您可以按实际应用场景判断设置阈值与否及相应阈值大小），大于85代表图片是人脸的概率越高，小于85代表图片是人脸的概率越低。', - 'type' => 'number', - 'format' => 'float', - 'example' => '100', - ], + 'items' => ['description' => '目标是否为人脸及其对识别的影响分数，分数越高越有利于识别，取值范围\\(0,100]。如有多个人脸，则依次顺延。在识别时，推荐设置阈值大于等于85（您可以按实际应用场景判断设置阈值与否及相应阈值大小），大于85代表图片是人脸的概率越高，小于85代表图片是人脸的概率越低。', 'type' => 'number', 'format' => 'float', 'example' => '100'], ], 'GlassList' => [ 'description' => '1', 'type' => 'array', - 'items' => [ - 'description' => '眼镜等上半脸遮挡对识别的影响分数，分数越高越有利于识别，取值范围\\(0,100]。如有多个人脸，则依次顺延。在识别时，推荐设置阈值大于等于85（您可以按实际应用场景判断设置阈值与否及相应阈值大小），大于85代表戴眼镜的概率越低，小于85代表戴眼镜的概率越高。', - 'type' => 'number', - 'format' => 'float', - 'example' => '100', - ], + 'items' => ['description' => '眼镜等上半脸遮挡对识别的影响分数，分数越高越有利于识别，取值范围\\(0,100]。如有多个人脸，则依次顺延。在识别时，推荐设置阈值大于等于85（您可以按实际应用场景判断设置阈值与否及相应阈值大小），大于85代表戴眼镜的概率越低，小于85代表戴眼镜的概率越高。', 'type' => 'number', 'format' => 'float', 'example' => '100'], ], 'IlluList' => [ 'description' => '1', 'type' => 'array', - 'items' => [ - 'description' => '光照对识别的影响分数，分数越高越有利于识别，取值范围\\(0,100]。如有多个人脸，则依次顺延。在识别时，推荐设置阈值大于等于85（您可以按实际应用场景判断设置阈值与否及相应阈值大小），大于85代表图片光照好的概率越高，小于85代表图片光照好的概率越低。', - 'type' => 'number', - 'format' => 'float', - 'example' => '100', - ], + 'items' => ['description' => '光照对识别的影响分数，分数越高越有利于识别，取值范围\\(0,100]。如有多个人脸，则依次顺延。在识别时，推荐设置阈值大于等于85（您可以按实际应用场景判断设置阈值与否及相应阈值大小），大于85代表图片光照好的概率越高，小于85代表图片光照好的概率越低。', 'type' => 'number', 'format' => 'float', 'example' => '100'], ], 'MaskList' => [ 'description' => '1', 'type' => 'array', - 'items' => [ - 'description' => '口罩等下半脸遮挡对识别的影响分数，分数越高越有利于识别，取值范围\\(0,100]。如有多个人脸，则依次顺延。在识别时，推荐设置阈值大于等于85（您可以按实际应用场景判断设置阈值与否及相应阈值大小），大于85代表戴口罩概率越低，小于85代表戴口罩概率越高。', - 'type' => 'number', - 'format' => 'float', - 'example' => '99.53', - ], + 'items' => ['description' => '口罩等下半脸遮挡对识别的影响分数，分数越高越有利于识别，取值范围\\(0,100]。如有多个人脸，则依次顺延。在识别时，推荐设置阈值大于等于85（您可以按实际应用场景判断设置阈值与否及相应阈值大小），大于85代表戴口罩概率越低，小于85代表戴口罩概率越高。', 'type' => 'number', 'format' => 'float', 'example' => '99.53'], ], 'NoiseList' => [ 'description' => '1', 'type' => 'array', - 'items' => [ - 'description' => '图片噪声对识别的影响分数，分数越高越有利于识别，取值范围\\(0,100]。如有多个人脸，则依次顺延。在识别时，推荐设置阈值大于等于85（您可以按实际应用场景判断设置阈值与否及相应阈值大小），大于85代表图片有噪声的概率越低，小于85代表图片有噪声的概率越高。', - 'type' => 'number', - 'format' => 'float', - 'example' => '99.74', - ], + 'items' => ['description' => '图片噪声对识别的影响分数，分数越高越有利于识别，取值范围\\(0,100]。如有多个人脸，则依次顺延。在识别时，推荐设置阈值大于等于85（您可以按实际应用场景判断设置阈值与否及相应阈值大小），大于85代表图片有噪声的概率越低，小于85代表图片有噪声的概率越高。', 'type' => 'number', 'format' => 'float', 'example' => '99.74'], ], 'PoseList' => [ 'description' => '1', 'type' => 'array', - 'items' => [ - 'description' => '姿态对识别的影响分数，分数越高越有利于识别，取值范围\\(0,100]。如有多个人脸，则依次顺延。在识别时，推荐设置阈值大于等于85（您可以按实际应用场景判断设置阈值与否及相应阈值大小），大于85代表人脸姿态正面的概率越高，小于85代表人脸姿态正面的概率越低。', - 'type' => 'number', - 'format' => 'float', - 'example' => '100', - ], + 'items' => ['description' => '姿态对识别的影响分数，分数越高越有利于识别，取值范围\\(0,100]。如有多个人脸，则依次顺延。在识别时，推荐设置阈值大于等于85（您可以按实际应用场景判断设置阈值与否及相应阈值大小），大于85代表人脸姿态正面的概率越高，小于85代表人脸姿态正面的概率越低。', 'type' => 'number', 'format' => 'float', 'example' => '100'], ], ], ], @@ -3205,28 +2539,16 @@ ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'ParameterError', - 'errorMessage' => 'The parameter is invalid. Please check again.', - ], + ['errorCode' => 'ParameterError', 'errorMessage' => 'The parameter is invalid. Please check again.', 'description' => '参数错误，请检查参数值'], ], 403 => [ - [ - 'errorCode' => 'AuthFailed', - 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', - ], + ['errorCode' => 'AuthFailed', 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', 'description' => '授权失败，请检查RAM权限配置'], ], 408 => [ - [ - 'errorCode' => 'Timeout', - 'errorMessage' => 'The request has timed out.', - ], + ['errorCode' => 'Timeout', 'errorMessage' => 'The request has timed out.', 'description' => '请求超时，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'The service is unavailable.', - ], + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'The service is unavailable.', 'description' => '服务不可用，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"26B5334B-FD8A-5994-A1DA-3CA8F7B25676\\",\\n \\"Data\\": {\\n \\"FaceProbabilityList\\": [\\n 0.96\\n ],\\n \\"Pupils\\": [\\n 0\\n ],\\n \\"FaceRectangles\\": [\\n 0\\n ],\\n \\"FaceCount\\": 1,\\n \\"PoseList\\": [\\n 0\\n ],\\n \\"Landmarks\\": [\\n 0\\n ],\\n \\"LandmarkScore\\": [\\n 95.89\\n ],\\n \\"LandmarkCount\\": 105,\\n \\"Qualities\\": {\\n \\"ScoreList\\": [\\n 99.92\\n ],\\n \\"BlurList\\": [\\n 99.21\\n ],\\n \\"FnfList\\": [\\n 100\\n ],\\n \\"GlassList\\": [\\n 100\\n ],\\n \\"IlluList\\": [\\n 100\\n ],\\n \\"MaskList\\": [\\n 99.53\\n ],\\n \\"NoiseList\\": [\\n 99.74\\n ],\\n \\"PoseList\\": [\\n 100\\n ]\\n }\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n 26B5334B-FD8A-5994-A1DA-3CA8F7B25676\\n \\n 0.96\\n 417.83\\n 226.09\\n 8.15\\n 517.46\\n 231.53\\n 8.15\\n 358\\n 141\\n 207\\n 255\\n 1\\n 5.02\\n -3.95\\n 2.41\\n 381.1\\n 201.72\\n 448.09\\n 205.17\\n 415.19\\n 191.2\\n 415.28\\n 201.64\\n 391.35\\n 196.03\\n 403.15\\n 191.57\\n 426.94\\n 194.07\\n 438.42\\n 197.65\\n 95.89\\n 105\\n \\n 99.92\\n 99.21\\n 100\\n 100\\n 100\\n 99.53\\n 99.74\\n 100\\n \\n \\n","errorExample":""}]', @@ -3305,22 +2627,30 @@ .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。'."\n" .'- 平台不存储用户在使用服务过程中涉及的原始人脸图片或文件信息。', - ], - 'DetectLivingFace' => [ - 'summary' => '本文为您介绍人脸活体检测DetectLivingFace的语法及示例。', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'http', - 'https', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'viapi-facebody:DetectFace', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + ], + 'DetectInfraredLivingFace' => [ + 'summary' => '本文为您介绍红外人脸活体检测DetectInfraredLivingFace的语法及示例。', + 'methods' => ['post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [], 'parameters' => [ @@ -3329,29 +2659,17 @@ 'in' => 'formData', 'style' => 'repeatList', 'schema' => [ - 'description' => '输入人脸数据。', + 'description' => '待检测的图像URL地址数组。', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ - 'ImageURL' => [ - 'description' => '待检测的图像URL地址。JSON数组中的每个元素是一个图片检测任务结构体（image表）。最多支持10个元素，即同时最多对10张图片进行检测。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。'."\n" - ."\n" - .'> 对于该接口，系统会自动将OSS链接地址转成内网地址然后再下载文件，所以调用该接口并不会产生OSS流量计费。', - 'type' => 'string', - 'required' => false, - 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/DetectLivingFace/DetectLivingFace4.jpg', - 'isFileTransferUrl' => true, - ], - 'ImageData' => [ - 'description' => '图像Base64编码字符串。当与URL方式共存时，URL方式优先。'."\n" - .'文件的Base64编码处理操作，请参见[文件Base64处理](~~468191~~)。', - 'type' => 'string', - 'required' => false, - 'example' => '/9j/4AAQSkZJRgABAQAAAQABAAD/2****', - ], + 'ImageURL' => ['description' => '待检测的图像URL地址。JSON数组中的每个元素是一个图片检测任务结构体（image表）。最多支持10个元素，即同时最多对10张图片进行检测。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。'."\n" + ."\n" + .'> 对于该接口，系统会自动将OSS链接地址转成内网地址然后再下载文件，所以调用该接口并不会产生OSS流量计费。'."\n", 'type' => 'string', 'required' => true, 'example' => 'https://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/DetectInfraredLivingFace/DetectInfraredLivingFace.jpeg', 'isFileTransferUrl' => true], ], 'required' => false, + 'description' => '', ], 'required' => true, 'maxItems' => 10, @@ -3361,133 +2679,63 @@ 'responses' => [ 200 => [ 'schema' => [ - 'description' => '1', + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '2EEA0396-BD84-5729-B8BD-D60776FCEF2B', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => '68DF6EC7-3B1D-11EE-9FA7-1122F1AE92DD'], 'Data' => [ 'description' => '返回的结果数据内容。', 'type' => 'object', 'properties' => [ 'Elements' => [ - 'description' => '返回的元素。', + 'description' => '返回的结果数据内容。', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ - 'ImageURL' => [ - 'description' => '对应请求中的图像URL地址。', - 'type' => 'string', - 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/DetectLivingFace/DetectLivingFace4.jpg', - ], - 'TaskId' => [ - 'description' => '该检测任务的ID。', - 'type' => 'string', - 'example' => 'img1owc8WGskNm78OEAPJTZal-1****', - ], + 'FaceNumber' => ['description' => '单张图片检测到的人脸数量。如果没有检测到人脸，FaceNumber返回为0。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], + 'ImageURL' => ['description' => '对应请求中的图像URL地址。', 'type' => 'string', 'example' => 'http://viapi-demo.oss-cn-shanghai.aliyuncs.com/viapi-demo/images/SegmentCommonImage/segmentimage-src-hu.jpeg'], 'Results' => [ - 'description' => '返回结果。调用成功时返回结果中包含一个或多个元素。', + 'description' => '返回人脸坐标和活体结果。', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ - 'Suggestion' => [ - 'description' => '建议您执行的操作，取值范围如下：'."\n" - .'- pass：图片中的活体对象来自直接拍摄，无需进行其余操作。'."\n" - .'- review：图片中的活体对象可能来自翻拍，建议您确认后再进行操作。'."\n" - .'- block：图片中的活体对象大概率来自翻拍，建议您执行后续操作。'."\n" - .'如果未检测到人脸，则Suggestion返回为block。'."\n", - 'type' => 'string', - 'example' => 'review', - ], - 'Frames' => [ - 'description' => '**（该字段已废弃）**输入图像为长图（长宽比大于3:1）时，会把原图截成几张正常比例的图，frames保存从图像中裁剪出来的而且是翻拍命中的截图。', - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'Url' => [ - 'description' => '命中的截图。', - 'type' => 'string', - 'example' => 'http://aligreen-shanghai.oss-cn-shanghai.aliyuncs.com/prod/hammal/26210da42/28118541_TB1urBOQFXXXXbMXFXXXXXXXXXX-1442-257.png?Expires=1582703593&OSSAccessKeyId=H4sp5QfNbuDg****&Signature=%2B8iUkb5YjomYR8ujV2c8wMAavs****&x-oss-process=image%2Fcrop%2Cx_0%2Cw_288%2Fauto-orient%2C0', - ], - 'Rate' => [ - 'description' => '结果为该分类的概率，取值范围为\\[0.00,100.00]。取值越大，表示属于该分类的概率越大。'."\n" - .'如果未检测到人脸，则Rate返回为100。', - 'type' => 'number', - 'format' => 'float', - 'example' => '84.83', - ], - ], - ], - ], - 'Label' => [ - 'description' => '检测结果的分类，取值包括：'."\n" - .'- normal：活体照片'."\n" - .'- liveness：翻拍照片'."\n" - ."\n" - .'如果未检测到人脸，则Label返回为liveness。', - 'type' => 'string', - 'example' => 'liveness', - ], - 'Rate' => [ - 'description' => '结果为该分类的概率，取值范围为\\[0.00,100.00]。表示属于该分类的概率越大。', - 'type' => 'number', - 'format' => 'float', - 'example' => '76.22', - ], + 'Label' => ['description' => '检测结果的分类，取值包括：'."\n" + .'- normal：活体照片'."\n" + .'- liveness：翻拍照片'."\n" + ."\n" + .'如果没有检测到人脸，则Label返回为liveness。', 'type' => 'string', 'example' => 'liveness'], + 'Rate' => ['description' => '结果为该分类的概率，取值范围为\\[0.00-100.00]。取值越大表示属于该分类的概率越大。'."\n" + .'如果未检测到人脸，则Rate返回为100。', 'type' => 'number', 'format' => 'float', 'example' => '83.3848'], 'Rect' => [ - 'description' => '人脸检测框信息。', + 'description' => '人脸检测框信息。如果未检测到人脸，则Rect人脸检测坐标返回全为0。', 'type' => 'object', 'properties' => [ - 'Left' => [ - 'description' => '检测框左上角的点x坐标。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '20', - ], - 'Top' => [ - 'description' => '检测框左上角的点y坐标。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '30', - ], - 'Width' => [ - 'description' => '检测框宽度。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '50', - ], - 'Height' => [ - 'description' => '检测框高度。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '60', - ], + 'Height' => ['description' => '检测框高度。', 'type' => 'integer', 'format' => 'int64', 'example' => '20'], + 'Width' => ['description' => '检测框宽度。', 'type' => 'integer', 'format' => 'int64', 'example' => '30'], + 'Top' => ['description' => '检测框左上角的点y坐标。', 'type' => 'integer', 'format' => 'int64', 'example' => '50'], + 'Left' => ['description' => '检测框左上角的点x坐标。', 'type' => 'integer', 'format' => 'int64', 'example' => '60'], ], ], - 'MessageTips' => [ - 'description' => '提示信息。'."\n" - .'- 如输入模糊、遮挡或大角度等的人脸，则返回提示信息：`blurred, occluded or large angle face, please check.` '."\n" - .'- 如未检测到人脸，则返回提示信息：`no face detected, try again please.`', - 'type' => 'string', - 'example' => 'blurred, occluded or large angle face, please check.', - ], + 'Suggestion' => ['description' => '建议您执行的操作，取值范围如下：'."\n" + ."\n" + .'- pass：图片中的活体对象来自直接拍摄，无需进行其余操作。'."\n" + .'- review：图片中的活体对象可能为攻击样本，建议您确认后再进行操作。'."\n" + .'- block：图片中的活体对象大概率为攻击样本，建议您执行后续操作。'."\n" + ."\n" + .'如果未检测到人脸，则Suggestion返回为block。', 'type' => 'string', 'example' => 'review'], + 'MessageTips' => ['description' => '提示信息，纯文字描述。'."\n" + ."\n" + .'- `blurred, occluded or large angle face, please check.`：如输入模糊、遮挡或大角度等的人脸。'."\n" + .'- `no face detected, try again please.`：如没有检测到人脸。', 'type' => 'string', 'example' => 'blurred, occluded or large angle face, please check.'], ], + 'description' => '', ], ], - 'FaceNumber' => [ - 'description' => '单张图片检测到的人脸数量。'."\n" - .'如果未检测到人脸，FaceNumber返回为0。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], ], + 'description' => '', ], ], ], @@ -3498,66 +2746,62 @@ ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'ParameterError', - 'errorMessage' => 'The parameter is invalid. Please check again.', - ], + ['errorCode' => 'ParameterError', 'errorMessage' => 'The parameter is invalid. Please check again.', 'description' => '参数错误，请检查参数值'], ], 403 => [ - [ - 'errorCode' => 'AuthFailed', - 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', - ], + ['errorCode' => 'AuthFailed', 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', 'description' => '授权失败，请检查RAM权限配置'], ], 408 => [ - [ - 'errorCode' => 'Timeout', - 'errorMessage' => 'The request has timed out.', - ], + ['errorCode' => 'Timeout', 'errorMessage' => 'The request has timed out.', 'description' => '请求超时，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'The service is unavailable.', - ], + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'The service is unavailable.', 'description' => '服务不可用，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"2EEA0396-BD84-5729-B8BD-D60776FCEF2B\\",\\n \\"Data\\": {\\n \\"Elements\\": [\\n {\\n \\"ImageURL\\": \\"http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/DetectLivingFace/DetectLivingFace4.jpg\\",\\n \\"TaskId\\": \\"img1owc8WGskNm78OEAPJTZal-1****\\",\\n \\"Results\\": [\\n {\\n \\"Suggestion\\": \\"review\\",\\n \\"Frames\\": [\\n {\\n \\"Url\\": \\"http://aligreen-shanghai.oss-cn-shanghai.aliyuncs.com/prod/hammal/26210da42/28118541_TB1urBOQFXXXXbMXFXXXXXXXXXX-1442-257.png?Expires=1582703593&OSSAccessKeyId=H4sp5QfNbuDg****&Signature=%2B8iUkb5YjomYR8ujV2c8wMAavs****&x-oss-process=image%2Fcrop%2Cx_0%2Cw_288%2Fauto-orient%2C0\\",\\n \\"Rate\\": 84.83\\n }\\n ],\\n \\"Label\\": \\"liveness\\",\\n \\"Rate\\": 76.22,\\n \\"Rect\\": {\\n \\"Left\\": 20,\\n \\"Top\\": 30,\\n \\"Width\\": 50,\\n \\"Height\\": 60\\n },\\n \\"MessageTips\\": \\"blurred, occluded or large angle face, please check.\\"\\n }\\n ],\\n \\"FaceNumber\\": 1\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n 2EEA0396-BD84-5729-B8BD-D60776FCEF2B\\n \\n \\n http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/DetectLivingFace/DetectLivingFace4.jpg\\n img1owc8WGskNm78OEAPJTZal-1****\\n \\n review\\n \\n http://aligreen-shanghai.oss-cn-shanghai.aliyuncs.com/prod/hammal/26210da42/28118541_TB1urBOQFXXXXbMXFXXXXXXXXXX-1442-257.png?Expires=1582703593&OSSAccessKeyId=H4sp5QfNbuDg****&Signature=%2B8iUkb5YjomYR8ujV2c8wMAavs****&x-oss-process=image%2Fcrop%2Cx_0%2Cw_288%2Fauto-orient%2C0\\n 84.83\\n \\n \\n 76.22\\n \\n 20\\n 30\\n 50\\n 60\\n \\n blurred, occluded or large angle face, please check.\\n \\n 1\\n \\n \\n","errorExample":""}]', - 'title' => '人脸活体检测', + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"68DF6EC7-3B1D-11EE-9FA7-1122F1AE92DD\\",\\n \\"Data\\": {\\n \\"Elements\\": [\\n {\\n \\"FaceNumber\\": 1,\\n \\"ImageURL\\": \\"http://viapi-demo.oss-cn-shanghai.aliyuncs.com/viapi-demo/images/SegmentCommonImage/segmentimage-src-hu.jpeg\\",\\n \\"Results\\": [\\n {\\n \\"Label\\": \\"liveness\\",\\n \\"Rate\\": 83.3848,\\n \\"Rect\\": {\\n \\"Height\\": 20,\\n \\"Width\\": 30,\\n \\"Top\\": 50,\\n \\"Left\\": 60\\n },\\n \\"Suggestion\\": \\"review\\",\\n \\"MessageTips\\": \\"blurred, occluded or large angle face, please check.\\"\\n }\\n ]\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n 68DF6EC7-3B1D-11EE-9FA7-1122F1AE92DD\\n \\n \\n 1\\n http://viapi-demo.oss-cn-shanghai.aliyuncs.com/viapi-demo/images/SegmentCommonImage/segmentimage-src-hu.jpeg\\n \\n \\n 83.3848\\n \\n 20\\n 30\\n 50\\n 60\\n \\n review\\n blurred, occluded or large angle face, please check.\\n \\n \\n \\n","errorExample":""}]', + 'title' => '红外人脸活体检测', 'description' => '## 功能描述'."\n" - .'人脸活体检测能力可以检测图像中的人脸是否为来自认证设备端的近距离裸拍活体人脸对象，可广泛应用在人脸实时采集场景，满足人脸注册认证的真实性和安全性要求。活体判断的前置条件是图像中有人脸。'."\n" - .'能力范围来看：'."\n" - .'1. 认证设备端是指借助近距离裸拍活体正面人脸用于认证、通行等服务场景的含RGB摄像头的硬件设备，常见的认证设备端有手机、门禁机、考勤机、PC等智能终端认证设备。'."\n" - .'2. 裸拍活体正面人脸是指真人未经重度PS、风格化、人工合成等后处理的含正面人脸（非模糊、遮挡、大角度的正面人脸）的照片。常见的非真人有纸张人脸、电子屏人脸等；常见经过重度PS后处理的照片有摆拍街景照、摆拍人物风景照、摆拍证件照等；常见的其他后处理及生成照片有动漫人脸、绘画人脸等。'."\n" + .'红外人脸活体检测能力可以检测红外图片中的人脸是否为来自认证设备端的近距离裸拍活体人脸对象，可广泛应用在红外设备人脸实时采集场景，满足红外人脸注册认证的真实性和安全性要求，判断的前置条件是红外图像中有人脸。'."\n" + .'从能力范围来看：'."\n" + .'1. 认证设备端是指借助近距离裸拍活体正面人脸用于认证、通行等服务场景的含红外摄像头的硬件设备，常见的认证设备端有门禁机、考勤机、PC等智能终端认证设备。'."\n" + .'2. 裸拍活体正面人脸是指真人未经重度PS、风格化、人工合成等后处理的含正面人脸（非模糊、遮挡、大角度的正面人脸）的裸红外照片。常见的非真人有纸张人脸、3D模型人脸等。'."\n" ."\n" - .'> - 在同时检测多个Task的情况下，将按照Task的个数进行累计计费。'."\n" - .'- 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" - .'- 当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击[立即试用](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=DetectLivingFace)对该能力进行更直观试用以及在线购买。'."\n" + .'关于该接口功能的示例图如下：'."\n" + .'- 真人'."\n" + .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20230202/dsjz/DetectInfraredLivingFacezhenren.png" width="400)'."\n" + .'- 纸张人脸'."\n" + .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20230202/gfgt/DetectInfraredLivingFacezhizhang.png" width="400)'."\n" + ."\n" + .'> - 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" + .'- 当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击[立即试用](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=DetectInfraredLivingFace)对该能力进行更直观试用以及在线购买。'."\n" .'- 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。'."\n" ."\n" .'## 应用场景'."\n" - .'- 系统人脸登录防攻击：通过检测上传的图像是否为真人实拍，而非攻击及PS等后处理照片，以防止攻击者登录系统带来安全风险。'."\n" - .'- 门禁闸机刷脸通行：面向人脸注册和认证环节设备端实时的活体检测，实现注册与认证过程中的真人校验，防止非法分子盗用、伪造他人身份打卡通行。'."\n" - .'- 智慧酒店自助入住：在酒店前台自助办理入住场景中，运用活体检测技术实现无人监管场景下，住客非活体攻击（纸张人脸、电子屏人脸）的高效率拦截。'."\n" - .'- 金融远程身份认证：面向投资理财、基金交易、保险理赔等金融业务的活体检测需求，高效率实现对翻拍、PS图片、打印图片、高仿模具等攻击的拦截，确保用户身份真实。'."\n" + .'- 系统人脸登录防攻击：通过检测上传的红外图像是否是真人实拍，而非攻击及PS等后处理照片，以防止攻击者登录系统带来安全风险。'."\n" + .'- 门禁门锁闸机刷脸通行：面向人脸注册和认证环节设备端实时的红外活体检测，实现注册与认证过程中的真人校验，防止非法分子盗用、伪造他人身份打卡通行。'."\n" + .'- 智慧酒店自助入住：在酒店前台自助办理入住场景中，运用红外活体检测技术实现无人监管场景下，住客非活体攻击（纸张人脸、电子屏人脸）的高效率拦截。'."\n" ."\n" .'## 特色优势'."\n" - .'- 基于图片中人像目标的高维度特征（风格化、摩尔纹、成像畸形等），判断目标对象是否为活体，有效防止屏幕二次翻拍等作弊攻击，支持单张或多张判断逻辑。'."\n" - .'- 灵活支持RGB摄像头设备的实时活体检测，可有效防止翻拍、头模、打印图片等样本攻击。'."\n" - .'- 简单易用：可直接调用的API接口，服务简单易用，易被集成，兼容性强。'."\n" + .'- 高精度防伪：基于图片中人像目标的高维度特征（风格化、摩尔纹、成像畸形等），判断目标对象是否为活体，有效防止屏幕二次翻拍等作弊攻击，支持单张或多张判断逻辑。'."\n" + .'- 高灵敏拦截：支持红外摄像头设备的实时活体检测，可有效防止翻拍、头模、打印图片等样本攻击。'."\n" + .'- 使用范围广：对于门锁等可见光照不理想的场景，具有更佳的适用性。'."\n" + .'- 简单易用：可直接调用的 API 接口，服务简单易用，易被集成，兼容性强。'."\n" ."\n" .'## 接入指引'."\n" .'1. 注册阿里云账号：打开[阿里云官网](https://www.aliyun.com)，在阿里云官网右上角，单击**立即注册**，按照操作提示完成账号注册。'."\n" .'2. 开通能力：请确保您已开通[人脸人体服务](https://vision.aliyun.com/facebody)，若未开通服务请[立即开通](https://common-buy.aliyun.com/?commodityCode=viapi_facebody_public_cn#/open)。'."\n" - .'> 本能力支持企业或个人认证用户开通。更多实名认证操作信息，请参见[实名认证](https://help.aliyun.com/knowledge_list/37170.html)。'."\n" + .'>'."\n" + .'本能力仅限企业认证用户开通。更多实名认证操作信息，请参见[实名认证](https://help.aliyun.com/knowledge_list/37170.html)。'."\n" + .'>'."\n" + ."\n" .'3. 创建AccessKey：请确保您已[创建AccessKey](~~175144~~)，如果您使用的是子账号AccessKey，您需要给子账号赋予AliyunVIAPIFullAccess权限，具体操作，请参见[RAM授权](~~145025~~)。'."\n" - .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/facebody/2019-12-30/DetectLivingFace?lang=JAVA&sdkStyle=dara¶ms=%7B%22Tasks%22%3A%5B%7B%22ImageURL%22%3A%22http%3A%2F%2Fviapi-test.oss-cn-shanghai.aliyuncs.com%2Fviapi-3.0domepic%2Ffacebody%2FDetectLivingFace%2FDetectLivingFace1.jpg%22%7D%5D%7D&tab=DEMO)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" + .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/facebody/2019-12-30/DetectInfraredLivingFace?lang=JAVA)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" .'5. 开发接入步骤：'."\n" .'- 在[SDK总览](~~145033~~)中选择您要接入使用的SDK语言。'."\n" .'- 在对应语言的SDK文档中找到AI类目为人脸人体（facebody）的SDK包进行安装。'."\n" .'- 参考文档中提供的示例代码进行适当修改后调用。'."\n" ."\n" - .'6. 示例代码：该能力常用语言的示例代码，请参见[人脸活体检测示例代码](~~465556~~)。'."\n" + .'6. 示例代码：该能力常用语言的示例代码，请参见[红外人脸活体检测示例代码](~~601305~~)。'."\n" ."\n" .'7. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" .'- [Web前端直接调用](~~467779~~)'."\n" @@ -3568,13 +2812,11 @@ .'## 输入限制'."\n" .'- 图像格式：PNG、JPG、JPEG、BMP、GIF、WEBP。'."\n" .'- 图像大小：不超过10 MB。'."\n" - .'- 图像分辨率：建议大于256×256像素，像素过低可能会影响识别效果。'."\n" + .'- 图像分辨率：建议大于256×256，像素过低可能会影响识别效果。'."\n" .'- URL地址中不能包含中文字符。'."\n" - ."\n" .'> 当图像分辨率超过最大限制时，请先将图片进行缩放，调整图片大小，具体请参见[图片缩放](~~44688~~)。'."\n" ."\n" .'## 检测说明'."\n" - ."\n" .'- 最长检测时间是5秒，如果在该时间内没有完成检测，系统会强制返回超时错误码。'."\n" .'- 图像下载时间限制为3秒，如果下载时间超过3秒，系统会返回下载超时。'."\n" .'- 图像检测接口响应时间依赖图像的下载时间。请保证被检测图像所在的存储服务稳定可靠，建议您使用阿里云OSS存储或者CDN缓存。'."\n" @@ -3582,23 +2824,22 @@ .'- 目前平台提供的活体检测为静默活体，即基于图片进行检测，暂不支持摇头，张嘴、眨眼等动作的活体检测。'."\n" ."\n" .'## 计费说明'."\n" - .'关于人脸活体检测的计费方式及报价，请参见[计费介绍](~~184049~~)。'."\n" - ."\n" - .'> 下方调试接口为付费接口，如需免费体验调试请前往[体验中心](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=DetectLivingFace)。', - 'requestParamsDescription' => ' ', + .'关于红外人脸活体检测的计费方式及报价，请参见[计费介绍](~~184049~~)。'."\n" + .'> 下方调试接口为付费接口，如需免费体验调试请前往[体验中心](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=DetectInfraredLivingFace)。'."\n", 'responseParamsDescription' => '## SDK参考'."\n" - .'阿里云视觉AI人脸人体类目下的人脸活体检测能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。'."\n" + .'阿里云视觉AI人脸人体类目下的红外人脸活体检测能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。'."\n" ."\n" .'## 示例代码'."\n" - .'该能力常用语言的示例代码，请参见[人脸活体检测示例代码](~~465556~~)。', + .'该能力常用语言的示例代码，请参见[红外人脸活体检测示例代码](~~601305~~)。', 'extraInfo' => '## 活体阈值参考'."\n" + .'关于图片活体检测的判断阈值选择，可参考以下列表数值信息：'."\n" .'| Label | Rate阈值 | 攻击拦截率 | 活体通过率 | '."\n" .'| ---- | ------------ | ---- | ------------ |'."\n" - .'|liveness |50 |98.7% |97.85% |'."\n" - .'|liveness |30 |99.03% |96.96% |'."\n" - .'|normal（推荐） |80（推荐） |99.17% |96.39% |'."\n" - .'|normal |85 |99.27% |95.55% |'."\n" - .'|normal |95 |99.53% |92.24% |'."\n" + .'|liveness |0.39 |98.18% |90.21% |'."\n" + .'|liveness |0.55 |98.54% |89.29% |'."\n" + .'|liveness |0.7 |98.94% |88.36% |'."\n" + .'|normal（推荐） |0.8（推荐） |99.11% |87.00% |'."\n" + .'|normal |0.95 |99.60% |80.03% |'."\n" ."\n" .'当Label是normal时，表示的是活体，Rate表示活体置信度，Rate取值范围是\\[80,100]。'."\n" .'当Label是liveness时，表示的是非活体，Rate表示非活体置信度，Rate取值范围是\\[20,100]。'."\n" @@ -3609,7 +2850,7 @@ .'> 内部实验数据测算，仅供参考。'."\n" ."\n" .'## 错误码'."\n" - .'关于人脸活体检测的错误码，详情请参见[常见错误码](~~146756~~)。'."\n" + .'关于红外人脸活体检测的错误码，详情请参见[常见错误码](~~146756~~)。'."\n" ."\n" .'## 开源模型体验'."\n" .'更多开源免费模型体验及下载，详见魔搭社区：[人脸活体检测模型-RGB](https://modelscope.cn/models/damo/cv_manual_face-liveness_flrgb/summary)、[人脸活体检测模型-IR](https://modelscope.cn/models/damo/cv_manual_face-liveness_flir/summary)、[静默人脸活体检测模型-炫彩](https://modelscope.cn/models/damo/cv_manual_face-liveness_flxc/summary)。'."\n" @@ -3618,15 +2859,25 @@ .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。'."\n" .'- 平台不存储用户在使用服务过程中涉及的原始人脸图片或文件信息。', - ], - 'FaceBeauty' => [ - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'http', - 'https', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-facebody:DetectInfraredLivingFace', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + ], + 'DetectLivingFace' => [ + 'summary' => '本文为您介绍人脸活体检测DetectLivingFace的语法及示例。', + 'methods' => ['post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -3637,76 +2888,100 @@ 'systemTags' => [], 'parameters' => [ [ - 'name' => 'ImageURL', - 'in' => 'formData', - 'schema' => [ - 'description' => '图像URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。'."\n" - .'输入限制：'."\n" - ."\n" - .'- 图像格式：JPEG、JPG、PNG、BMP。'."\n" - .'- 图像大小：不超过4 MB。'."\n" - .'- 图像分辨率：分辨率大于10×10像素，分辨率小于2000x2000像素，最长边小于2000像素。'."\n" - .'- URL地址中不能包含中文字符。'."\n" - .'- 图像质量建议：适用于大部分肤质的人像图像，对于包含比较严重色斑、痤疮或低曝等场景的图像效果一般。', - 'type' => 'string', - 'required' => true, - 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/FaceBeauty/FaceBeauty4.png', - 'isFileTransferUrl' => true, - ], - ], - [ - 'name' => 'Sharp', - 'in' => 'formData', - 'schema' => [ - 'description' => '锐化（清晰度）程度，取值范围0~1。越接近1锐化程度越高。', - 'type' => 'number', - 'format' => 'float', - 'required' => true, - 'example' => '1', - ], - ], - [ - 'name' => 'Smooth', - 'in' => 'formData', - 'schema' => [ - 'description' => '平滑程度，取值范围0~1。越接近1平滑程度越高。', - 'type' => 'number', - 'format' => 'float', - 'required' => true, - 'example' => '0.1', - ], - ], - [ - 'name' => 'White', + 'name' => 'Tasks', 'in' => 'formData', + 'style' => 'repeatList', 'schema' => [ - 'description' => '美白程度，取值范围0~1。越接近1美白程度越高。', - 'type' => 'number', - 'format' => 'float', + 'description' => '输入人脸数据。', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'ImageURL' => ['description' => '待检测的图像URL地址。JSON数组中的每个元素是一个图片检测任务结构体（image表）。最多支持10个元素，即同时最多对10张图片进行检测。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。'."\n" + ."\n" + .'> 对于该接口，系统会自动将OSS链接地址转成内网地址然后再下载文件，所以调用该接口并不会产生OSS流量计费。', 'type' => 'string', 'required' => false, 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/DetectLivingFace/DetectLivingFace4.jpg', 'isFileTransferUrl' => true], + 'ImageData' => ['description' => '图像Base64编码字符串。当与URL方式共存时，URL方式优先。'."\n" + .'文件的Base64编码处理操作，请参见[文件Base64处理](~~468191~~)。', 'type' => 'string', 'required' => false, 'example' => '/9j/4AAQSkZJRgABAQAAAQABAAD/2****'], + ], + 'required' => false, + 'description' => '', + ], 'required' => true, - 'example' => '0.3', + 'maxItems' => 10, ], ], ], 'responses' => [ 200 => [ 'schema' => [ + 'description' => '1', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '35C284E1-C5F5-4E5E-B7AD-97BBF485CDC8', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '2EEA0396-BD84-5729-B8BD-D60776FCEF2B'], 'Data' => [ - 'description' => '返回的数据内容。', + 'description' => '返回的结果数据内容。', 'type' => 'object', 'properties' => [ - 'ImageURL' => [ - 'description' => '美颜后图像的URL地址。'."\n" - .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。', - 'type' => 'string', - 'example' => 'http://algo-app-taobao-mm-cn-shanghai-prod.oss-cn-shanghai.aliyuncs.com/pixelai-portrait-beauty/2020_03_24/2bbbdb7907901412_facebeauty.jpg?Expires=1585277923&OSSAccessKeyId=LTAI****************&Signature=myOPfNQcRyijgrWBU%2BZ4dPuV5Q****', + 'Elements' => [ + 'description' => '返回的元素。', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'ImageURL' => ['description' => '对应请求中的图像URL地址。', 'type' => 'string', 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/DetectLivingFace/DetectLivingFace4.jpg'], + 'TaskId' => ['description' => '该检测任务的ID。', 'type' => 'string', 'example' => 'img1owc8WGskNm78OEAPJTZal-1****'], + 'Results' => [ + 'description' => '返回结果。调用成功时返回结果中包含一个或多个元素。', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'Suggestion' => ['description' => '建议您执行的操作，取值范围如下：'."\n" + .'- pass：图片中的活体对象来自直接拍摄，无需进行其余操作。'."\n" + .'- review：图片中的活体对象可能来自翻拍，建议您确认后再进行操作。'."\n" + .'- block：图片中的活体对象大概率来自翻拍，建议您执行后续操作。'."\n" + .'如果未检测到人脸，则Suggestion返回为block。'."\n", 'type' => 'string', 'example' => 'review'], + 'Frames' => [ + 'description' => '**（该字段已废弃）**输入图像为长图（长宽比大于3:1）时，会把原图截成几张正常比例的图，frames保存从图像中裁剪出来的而且是翻拍命中的截图。', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'Url' => ['description' => '命中的截图。', 'type' => 'string', 'example' => 'http://aligreen-shanghai.oss-cn-shanghai.aliyuncs.com/prod/hammal/26210da42/28118541_TB1urBOQFXXXXbMXFXXXXXXXXXX-1442-257.png?Expires=1582703593&OSSAccessKeyId=H4sp5QfNbuDg****&Signature=%2B8iUkb5YjomYR8ujV2c8wMAavs****&x-oss-process=image%2Fcrop%2Cx_0%2Cw_288%2Fauto-orient%2C0'], + 'Rate' => ['description' => '结果为该分类的概率，取值范围为\\[0.00,100.00]。取值越大，表示属于该分类的概率越大。'."\n" + .'如果未检测到人脸，则Rate返回为100。', 'type' => 'number', 'format' => 'float', 'example' => '84.83'], + ], + 'description' => '', + ], + ], + 'Label' => ['description' => '检测结果的分类，取值包括：'."\n" + .'- normal：活体照片'."\n" + .'- liveness：翻拍照片'."\n" + ."\n" + .'如果未检测到人脸，则Label返回为liveness。', 'type' => 'string', 'example' => 'liveness'], + 'Rate' => ['description' => '结果为该分类的概率，取值范围为\\[0.00,100.00]。表示属于该分类的概率越大。', 'type' => 'number', 'format' => 'float', 'example' => '76.22'], + 'Rect' => [ + 'description' => '人脸检测框信息。', + 'type' => 'object', + 'properties' => [ + 'Left' => ['description' => '检测框左上角的点x坐标。', 'type' => 'integer', 'format' => 'int64', 'example' => '20'], + 'Top' => ['description' => '检测框左上角的点y坐标。', 'type' => 'integer', 'format' => 'int64', 'example' => '30'], + 'Width' => ['description' => '检测框宽度。', 'type' => 'integer', 'format' => 'int64', 'example' => '50'], + 'Height' => ['description' => '检测框高度。', 'type' => 'integer', 'format' => 'int64', 'example' => '60'], + ], + ], + 'MessageTips' => ['description' => '提示信息。'."\n" + .'- 如输入模糊、遮挡或大角度等的人脸，则返回提示信息：`blurred, occluded or large angle face, please check.` '."\n" + .'- 如未检测到人脸，则返回提示信息：`no face detected, try again please.`', 'type' => 'string', 'example' => 'blurred, occluded or large angle face, please check.'], + ], + 'description' => '', + ], + ], + 'FaceNumber' => ['description' => '单张图片检测到的人脸数量。'."\n" + .'如果未检测到人脸，FaceNumber返回为0。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], + ], + 'description' => '', + ], ], ], ], @@ -3716,114 +2991,132 @@ ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'ParameterError', - 'errorMessage' => 'The parameter is invalid. Please check again.', - ], + ['errorCode' => 'ParameterError', 'errorMessage' => 'The parameter is invalid. Please check again.', 'description' => '参数错误，请检查参数值'], ], 403 => [ - [ - 'errorCode' => 'AuthFailed', - 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', - ], + ['errorCode' => 'AuthFailed', 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', 'description' => '授权失败，请检查RAM权限配置'], ], 408 => [ - [ - 'errorCode' => 'Timeout', - 'errorMessage' => 'The request has timed out.', - ], + ['errorCode' => 'Timeout', 'errorMessage' => 'The request has timed out.', 'description' => '请求超时，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'The service is unavailable.', - ], + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'The service is unavailable.', 'description' => '服务不可用，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"35C284E1-C5F5-4E5E-B7AD-97BBF485CDC8\\",\\n \\"Data\\": {\\n \\"ImageURL\\": \\"http://algo-app-taobao-mm-cn-shanghai-prod.oss-cn-shanghai.aliyuncs.com/pixelai-portrait-beauty/2020_03_24/2bbbdb7907901412_facebeauty.jpg?Expires=1585277923&OSSAccessKeyId=LTAI****************&Signature=myOPfNQcRyijgrWBU%2BZ4dPuV5Q****\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n 35C284E1-C5F5-4E5E-B7AD-97BBF485CDC8\\n \\n http://algo-app-taobao-mm-cn-shanghai-prod.oss-cn-shanghai.aliyuncs.com/pixelai-portrait-beauty/2020_03_24/2bbbdb7907901412_facebeauty.jpg?Expires=1585277923&OSSAccessKeyId=LTAI****************&Signature=myOPfNQcRyijgrWBU%2BZ4dPuV5Q****\\n \\n","errorExample":""}]', - 'title' => '人脸美颜', - 'summary' => '本文介绍人脸美颜FaceBeauty的语法及示例。', + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"2EEA0396-BD84-5729-B8BD-D60776FCEF2B\\",\\n \\"Data\\": {\\n \\"Elements\\": [\\n {\\n \\"ImageURL\\": \\"http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/DetectLivingFace/DetectLivingFace4.jpg\\",\\n \\"TaskId\\": \\"img1owc8WGskNm78OEAPJTZal-1****\\",\\n \\"Results\\": [\\n {\\n \\"Suggestion\\": \\"review\\",\\n \\"Frames\\": [\\n {\\n \\"Url\\": \\"http://aligreen-shanghai.oss-cn-shanghai.aliyuncs.com/prod/hammal/26210da42/28118541_TB1urBOQFXXXXbMXFXXXXXXXXXX-1442-257.png?Expires=1582703593&OSSAccessKeyId=H4sp5QfNbuDg****&Signature=%2B8iUkb5YjomYR8ujV2c8wMAavs****&x-oss-process=image%2Fcrop%2Cx_0%2Cw_288%2Fauto-orient%2C0\\",\\n \\"Rate\\": 84.83\\n }\\n ],\\n \\"Label\\": \\"liveness\\",\\n \\"Rate\\": 76.22,\\n \\"Rect\\": {\\n \\"Left\\": 20,\\n \\"Top\\": 30,\\n \\"Width\\": 50,\\n \\"Height\\": 60\\n },\\n \\"MessageTips\\": \\"blurred, occluded or large angle face, please check.\\"\\n }\\n ],\\n \\"FaceNumber\\": 1\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n 2EEA0396-BD84-5729-B8BD-D60776FCEF2B\\n \\n \\n http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/DetectLivingFace/DetectLivingFace4.jpg\\n img1owc8WGskNm78OEAPJTZal-1****\\n \\n review\\n \\n http://aligreen-shanghai.oss-cn-shanghai.aliyuncs.com/prod/hammal/26210da42/28118541_TB1urBOQFXXXXbMXFXXXXXXXXXX-1442-257.png?Expires=1582703593&OSSAccessKeyId=H4sp5QfNbuDg****&Signature=%2B8iUkb5YjomYR8ujV2c8wMAavs****&x-oss-process=image%2Fcrop%2Cx_0%2Cw_288%2Fauto-orient%2C0\\n 84.83\\n \\n \\n 76.22\\n \\n 20\\n 30\\n 50\\n 60\\n \\n blurred, occluded or large angle face, please check.\\n \\n 1\\n \\n \\n","errorExample":""}]', + 'title' => '人脸活体检测', 'description' => '## 功能描述'."\n" - .'人脸美颜能力可以对图像中的人脸进行美颜。产品支持以下功能：'."\n" - .'- 人脸美颜：磨皮、美白、锐化（清晰度）、平滑度等。'."\n" - .'- 参数调整：可自定义调整参数，提升个人形象。'."\n" - ."\n" - .'关于该接口功能的示例图如下：'."\n" - .'- 输入原图'."\n" - .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20230202/pklu/FaceBeauty.png" width="300)'."\n" - ."\n" - .'- 美白'."\n" - .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20221101/lmdw/FaceBeautymeibai.jpg" width="300)'."\n" - ."\n" - .'- 磨皮'."\n" - .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20221101/isyv/FaceBeautymopi.jpg" width="300)'."\n" + .'人脸活体检测能力可以检测图像中的人脸是否为来自认证设备端的近距离裸拍活体人脸对象，可广泛应用在人脸实时采集场景，满足人脸注册认证的真实性和安全性要求。活体判断的前置条件是图像中有人脸。'."\n" + .'能力范围来看：'."\n" + .'1. 认证设备端是指借助近距离裸拍活体正面人脸用于认证、通行等服务场景的含RGB摄像头的硬件设备，常见的认证设备端有手机、门禁机、考勤机、PC等智能终端认证设备。'."\n" + .'2. 裸拍活体正面人脸是指真人未经重度PS、风格化、人工合成等后处理的含正面人脸（非模糊、遮挡、大角度的正面人脸）的照片。常见的非真人有纸张人脸、电子屏人脸等；常见经过重度PS后处理的照片有摆拍街景照、摆拍人物风景照、摆拍证件照等；常见的其他后处理及生成照片有动漫人脸、绘画人脸等。'."\n" ."\n" - .'> - 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" - .'- 当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击[立即试用](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=FaceBeauty)对该能力进行更直观试用以及在线购买。'."\n" + .'> - 在同时检测多个Task的情况下，将按照Task的个数进行累计计费。'."\n" + .'- 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" + .'- 当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击[立即试用](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=DetectLivingFace)对该能力进行更直观试用以及在线购买。'."\n" .'- 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。'."\n" ."\n" .'## 应用场景'."\n" - ."\n" - .'- 美颜相机：通过美颜相机拍摄的照片将自带美颜效果。'."\n" - .'- 摄影后期制作：通过基于深度学习的人脸美颜技术，提升人像摄影作品的艺术效果。'."\n" + .'- 系统人脸登录防攻击：通过检测上传的图像是否为真人实拍，而非攻击及PS等后处理照片，以防止攻击者登录系统带来安全风险。'."\n" + .'- 门禁闸机刷脸通行：面向人脸注册和认证环节设备端实时的活体检测，实现注册与认证过程中的真人校验，防止非法分子盗用、伪造他人身份打卡通行。'."\n" + .'- 智慧酒店自助入住：在酒店前台自助办理入住场景中，运用活体检测技术实现无人监管场景下，住客非活体攻击（纸张人脸、电子屏人脸）的高效率拦截。'."\n" + .'- 金融远程身份认证：面向投资理财、基金交易、保险理赔等金融业务的活体检测需求，高效率实现对翻拍、PS图片、打印图片、高仿模具等攻击的拦截，确保用户身份真实。'."\n" ."\n" .'## 特色优势'."\n" - ."\n" - .'- 人脸美化：可对拍摄的照片磨皮、去黑眼圈和法令纹、美白等效果。'."\n" - .'- 清晰度保持：可维持原片的清晰度。'."\n" + .'- 基于图片中人像目标的高维度特征（风格化、摩尔纹、成像畸形等），判断目标对象是否为活体，有效防止屏幕二次翻拍等作弊攻击，支持单张或多张判断逻辑。'."\n" + .'- 灵活支持RGB摄像头设备的实时活体检测，可有效防止翻拍、头模、打印图片等样本攻击。'."\n" + .'- 简单易用：可直接调用的API接口，服务简单易用，易被集成，兼容性强。'."\n" ."\n" .'## 接入指引'."\n" .'1. 注册阿里云账号：打开[阿里云官网](https://www.aliyun.com)，在阿里云官网右上角，单击**立即注册**，按照操作提示完成账号注册。'."\n" .'2. 开通能力：请确保您已开通[人脸人体服务](https://vision.aliyun.com/facebody)，若未开通服务请[立即开通](https://common-buy.aliyun.com/?commodityCode=viapi_facebody_public_cn#/open)。'."\n" .'> 本能力支持企业或个人认证用户开通。更多实名认证操作信息，请参见[实名认证](https://help.aliyun.com/knowledge_list/37170.html)。'."\n" .'3. 创建AccessKey：请确保您已[创建AccessKey](~~175144~~)，如果您使用的是子账号AccessKey，您需要给子账号赋予AliyunVIAPIFullAccess权限，具体操作，请参见[RAM授权](~~145025~~)。'."\n" - .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/facebody/2019-12-30/FaceBeauty?lang=JAVA&sdkStyle=dara¶ms={%22ImageURL%22:%22http%3A%2F%2Fviapi-test.oss-cn-shanghai.aliyuncs.com%2Fviapi-3.0domepic%2Ffacebody%2FFaceBeauty%2FFaceBeauty1.png%22,%22Sharp%22:0.3,%22Smooth%22:0.3,%22White%22:0.3}&tab=DEBUG)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" + .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/facebody/2019-12-30/DetectLivingFace?lang=JAVA&sdkStyle=dara¶ms=%7B%22Tasks%22%3A%5B%7B%22ImageURL%22%3A%22http%3A%2F%2Fviapi-test.oss-cn-shanghai.aliyuncs.com%2Fviapi-3.0domepic%2Ffacebody%2FDetectLivingFace%2FDetectLivingFace1.jpg%22%7D%5D%7D&tab=DEMO)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" .'5. 开发接入步骤：'."\n" .'- 在[SDK总览](~~145033~~)中选择您要接入使用的SDK语言。'."\n" .'- 在对应语言的SDK文档中找到AI类目为人脸人体（facebody）的SDK包进行安装。'."\n" .'- 参考文档中提供的示例代码进行适当修改后调用。'."\n" ."\n" - .'6. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" + .'6. 示例代码：该能力常用语言的示例代码，请参见[人脸活体检测示例代码](~~465556~~)。'."\n" + ."\n" + .'7. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" .'- [Web前端直接调用](~~467779~~)'."\n" .'- [小程序场景下直接调用](~~467780~~)'."\n" .'- [Android端直接调用](~~467781~~)'."\n" .'- [iOS端直接调用](~~467782~~)'."\n" - ."\n\n" - .'## 输入限制'."\n" ."\n" - .'- 图像格式：JPEG、JPG、PNG、BMP。'."\n" - .'- 图像大小：不超过3 MB。'."\n" - .'- 图像分辨率：分辨率大于10×10像素，分辨率小于2000x2000像素，最长边小于2000像素。'."\n" + .'## 输入限制'."\n" + .'- 图像格式：PNG、JPG、JPEG、BMP、GIF、WEBP。'."\n" + .'- 图像大小：不超过10 MB。'."\n" + .'- 图像分辨率：建议大于256×256像素，像素过低可能会影响识别效果。'."\n" .'- URL地址中不能包含中文字符。'."\n" - .'- 图像质量建议：适用于大部分肤质的人像图像，对于包含比较严重色斑、痤疮或低曝等场景的图像效果一般。'."\n" ."\n" .'> 当图像分辨率超过最大限制时，请先将图片进行缩放，调整图片大小，具体请参见[图片缩放](~~44688~~)。'."\n" ."\n" + .'## 检测说明'."\n" + ."\n" + .'- 最长检测时间是5秒，如果在该时间内没有完成检测，系统会强制返回超时错误码。'."\n" + .'- 图像下载时间限制为3秒，如果下载时间超过3秒，系统会返回下载超时。'."\n" + .'- 图像检测接口响应时间依赖图像的下载时间。请保证被检测图像所在的存储服务稳定可靠，建议您使用阿里云OSS存储或者CDN缓存。'."\n" + .'- 最多可检测10张图像。'."\n" + .'- 目前平台提供的活体检测为静默活体，即基于图片进行检测，暂不支持摇头，张嘴、眨眼等动作的活体检测。'."\n" + ."\n" .'## 计费说明'."\n" - .'关于人脸美颜的计费方式及报价，请参见[计费介绍](~~184049~~)。'."\n" + .'关于人脸活体检测的计费方式及报价，请参见[计费介绍](~~184049~~)。'."\n" ."\n" - .'> 下方调试接口为付费接口，如需免费体验调试请前往[体验中心](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=FaceBeauty)。', + .'> 下方调试接口为付费接口，如需免费体验调试请前往[体验中心](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=DetectLivingFace)。', 'requestParamsDescription' => ' ', 'responseParamsDescription' => '## SDK参考'."\n" - .'阿里云视觉AI人脸人体类目下的人脸美颜能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。', - 'extraInfo' => '## 错误码'."\n" - .'关于人脸美颜的错误码，详情请参见[常见错误码](~~146756~~)。'."\n" + .'阿里云视觉AI人脸人体类目下的人脸活体检测能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。'."\n" + ."\n" + .'## 示例代码'."\n" + .'该能力常用语言的示例代码，请参见[人脸活体检测示例代码](~~465556~~)。', + 'extraInfo' => '## 活体阈值参考'."\n" + .'| Label | Rate阈值 | 攻击拦截率 | 活体通过率 | '."\n" + .'| ---- | ------------ | ---- | ------------ |'."\n" + .'|liveness |50 |98.7% |97.85% |'."\n" + .'|liveness |30 |99.03% |96.96% |'."\n" + .'|normal（推荐） |80（推荐） |99.17% |96.39% |'."\n" + .'|normal |85 |99.27% |95.55% |'."\n" + .'|normal |95 |99.53% |92.24% |'."\n" + ."\n" + .'当Label是normal时，表示的是活体，Rate表示活体置信度，Rate取值范围是\\[80,100]。'."\n" + .'当Label是liveness时，表示的是非活体，Rate表示非活体置信度，Rate取值范围是\\[20,100]。'."\n" + .'关于以上数值的概念定义：'."\n" + .'- 攻击拦截率：如98%，代表100次作弊假体攻击，会有98次被API识破拒绝。'."\n" + .'- 活体通过率：如98%，代表100次真人请求，会有98次顺利通过活体验证。'."\n" + ."\n" + .'> 内部实验数据测算，仅供参考。'."\n" + ."\n" + .'## 错误码'."\n" + .'关于人脸活体检测的错误码，详情请参见[常见错误码](~~146756~~)。'."\n" ."\n" .'## 开源模型体验'."\n" - .'更多开源免费模型体验及下载，详见魔搭社区：[106点人脸关键点-通用领域-2D](https://www.modelscope.cn/models/damo/cv_mobilenet_face-2d-keypoints_alignment/summary)。'."\n" + .'更多开源免费模型体验及下载，详见魔搭社区：[人脸活体检测模型-RGB](https://modelscope.cn/models/damo/cv_manual_face-liveness_flrgb/summary)、[人脸活体检测模型-IR](https://modelscope.cn/models/damo/cv_manual_face-liveness_flir/summary)、[静默人脸活体检测模型-炫彩](https://modelscope.cn/models/damo/cv_manual_face-liveness_flxc/summary)。'."\n" ."\n" .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" - .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。', - ], - 'EnhanceFace' => [ - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'http', - 'https', + .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。'."\n" + .'- 平台不存储用户在使用服务过程中涉及的原始人脸图片或文件信息。', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-facebody:DetectLivingFace', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + ], + 'DetectPedestrian' => [ + 'methods' => ['post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -3836,47 +3129,46 @@ [ 'name' => 'ImageURL', 'in' => 'formData', - 'schema' => [ - 'description' => '图像URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。'."\n" - .'输入限制：'."\n" - ."\n" - .'- 图像格式：JPEG、JPG、BMP、PNG。'."\n" - .'- 图像大小：不超过3 MB。'."\n" - .'- 图像分辨率：大于32×32像素，小于2048×2048像素（最长边小于等于2047像素），人脸占比不低于64×64像素。'."\n" - .'- URL地址中不能包含中文字符。'."\n" - .'- 输入图像需包含人脸。'."\n" - .'- 输入图像中人脸数量不宜超过10个，否则只处理面积最大的前10个人脸。'."\n" - .'- 输入图像中的人脸不宜存在划痕、破损等，算法暂不支持此类修复。'."\n" - .'- 输入图像中的人脸质量不宜过于清晰或者分辨率过高，否则可能导致反向降质。'."\n" - ."\n" - .'> 当图像分辨率超过最大限制时，请先将图片进行缩放，调整图片大小，具体请参见[图片缩放](~~44688~~)。', - 'type' => 'string', - 'required' => true, - 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/EnhanceFace/EnhanceFace1.png', - 'isFileTransferUrl' => true, - ], + 'schema' => ['description' => '图像URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。'."\n" + .'输入限制：'."\n" + ."\n" + .'- 图像格式：JPEG、JPG、PNG、BMP。'."\n" + .'- 图像大小：不超过4 MB。'."\n" + .'- 图像分辨率：分辨率大于32×32， 分辨率小于2000×2000像素，最长边小于2000像素， 人脸占比不低于64×64像素。'."\n" + .'- URL地址中不能包含中文字符。'."\n" + .'> 当图像分辨率超过最大限制时，请先将图片进行缩放，调整图片大小，具体请参见[图片缩放](~~44688~~)。', 'type' => 'string', 'required' => true, 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/DetectPedestrian/DetectPedestrian8.jpg', 'isFileTransferUrl' => true], ], ], 'responses' => [ 200 => [ 'schema' => [ + 'description' => '1', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '8B031473-6773-4A4C-AF33-A233758E6E98', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '45DBA494-6250-42C4-80D1-7CF19BDD2CB1'], 'Data' => [ - 'description' => '返回的结果数据内容。', + 'description' => '返回的数据内容。', 'type' => 'object', 'properties' => [ - 'ImageURL' => [ - 'description' => '人脸修复增强后的结果图URL地址。'."\n" - .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。', - 'type' => 'string', - 'example' => 'http://vibktprfx-prod-prod-aic-vd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/face-enhancement/2021-11-30/8e34b61c-abcf-4708-9d9d-6501968ee806/20211130_080644126523_47ct9w3pgh.jpg?Expires=1638261404&OSSAccessKeyId=LTAI****************&Signature=2wPdcuCmr%2F86WpBL3HQJw5uCFl****', + 'Elements' => [ + 'description' => '人体检测框的集合。', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'Type' => ['description' => '检测框对应的检测结果类型。仅返回参数值`person`。', 'type' => 'string', 'example' => 'person'], + 'Boxes' => [ + 'description' => '1', + 'type' => 'array', + 'items' => ['description' => '检测框坐标，格式为`[left, top, right, bottom]`。其中`left`为人体检测框左上角横坐标，`top`为人体检测框左上角纵坐标，`right`为人体检测框右下角横坐标，`bottom`为人体检测框右下角纵坐标。', 'type' => 'integer', 'format' => 'int32', 'example' => '[326, 293, 500, 546 ]'], + ], + 'Score' => ['description' => '检测框的置信度，取值范围为0~1，得分越接近1表示人体框准确的概率越大。', 'type' => 'number', 'format' => 'float', 'example' => '0.999'], + ], + 'description' => '', + ], ], + 'Width' => ['description' => '输入图像的宽度，单位像素。', 'type' => 'integer', 'format' => 'int32', 'example' => '899'], + 'Height' => ['description' => '输入图像的高度，单位像素。', 'type' => 'integer', 'format' => 'int32', 'example' => '599'], ], ], ], @@ -3885,67 +3177,65 @@ ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'ParameterError', - 'errorMessage' => 'The parameter is invalid. Please check again.', - ], + ['errorCode' => 'ParameterError', 'errorMessage' => 'The parameter is invalid. Please check again.', 'description' => '参数错误，请检查参数值'], ], 403 => [ - [ - 'errorCode' => 'AuthFailed', - 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', - ], + ['errorCode' => 'AuthFailed', 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', 'description' => '授权失败，请检查RAM权限配置'], ], 408 => [ - [ - 'errorCode' => 'Timeout', - 'errorMessage' => 'The request has timed out.', - ], + ['errorCode' => 'Timeout', 'errorMessage' => 'The request has timed out.', 'description' => '请求超时，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'The service is unavailable.', - ], + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'The service is unavailable.', 'description' => '服务不可用，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"8B031473-6773-4A4C-AF33-A233758E6E98\\",\\n \\"Data\\": {\\n \\"ImageURL\\": \\"http://vibktprfx-prod-prod-aic-vd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/face-enhancement/2021-11-30/8e34b61c-abcf-4708-9d9d-6501968ee806/20211130_080644126523_47ct9w3pgh.jpg?Expires=1638261404&OSSAccessKeyId=LTAI****************&Signature=2wPdcuCmr%2F86WpBL3HQJw5uCFl****\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n 8B031473-6773-4A4C-AF33-A233758E6E98\\n \\n http://vibktprfx-prod-prod-aic-vd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/face-enhancement/2021-11-30/8e34b61c-abcf-4708-9d9d-6501968ee806/20211130_080644126523_47ct9w3pgh.jpg?Expires=1638261404&OSSAccessKeyId=LTAI****************&Signature=2wPdcuCmr%2F86WpBL3HQJw5uCFl****\\n \\n","errorExample":""}]', - 'title' => '人脸修复增强', - 'summary' => '本文介绍人脸修复增强EnhanceFace的语法及示例。', + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"45DBA494-6250-42C4-80D1-7CF19BDD2CB1\\",\\n \\"Data\\": {\\n \\"Elements\\": [\\n {\\n \\"Type\\": \\"person\\",\\n \\"Boxes\\": [\\n 0\\n ],\\n \\"Score\\": 0.999\\n }\\n ],\\n \\"Width\\": 899,\\n \\"Height\\": 599\\n }\\n}","errorExample":""},{"type":"xml","example":"45DBA494-6250-42C4-80D1-7CF19BDD2CB1\\n\\n 599\\n \\n 0.999\\n person\\n 326\\n 293\\n 500\\n 546\\n \\n \\n 0.998\\n person\\n 181\\n 156\\n 425\\n 534\\n \\n \\n 0.993\\n person\\n 515\\n 300\\n 705\\n 549\\n \\n \\n 0.986\\n person\\n 661\\n 129\\n 797\\n 506\\n \\n \\n 0.959\\n person\\n 511\\n 271\\n 572\\n 451\\n \\n 899\\n","errorExample":""}]', + 'title' => '人体检测', + 'summary' => '本文介绍人体检测DetectPedestrian的语法及示例。', 'description' => '## 功能描述'."\n" - .'人脸修复增强能力可以对输入图像中的人脸进行裁剪、对齐、细节增强，最后再融合回原图。'."\n" - .'关于该接口功能的示例图如下：'."\n" - .'- 输入原图：'."\n" - .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20221108/gsfa/EnhanceFace.jpg" width="300)'."\n" - .'- 输出增强后示意图：'."\n" - .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20221108/nbbg/EnhanceFacezengqiang.png" width="300)'."\n" - ."\n" - .'> - 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" - .'- 当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击[立即试用](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=EnhanceFace)对该能力进行更直观试用以及在线购买。'."\n" - .'- 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。'."\n" + .'人体检测能力可以检测图像中的所有人体。主要适用于监控场景，建议人体占图片的比例小于1/2。产品支持以下功能：'."\n" + ."\n" + .'- 人体检测：返回图像中人体矩形框位置，并输出图像中人体所在的坐标位置。'."\n" + .'- 人体信息：输出图像中人物置信度；可同时识别图片中多个人体。'."\n" + ."\n" + .'关于该接口功能的示例图如下：'."\n" + .'- 输入原图'."\n" + .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20221111/unpw/DetectPedestrian.png" width="500)'."\n" + .'- 输出结果图'."\n" + .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20221111/xqtw/DetectPedestrianresult.png" width="500)'."\n" + ."\n" + .'> - 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" + .'- 当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击[立即试用](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=DetectPedestrian)对该能力进行更直观试用以及在线购买。'."\n" + .'- 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。'."\n" ."\n" .'## 应用场景'."\n" ."\n" - .'- 拍摄素材增强：对拍摄时因曝光不足、对焦不准、手抖模糊的照片，通过人脸修复增强技术，可以弥补拍摄时的不足，对照片进行修复。'."\n" - .'- 老照片修复：对早期拍摄的分辨率低或不清晰的人像照片，进行修复增强，可以在保留老照片质感的同时提升人像清晰度。'."\n" + .'- 记录有人视频：在摄像头录像中，通过人体检测，可以过滤无人的视频段，仅保留有人员出现的视频，减少视频存储量。'."\n" + .'- 人流统计：结合多帧人体检测结果，进行过线判断，可以运用于商场、景区、交通枢纽的人流量统计。'."\n" + .'- 在岗检测：检测固定工作岗位上是否有人员在岗。'."\n" + .'- 智能办公室：检测办公室内是否有人，智能控制照明灯或空调的开关，节约能源，绿色环保。'."\n" ."\n" .'## 特色优势'."\n" ."\n" - .'- 细节增强：可增强原图细节，在原片质量不足的情况下，依然能恢复出部分细节，提升照片质量。'."\n" - .'- 人像一致性：在提升细节的同时，保留与原始人像的一致性与真实感。'."\n" + .'- 支持多角度检测：针对正面，侧面，高角度等拍摄的图像，都可以准确检测出人体。'."\n" + .'- 抗遮挡能力强：对于人体被少部分遮挡的场景，仍可以准确检测出人体。'."\n" ."\n" .'## 接入指引'."\n" .'1. 注册阿里云账号：打开[阿里云官网](https://www.aliyun.com)，在阿里云官网右上角，单击**立即注册**，按照操作提示完成账号注册。'."\n" .'2. 开通能力：请确保您已开通[人脸人体服务](https://vision.aliyun.com/facebody)，若未开通服务请[立即开通](https://common-buy.aliyun.com/?commodityCode=viapi_facebody_public_cn#/open)。'."\n" + ."\n" .'> 本能力支持企业或个人认证用户开通。更多实名认证操作信息，请参见[实名认证](https://help.aliyun.com/knowledge_list/37170.html)。'."\n" + ."\n" .'3. 创建AccessKey：请确保您已[创建AccessKey](~~175144~~)，如果您使用的是子账号AccessKey，您需要给子账号赋予AliyunVIAPIFullAccess权限，具体操作，请参见[RAM授权](~~145025~~)。'."\n" - .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/facebody/2019-12-30/EnhanceFace?lang=JAVA&sdkStyle=dara¶ms=%7B%22ImageURL%22%3A%22http%3A%2F%2Fviapi-test.oss-cn-shanghai.aliyuncs.com%2Fviapi-3.0domepic%2Ffacebody%2FEnhanceFace%2FEnhanceFace1.png%22%7D&tab=DEMO)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" + .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/facebody/2019-12-30/DetectPedestrian?lang=JAVA&sdkStyle=old¶ms=%7B%22ImageURL%22%3A%22http%3A%2F%2Fviapi-test.oss-cn-shanghai.aliyuncs.com%2Fviapi-3.0domepic%2Ffacebody%2FDetectPedestrian%2FDetectPedestrian1.jpg%22%7D&tab=DEMO)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" .'5. 开发接入步骤：'."\n" - .'- 在[SDK总览](~~145033~~)中选择您要接入使用的SDK语言。'."\n" - .'- 在对应语言的SDK文档中找到AI类目为人脸人体（facebody）的SDK包进行安装。'."\n" - .'- 参考文档中提供的示例代码进行适当修改后调用。'."\n" + .' - 在[SDK总览](~~145033~~)中选择您要接入使用的SDK语言。'."\n" + .' - 在对应语言的SDK文档中找到AI类目为人脸人体（facebody）的SDK包进行安装。'."\n" + .' - 参考文档中提供的示例代码进行适当修改后调用。'."\n" ."\n" - .'6. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" + .'6. 示例代码：该能力常用语言的示例代码，请参见[人体检测示例代码](~~601107~~)。'."\n" + ."\n" + .'7. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" .'- [Web前端直接调用](~~467779~~)'."\n" .'- [小程序场景下直接调用](~~467780~~)'."\n" .'- [Android端直接调用](~~467781~~)'."\n" @@ -3953,39 +3243,51 @@ ."\n" .'## 输入限制'."\n" ."\n" - .'- 图像格式：JPEG、JPG、BMP、PNG。'."\n" + .'- 图像格式：JPEG、JPG、PNG、BMP。'."\n" + ."\n" .'- 图像大小：不超过3 MB。'."\n" - .'- 图像分辨率：大于32×32像素，小于2048×2048像素（最长边小于等于2047像素），人脸占比不低于64×64像素。'."\n" + ."\n" + .'- 图像分辨率：分辨率大于32×32像素， 分辨率小于2000×2000像素，最长边小于2000像素，人脸占比不低于64×64像素。'."\n" + ."\n" .'- URL地址中不能包含中文字符。'."\n" - .'- 输入图像需包含人脸。'."\n" - .'- 输入图像中人脸数量不宜超过10个，否则只处理面积最大的前10个人脸。'."\n" - .'- 输入图像中的人脸不宜存在划痕、破损等，算法暂不支持此类修复。'."\n" - .'- 输入图像中的人脸质量不宜过于清晰或者分辨率过高，否则可能导致反向降质。'."\n" ."\n" .'> 当图像分辨率超过最大限制时，请先将图片进行缩放，调整图片大小，具体请参见[图片缩放](~~44688~~)。'."\n" ."\n" .'## 计费说明'."\n" - .'关于人脸修复增强的计费方式及报价，请参见[计费介绍](~~184049~~)。'."\n" - ."\n" - .'> 下方调试接口为付费接口，如需免费体验调试请前往[体验中心](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=EnhanceFace)。', - 'requestParamsDescription' => ' ', + .'关于人体检测的计费方式及报价，请参见[计费介绍](~~184049~~)。'."\n" + .'> 下方调试接口为付费接口，如需免费体验调试请前往[体验中心](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=DetectPedestrian)。', 'responseParamsDescription' => '## SDK参考'."\n" - .'阿里云视觉AI人脸人体类目下的人脸修复增强能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。', + .'阿里云视觉AI人脸人体类目下的人体检测能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。'."\n" + ."\n" + .'## 示例代码'."\n" + .'该能力常用语言的示例代码，请参见[人体检测示例代码](~~601107~~)。', 'extraInfo' => '## 错误码'."\n" - .'关于人脸修复增强的错误码，详情请参见[常见错误码](~~146756~~)。'."\n" + .'关于人体检测的错误码 ，详情请参见[常见错误码](~~146756~~)。'."\n" + ."\n" + .'## 开源模型体验'."\n" + .'更多开源免费模型体验及下载，详见魔搭社区：[人体检测-通用-Base](https://modelscope.cn/models/damo/cv_resnet18_human-detection/summary)和[实时人体检测-通用](https://modelscope.cn/models/damo/cv_tinynas_human-detection_damoyolo/summary)。'."\n" ."\n" .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。', - ], - 'RecognizeFace' => [ - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'http', - 'https', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-facebody:DetectPedestrian', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + ], + 'DetectVideoLivingFace' => [ + 'methods' => ['post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -3996,456 +3298,226 @@ 'systemTags' => [], 'parameters' => [ [ - 'name' => 'ImageURL', - 'in' => 'formData', - 'schema' => [ - 'description' => '图像URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。'."\n" - ."\n" - .'> - 推荐新版本调用方式为只输入图片，当只传入ImageURL的时候所有接口数据都会返回，新版本支持返回最多10张人脸的数据。'."\n" - ."\n" - .'- 兼容老版本接口对布尔值入参和MaxFaceNumber的支持逻辑，当传入任意一个支持的布尔值入参或MaxFaceNumber以控制返回的数据时，只会返回设置了布尔值入参且为true的数据，这种调用方式不返回布尔值入参支持范围外的数据（Landmarks，LandmarkCount，PoseList，Pupils）。', - 'type' => 'string', - 'required' => true, - 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/RecognizeFace/RecognizeFace1.png', - 'isFileTransferUrl' => true, - ], - ], - [ - 'name' => 'Age', + 'name' => 'VideoUrl', 'in' => 'formData', - 'schema' => [ - 'description' => '兼容老版本接口，用来控制是否需要返回人脸年龄结果，取值true或false，默认false。', - 'type' => 'boolean', - 'required' => false, - 'example' => 'false', - ], + 'schema' => ['description' => '输入待检测人脸的视频URL。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。', 'type' => 'string', 'required' => true, 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/DetectVideoLivingFace/DetectVideoLivingFace1.mp4', 'isFileTransferUrl' => true], ], - [ - 'name' => 'Gender', - 'in' => 'formData', + ], + 'responses' => [ + 200 => [ 'schema' => [ - 'description' => '兼容老版本接口，用来控制是否需要返回人脸性别结果，取值true或false，默认false。', - 'type' => 'boolean', - 'required' => false, - 'example' => 'false', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '8E92F28B-F889-48CB-9FCC-3207CFA2215E'], + 'Data' => [ + 'description' => '返回的结果数据内容。', + 'type' => 'object', + 'properties' => [ + 'Elements' => [ + 'description' => '检测结果数据。', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'Rect' => [ + 'type' => 'array', + 'items' => ['description' => '检测出的人脸位置。', 'type' => 'integer', 'format' => 'int32', 'example' => '[374, 6, 493,106 ]'], + 'description' => '', + ], + 'LiveConfidence' => ['description' => '活体的置信度，取值范围为0~1。', 'type' => 'number', 'format' => 'float', 'example' => '0.72464925050735474'], + 'FaceConfidence' => ['description' => '人脸的置信度，取值范围为0~1。', 'type' => 'number', 'format' => 'float', 'example' => '0.84644949436187744'], + ], + 'description' => '', + ], + ], + ], + ], + ], + 'description' => '', ], ], - [ - 'name' => 'Hat', - 'in' => 'formData', - 'schema' => [ - 'description' => '兼容老版本接口，用来控制是否需要返回人脸帽子结果，取值true或false，默认false。', - 'type' => 'boolean', - 'required' => false, - 'example' => 'false', - ], + ], + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'ParameterError', 'errorMessage' => 'The parameter is invalid. Please check again.', 'description' => '参数错误，请检查参数值'], ], - [ - 'name' => 'Glass', - 'in' => 'formData', - 'schema' => [ - 'description' => '兼容老版本接口，用来控制是否需要返回人脸眼镜结果，取值true或false，默认false。', - 'type' => 'boolean', - 'required' => false, - 'example' => 'false', - ], + 403 => [ + ['errorCode' => 'AuthFailed', 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', 'description' => '授权失败，请检查RAM权限配置'], ], - [ - 'name' => 'Beauty', - 'in' => 'formData', - 'schema' => [ - 'description' => '兼容老版本接口，用来控制是否需要返回人脸颜值结果，取值true或false，默认false。', - 'type' => 'boolean', - 'required' => false, - 'example' => 'false', - ], + 408 => [ + ['errorCode' => 'Timeout', 'errorMessage' => 'The request has timed out.', 'description' => '请求超时，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], - [ - 'name' => 'Expression', - 'in' => 'formData', - 'schema' => [ - 'description' => '兼容老版本接口，用来控制是否需要返回人脸表情结果，取值true或false，默认false。', - 'type' => 'boolean', - 'required' => false, - 'example' => 'false', - ], + 503 => [ + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'The service is unavailable.', 'description' => '服务不可用，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], - [ - 'name' => 'Mask', - 'in' => 'formData', - 'schema' => [ - 'description' => '兼容老版本接口，用来控制是否需要返回人脸口罩结果，取值true或false，默认false。', - 'type' => 'boolean', - 'required' => false, - 'example' => 'false', + ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"8E92F28B-F889-48CB-9FCC-3207CFA2215E\\",\\n \\"Data\\": {\\n \\"Elements\\": [\\n {\\n \\"Rect\\": [\\n 0\\n ],\\n \\"LiveConfidence\\": 0.7246492505073547,\\n \\"FaceConfidence\\": 0.8464494943618774\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"8E92F28B-F889-48CB-9FCC-3207CFA2215E\\n\\n \\n 0.84644949436187744\\n 374\\n 6\\n 493\\n 106\\n 0.72464925050735474\\n \\n","errorExample":""}]', + 'title' => '视频活体检测', + 'summary' => '本文介绍视频活体检测DetectVideoLivingFace的语法及示例。', + 'description' => '## 功能描述'."\n" + .'视频活体检测能力可以检测输入视频中的人脸来自直接拍摄还是翻拍。当视频中出现多个人脸时，对画面中面积最大的人脸进行判断，需要确保待检测人脸五官清晰可见。'."\n" + ."\n" + .'> - 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" + .'- 当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击[立即试用](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=DetectVideoLivingFace)对该能力进行更直观试用以及在线购买。'."\n" + .'- 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。'."\n" + ."\n" + .'## 接入指引'."\n" + .'1. 注册阿里云账号：打开[阿里云官网](https://www.aliyun.com)，在阿里云官网右上角，单击**立即注册**，按照操作提示完成账号注册。'."\n" + .'2. 开通能力：请确保您已开通[人脸人体服务](https://vision.aliyun.com/facebody)，若未开通服务请[立即开通](https://common-buy.aliyun.com/?commodityCode=viapi_facebody_public_cn#/open)。'."\n" + .'> 本能力支持企业或个人认证用户开通。更多实名认证操作信息，请参见[实名认证](https://help.aliyun.com/knowledge_list/37170.html)。'."\n" + ."\n" + .'3. 创建AccessKey：请确保您已[创建AccessKey](~~175144~~)，如果您使用的是子账号AccessKey，您需要给子账号赋予AliyunVIAPIFullAccess权限，具体操作，请参见[RAM授权](~~145025~~)。'."\n" + .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/facebody/2019-12-30/DetectVideoLivingFace?lang=JAVA&sdkStyle=dara¶ms=%7B%22Type%22%3A0%2C%22VideoUrl%22%3A%22http%3A%2F%2Fviapi-test.oss-cn-shanghai.aliyuncs.com%2Fviapi-3.0domepic%2Ffacebody%2FDetectVideoLivingFace%2FDetectVideoLivingFace1.mp4%22%7D&tab=DEMO)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" + .'5. 开发接入步骤：'."\n" + .'- 在[SDK总览](~~145033~~)中选择您要接入使用的SDK语言。'."\n" + .'- 在对应语言的SDK文档中找到AI类目为人脸人体（facebody）的SDK包进行安装。'."\n" + .'- 参考文档中提供的示例代码进行适当修改后调用。'."\n" + ."\n" + .'6. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" + .'- [Web前端直接调用](~~467779~~)'."\n" + .'- [小程序场景下直接调用](~~467780~~)'."\n" + .'- [Android端直接调用](~~467781~~)'."\n" + .'- [iOS端直接调用](~~467782~~)'."\n" + ."\n" + .'## 输入限制'."\n" + .'- 视频格式：MP4、AVI。'."\n" + .'- 视频大小：不超过30 MB。'."\n" + .'- 视频分辨率：大于64×64像素以上，视频长度大于3秒。其中人脸尺寸建议大于64×64像素。'."\n" + .'- 建议输入的视频帧率不低于15帧/秒。'."\n" + .'- URL地址中不能包含中文字符。'."\n" + ."\n" + .'## 计费说明'."\n" + .'关于视频活体检测的计费方式及报价，请参见[计费介绍](~~184049~~)。'."\n" + ."\n" + .'> 下方调试接口为付费接口，如需免费体验调试请前往[体验中心](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=DetectVideoLivingFace)。', + 'requestParamsDescription' => ' ', + 'responseParamsDescription' => '## SDK参考'."\n" + .'阿里云视觉AI人脸人体类目下的视频活体检测能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。', + 'extraInfo' => '## 错误码'."\n" + .'关于视频活体检测的错误码，详情请参见[常见错误码](~~146756~~)。'."\n" + ."\n" + .'## 开源模型体验'."\n" + .'更多开源免费模型体验及下载，详见魔搭社区：[人脸活体检测模型-RGB](https://modelscope.cn/models/damo/cv_manual_face-liveness_flrgb/summary)、[人脸活体检测模型-IR](https://modelscope.cn/models/damo/cv_manual_face-liveness_flir/summary)、[静默人脸活体检测模型-炫彩](https://modelscope.cn/models/damo/cv_manual_face-liveness_flxc/summary)。'."\n" + ."\n" + .'## 安全声明'."\n" + .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" + .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。'."\n" + .'- 平台不存储用户在使用服务过程中涉及的原始人脸图片或文件信息。', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-facebody:DetectVideoLivingFace', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], ], ], + ], + ], + 'EnhanceFace' => [ + 'methods' => ['post'], + 'schemes' => ['http', 'https'], + 'security' => [ [ - 'name' => 'Quality', - 'in' => 'formData', - 'schema' => [ - 'description' => '兼容老版本接口，用来控制是否需要返回人脸质量，取值true或false，默认false。', - 'type' => 'boolean', - 'required' => false, - 'example' => 'false', - ], + 'AK' => [], ], + ], + 'operationType' => 'read', + 'deprecated' => false, + 'systemTags' => [], + 'parameters' => [ [ - 'name' => 'MaxFaceNumber', + 'name' => 'ImageURL', 'in' => 'formData', - 'schema' => [ - 'description' => '兼容老版本接口，用来设置图片中人脸的最大返回数量，取值范围1~10，默认为1。若想返回多个人脸检测结果，请正确设置。默认按返回参数FaceProbabilityList进行降序排列。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '1', - ], + 'schema' => ['description' => '图像URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。'."\n" + .'输入限制：'."\n" + ."\n" + .'- 图像格式：JPEG、JPG、BMP、PNG。'."\n" + .'- 图像大小：不超过3 MB。'."\n" + .'- 图像分辨率：大于32×32像素，小于2048×2048像素（最长边小于等于2047像素），人脸占比不低于64×64像素。'."\n" + .'- URL地址中不能包含中文字符。'."\n" + .'- 输入图像需包含人脸。'."\n" + .'- 输入图像中人脸数量不宜超过10个，否则只处理面积最大的前10个人脸。'."\n" + .'- 输入图像中的人脸不宜存在划痕、破损等，算法暂不支持此类修复。'."\n" + .'- 输入图像中的人脸质量不宜过于清晰或者分辨率过高，否则可能导致反向降质。'."\n" + ."\n" + .'> 当图像分辨率超过最大限制时，请先将图片进行缩放，调整图片大小，具体请参见[图片缩放](~~44688~~)。', 'type' => 'string', 'required' => true, 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/EnhanceFace/EnhanceFace1.png', 'isFileTransferUrl' => true], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'description' => '1', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '8251C88E-8273-4DBF-94FB-A6BCB268CEA2', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '8B031473-6773-4A4C-AF33-A233758E6E98'], 'Data' => [ 'description' => '返回的结果数据内容。', 'type' => 'object', 'properties' => [ - 'Pupils' => [ - 'description' => '1', - 'type' => 'array', - 'items' => [ - 'description' => '左右两个瞳孔的中心点坐标和半径，每个人脸6个浮点数，顺序为`[left_iris_cenpt.x, left_iris_cenpt.y, left_iris_radius, right_iris_cenpt.x, right_iris_cenpt.y, right_iris_radis]`。', - 'type' => 'number', - 'format' => 'float', - 'example' => '[397.06,183.99,7.87,487.49,173.85,7.87]', - ], - ], - 'GenderList' => [ - 'description' => '1', - 'type' => 'array', - 'items' => [ - 'description' => '识别到的人脸性别。如有多个人脸，则依次返回。'."\n" - ."\n" - .'- 0：女性'."\n" - ."\n" - .'- 1：男性'."\n" - ."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - ], - 'Expressions' => [ - 'description' => '1', - 'type' => 'array', - 'items' => [ - 'description' => '人脸识别的表情结果。包括：'."\n" - ."\n" - .'- 0：中性'."\n" - ."\n" - .'- 1：微笑', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '0', - ], - ], - 'DenseFeatures' => [ - 'description' => '1', - 'type' => 'array', - 'items' => [ - 'description' => '人脸识别返回的特征。如有多个人脸，则依次返回。'."\n" - ."\n" - .'> 由于版本升级，该字段废弃，返回数据无实际意义。', - 'type' => 'string', - 'example' => '[-0.04283177852630615, 0.01496131718158722, 0.08304227143526077, -0.006072732154279947, -0.012721054255962372, -0.024241730570793152, -0.03138406202197075, 0.006191537249833345, 0.017898650839924812, -0.03185232728719711, -0.02717948891222477, 0.028409384191036224, -0.03557640686631203, -0.02255111373960972, -0.030578967183828354, 0.011586467735469341, -0.005520580802112818, -0.0061850580386817455, -0.023915085941553116, 0.014204374514520168]', - ], - ], - 'FaceCount' => [ - 'description' => '检测出来的人脸个数。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'Landmarks' => [ - 'description' => '1', - 'type' => 'array', - 'items' => [ - 'description' => '人脸的特征点定位结果，每个人脸返回一组特征点位置，表示方式为`（x0, y0, x1, y1, ……）`。如有多个人脸，则依次返回，返回定位浮点数。', - 'type' => 'number', - 'format' => 'float', - 'example' => '[371.31,170.54,421.14,162.72,395.33,156.36,396.06,167.71,377.92,164.47,386.19,158.26,404.89,156.61,413.89,157.87,378.82,171,387.24,168.73,404.84,167.34,413.57,167.26,458.27,159.5,521.24,165.59,490.58,......]', - ], - ], - 'LandmarkCount' => [ - 'description' => '人脸检测的特征点数目，目前固定为105点。依次为：眉毛24点，眼睛32点，鼻子6点，嘴巴34点，外轮廓9点。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '105', - ], - 'Qualities' => [ - 'description' => '人脸质量情况，分数越高表示越有利于识别。', - 'type' => 'object', - 'properties' => [ - 'ScoreList' => [ - 'description' => '1', - 'type' => 'array', - 'items' => [ - 'description' => '质量综合分数，分数越高越有利于识别，取值范围\\(0,100]。如有多张人脸，则依次返回。在识别时，推荐设置阈值大于等于85（您可以按实际应用场景判断设置阈值与否及相应阈值大小），大于85代表图片综合质量越高，小于85代表图片综合质量越低。'."\n", - 'type' => 'number', - 'format' => 'float', - 'example' => '87.47', - ], - ], - 'BlurList' => [ - 'description' => '1', - 'type' => 'array', - 'items' => [ - 'description' => '人脸模糊度对识别的影响分数，分数越高越有利于识别，取值范围\\(0,100]。如有多个人脸，则依次顺延。在识别时，推荐设置阈值大于等于85（您可以按实际应用场景判断设置阈值与否及相应阈值大小），大于85代表图片模糊的概率越低，小于85代表图片模糊的概率越高。', - 'type' => 'number', - 'format' => 'float', - 'example' => '99.99', - ], - ], - 'FnfList' => [ - 'description' => '1', - 'type' => 'array', - 'items' => [ - 'description' => '目标是否为人脸及其对识别的影响分数，分数越高越有利于识别，取值范围\\(0,100]。如有多个人脸，则依次顺延。在识别时，推荐设置阈值大于等于85（您可以按实际应用场景判断设置阈值与否及相应阈值大小），大于85代表图片是人脸的概率越高，小于85代表图片不是人脸的概率越低。', - 'type' => 'number', - 'format' => 'float', - 'example' => '100', - ], - ], - 'GlassList' => [ - 'description' => '1', - 'type' => 'array', - 'items' => [ - 'description' => '眼镜等上半脸遮挡对识别的影响分数，分数越高越有利于识别，取值范围\\(0,100]。如有多个人脸，则依次顺延。在识别时，推荐设置阈值大于等于85（您可以按实际应用场景判断设置阈值与否及相应阈值大小），大于85代表戴眼镜的概率越低，小于85代表戴眼镜的概率越高。', - 'type' => 'number', - 'format' => 'float', - 'example' => '97.59', - ], - ], - 'IlluList' => [ - 'description' => '1', - 'type' => 'array', - 'items' => [ - 'description' => '光照对识别的影响分数，分数越高越有利于识别，取值范围\\(0,100]。如有多个人脸，则依次顺延。在识别时，推荐设置阈值大于等于85（您可以按实际应用场景判断设置阈值与否及相应阈值大小），大于85代表图片光照好的概率越高，小于85代表图片光照好的概率越低。', - 'type' => 'number', - 'format' => 'float', - 'example' => '99.97', - ], - ], - 'MaskList' => [ - 'description' => '1', - 'type' => 'array', - 'items' => [ - 'description' => '口罩等下半脸遮挡对识别的影响分数，分数越高越有利于识别，取值范围\\(0,100]。如有多个人脸，则依次顺延。在识别时，推荐设置阈值大于等于85（您可以按实际应用场景判断设置阈值与否及相应阈值大小），大于85代表戴口罩概率越低，小于85代表戴口罩概率越高。', - 'type' => 'number', - 'format' => 'float', - 'example' => '93.33', - ], - ], - 'NoiseList' => [ - 'description' => '1', - 'type' => 'array', - 'items' => [ - 'description' => '图片噪声对识别的影响分数，分数越高越有利于识别，取值范围\\(0,100]。如有多个人脸，则依次顺延。在识别时，推荐设置阈值大于等于85（您可以按实际应用场景判断设置阈值与否及相应阈值大小），大于85代表图片有噪声的概率越低，小于85代表图片有噪声的概率越高。', - 'type' => 'number', - 'format' => 'float', - 'example' => '99.73', - ], - ], - 'PoseList' => [ - 'description' => '1', - 'type' => 'array', - 'items' => [ - 'description' => '姿态对识别的影响分数，分数越高越有利于识别，取值范围\\(0,100]。如有多个人脸，则依次顺延。在识别时，推荐设置阈值大于等于85（您可以按实际应用场景判断设置阈值与否及相应阈值大小），大于85代表人脸姿态正面的概率越高，小于85代表人脸姿态正面的概率越低。', - 'type' => 'number', - 'format' => 'float', - 'example' => '11.57', - ], - ], - ], - ], - 'BeautyList' => [ - 'description' => '1', - 'type' => 'array', - 'items' => [ - 'description' => '颜值分数，分值越高颜值越高，取值范围\\(0-100]。', - 'type' => 'number', - 'format' => 'float', - 'example' => '48', - ], - ], - 'HatList' => [ - 'description' => '1', - 'type' => 'array', - 'items' => [ - 'description' => '人脸是否佩戴帽子。'."\n" - ."\n" - .'- 0：无帽子'."\n" - ."\n" - .'- 1：有帽子', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '0', - ], - ], - 'FaceProbabilityList' => [ - 'description' => '1', - 'type' => 'array', - 'items' => [ - 'description' => '返回人脸检测的概率，取值范围0~1。如有多个人脸，则依次返回。例如有两个人脸则返回`[face_prob1, face_prob2]`。', - 'type' => 'number', - 'format' => 'float', - 'example' => '0.95', - ], - ], - 'Glasses' => [ - 'description' => '1', - 'type' => 'array', - 'items' => [ - 'description' => '人脸是否佩戴眼镜。'."\n" - ."\n" - .'- 0：不戴眼镜'."\n" - ."\n" - .'- 1：佩戴普通眼镜'."\n" - ."\n" - .'- 2：佩戴墨镜', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - ], - 'FaceRectangles' => [ - 'description' => '1', - 'type' => 'array', - 'items' => [ - 'description' => '返回人脸矩形框，分别是`[left, top, width, height]`。如有多个人脸，则依次顺延，返回矩形框。例如有两个人脸则返回`[left1, top1, width1, height1, left2, top2, width2, height2]`。'."\n" - .'left-top: 表示以图片左上角为坐标原点，目标框所对应的左上角点位置（x,y），表示框的第一个点距离图片左边界x像素，距离上边界y个像素。'."\n" - .'width-height：表示目标框的宽和高。'."\n" - .'目标框面积为width*height，目标框右下角坐标为（left+width,top+height）。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '[356,84,211,278]', - ], - ], - 'PoseList' => [ - 'description' => '1', - 'type' => 'array', - 'items' => [ - 'description' => '返回人脸姿态，格式为`[yaw, pitch, roll]`。如有多个人脸，则依次返回。'."\n" - ."\n" - .'- yaw为左右角度，取值范围-90~90。'."\n" - ."\n" - .'- pitch为上下角度，取值范围-90~90。'."\n" - ."\n" - .'- roll为平面旋转角度，取值范围-180~180。'."\n" - ."\n", - 'type' => 'number', - 'format' => 'float', - 'example' => '[-12.7,7.48,0.12]', - ], - ], - 'AgeList' => [ - 'description' => '1', - 'type' => 'array', - 'items' => [ - 'description' => '图片中人脸年龄，取值范围0~100。如有多个人脸，依次返回多个人脸的年龄。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '57', - ], - ], - 'DenseFeatureLength' => [ - 'description' => '人脸识别返回的特征维度，目前固定为1024。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1024', - ], - 'Masks' => [ - 'description' => '1', - 'type' => 'array', - 'items' => [ - 'description' => '人脸是否佩戴口罩。'."\n" - ."\n" - .'- 0：未佩戴口罩'."\n" - .'- 1：佩戴口罩'."\n" - .'- 2：未正确佩戴口罩', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '0', - ], - ], + 'ImageURL' => ['description' => '人脸修复增强后的结果图URL地址。'."\n" + .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。', 'type' => 'string', 'example' => 'http://vibktprfx-prod-prod-aic-vd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/face-enhancement/2021-11-30/8e34b61c-abcf-4708-9d9d-6501968ee806/20211130_080644126523_47ct9w3pgh.jpg?Expires=1638261404&OSSAccessKeyId=LTAI****************&Signature=2wPdcuCmr%2F86WpBL3HQJw5uCFl****'], ], ], ], + 'description' => '', ], ], ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'ParameterError', - 'errorMessage' => 'The parameter is invalid. Please check again.', - ], + ['errorCode' => 'ParameterError', 'errorMessage' => 'The parameter is invalid. Please check again.', 'description' => '参数错误，请检查参数值'], ], 403 => [ - [ - 'errorCode' => 'AuthFailed', - 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', - ], + ['errorCode' => 'AuthFailed', 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', 'description' => '授权失败，请检查RAM权限配置'], ], 408 => [ - [ - 'errorCode' => 'Timeout', - 'errorMessage' => 'The request has timed out.', - ], + ['errorCode' => 'Timeout', 'errorMessage' => 'The request has timed out.', 'description' => '请求超时，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'The service is unavailable.', - ], + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'The service is unavailable.', 'description' => '服务不可用，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"8251C88E-8273-4DBF-94FB-A6BCB268CEA2\\",\\n \\"Data\\": {\\n \\"Pupils\\": [\\n 0\\n ],\\n \\"GenderList\\": [\\n 1\\n ],\\n \\"Expressions\\": [\\n 0\\n ],\\n \\"DenseFeatures\\": [\\n \\"[-0.04283177852630615, 0.01496131718158722, 0.08304227143526077, -0.006072732154279947, -0.012721054255962372, -0.024241730570793152, -0.03138406202197075, 0.006191537249833345, 0.017898650839924812, -0.03185232728719711, -0.02717948891222477, 0.028409384191036224, -0.03557640686631203, -0.02255111373960972, -0.030578967183828354, 0.011586467735469341, -0.005520580802112818, -0.0061850580386817455, -0.023915085941553116, 0.014204374514520168]\\"\\n ],\\n \\"FaceCount\\": 1,\\n \\"Landmarks\\": [\\n 0\\n ],\\n \\"LandmarkCount\\": 105,\\n \\"Qualities\\": {\\n \\"ScoreList\\": [\\n 87.47\\n ],\\n \\"BlurList\\": [\\n 99.99\\n ],\\n \\"FnfList\\": [\\n 100\\n ],\\n \\"GlassList\\": [\\n 97.59\\n ],\\n \\"IlluList\\": [\\n 99.97\\n ],\\n \\"MaskList\\": [\\n 93.33\\n ],\\n \\"NoiseList\\": [\\n 99.73\\n ],\\n \\"PoseList\\": [\\n 11.57\\n ]\\n },\\n \\"BeautyList\\": [\\n 48\\n ],\\n \\"HatList\\": [\\n 0\\n ],\\n \\"FaceProbabilityList\\": [\\n 0.95\\n ],\\n \\"Glasses\\": [\\n 1\\n ],\\n \\"FaceRectangles\\": [\\n 0\\n ],\\n \\"PoseList\\": [\\n 0\\n ],\\n \\"AgeList\\": [\\n 57\\n ],\\n \\"DenseFeatureLength\\": 1024,\\n \\"Masks\\": [\\n 0\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n 8251C88E-8273-4DBF-94FB-A6BCB268CEA2\\n \\n 397.06\\n 183.99\\n 7.87\\n 487.49\\n 173.85\\n 7.87\\n 1\\n 0\\n [-0.04283177852630615, 0.01496131718158722, 0.08304227143526077, -0.006072732154279947, -0.012721054255962372, -0.024241730570793152, -0.03138406202197075, 0.006191537249833345, 0.017898650839924812, -0.03185232728719711, -0.02717948891222477, 0.028409384191036224, -0.03557640686631203, -0.02255111373960972, -0.030578967183828354, 0.011586467735469341, -0.005520580802112818, -0.0061850580386817455, -0.023915085941553116, 0.014204374514520168]\\n 1\\n 371.31\\n 170.54\\n 421.14\\n 162.72\\n 395.33\\n 156.36\\n 396.06\\n 167.71\\n 377.92\\n 164.47\\n 386.19\\n 158.26\\n 404.89\\n 156.61\\n 413.89\\n 157.87\\n 378.82\\n 171\\n 387.24\\n 168.73\\n 404.84\\n 167.34\\n 413.57\\n 167.26\\n 458.27\\n 159.5\\n 521.24\\n 165.59\\n 490.58\\n 150.77\\n 490.23\\n 162.28\\n 467.51\\n 153.1\\n 479.01\\n 151.32\\n 502.02\\n 153.2\\n 513.06\\n 159.78\\n 468\\n 163.52\\n 478.98\\n 162.32\\n 501.41\\n 163.93\\n 512.07\\n 166.6\\n 381.98\\n 187.97\\n 419.4\\n 184.68\\n 386.29\\n 184.05\\n 389.33\\n 180.31\\n 394.56\\n 178.97\\n 398.93\\n 176.7\\n 404.67\\n 178.01\\n 410.16\\n 178.29\\n 414.64\\n 181.61\\n 386.62\\n 188.63\\n 390.22\\n 189.61\\n 395.06\\n 189.65\\n 399.35\\n 189.78\\n 404.47\\n 188.86\\n 409.6\\n 187.94\\n 414.35\\n 186.47\\n 467.88\\n 180.89\\n 509.45\\n 179.81\\n 472.7\\n 177.13\\n 476.94\\n 173.17\\n 483.16\\n 172.02\\n 488.5\\n 170.41\\n 494.14\\n 172.17\\n 499.85\\n 173.15\\n 504.05\\n 176.58\\n 473.23\\n 182.31\\n 478.06\\n 183.11\\n 483.77\\n 183.5\\n 488.64\\n 183.77\\n 493.94\\n 183.26\\n 499.41\\n 182.57\\n 503.69\\n 181.14\\n 437.26\\n 181.67\\n 430.77\\n 225.48\\n 434.38\\n 203.34\\n 435.09\\n 245.37\\n 414.99\\n 243.56\\n 463.03\\n 241.47\\n 402.97\\n 282.43\\n 487.32\\n 279.44\\n 404.76\\n 282.21\\n 484.51\\n 279.63\\n 436.81\\n 269.19\\n 428.83\\n 269.46\\n 444.9\\n 269.87\\n 414.07\\n 273.42\\n 466.73\\n 272.4\\n 407.94\\n 277.81\\n 421.38\\n 271.38\\n 455.7\\n 271\\n 477.47\\n 276.08\\n 437.71\\n 290.09\\n 417.1\\n 288.03\\n 464.19\\n 286.36\\n 409.84\\n 284.75\\n 427.92\\n 288.61\\n 450.74\\n 287.81\\n 475.9\\n 282.68\\n 437.36\\n 278.04\\n 437.64\\n 277.63\\n 420.34\\n 278.65\\n 420.04\\n 278.69\\n 460.92\\n 277.64\\n 461.01\\n 277.22\\n 412.68\\n 280.41\\n 412.5\\n 279.99\\n 429.06\\n 278.19\\n 429.05\\n 277.65\\n 448.83\\n 277.82\\n 449.13\\n 276.93\\n 472.58\\n 278.55\\n 472.59\\n 278.16\\n 365.8\\n 192\\n 566.18\\n 185.68\\n 440.54\\n 352.94\\n 372.84\\n 289.96\\n 548.44\\n 300.96\\n 364.88\\n 240.03\\n 565.1\\n 243.91\\n 397.45\\n 334.16\\n 501.07\\n 340.61\\n 105\\n \\n 87.47\\n 99.99\\n 100\\n 97.59\\n 99.97\\n 93.33\\n 99.73\\n 11.57\\n \\n 48\\n 0\\n 0.95\\n 1\\n 356\\n 84\\n 211\\n 278\\n -12.7\\n 7.48\\n 0.12\\n 57\\n 1024\\n 0\\n \\n","errorExample":""}]', - 'title' => '人脸属性识别', - 'summary' => '检测人脸的性别、年龄、表情、眼镜、帽子五种属性，返回人脸的1024维深度学习特征。', + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"8B031473-6773-4A4C-AF33-A233758E6E98\\",\\n \\"Data\\": {\\n \\"ImageURL\\": \\"http://vibktprfx-prod-prod-aic-vd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/face-enhancement/2021-11-30/8e34b61c-abcf-4708-9d9d-6501968ee806/20211130_080644126523_47ct9w3pgh.jpg?Expires=1638261404&OSSAccessKeyId=LTAI****************&Signature=2wPdcuCmr%2F86WpBL3HQJw5uCFl****\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n 8B031473-6773-4A4C-AF33-A233758E6E98\\n \\n http://vibktprfx-prod-prod-aic-vd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/face-enhancement/2021-11-30/8e34b61c-abcf-4708-9d9d-6501968ee806/20211130_080644126523_47ct9w3pgh.jpg?Expires=1638261404&OSSAccessKeyId=LTAI****************&Signature=2wPdcuCmr%2F86WpBL3HQJw5uCFl****\\n \\n","errorExample":""}]', + 'title' => '人脸修复增强', + 'summary' => '本文介绍人脸修复增强EnhanceFace的语法及示例。', 'description' => '## 功能描述'."\n" - .'人脸属性识别能力可以识别检测人脸的性别、年龄、表情、眼镜、帽子五种属性，支持人脸遮挡、光照、模糊度、姿态、噪声综合质量评分，支持检测含有多张人脸的照片属性判断。'."\n" + .'人脸修复增强能力可以对输入图像中的人脸进行裁剪、对齐、细节增强，最后再融合回原图。'."\n" + .'关于该接口功能的示例图如下：'."\n" + .'- 输入原图：'."\n" + .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20221108/gsfa/EnhanceFace.jpg" width="300)'."\n" + .'- 输出增强后示意图：'."\n" + .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20221108/nbbg/EnhanceFacezengqiang.png" width="300)'."\n" ."\n" .'> - 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" - .'- 当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击[立即试用](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=RecognizeFace)对该能力进行更直观试用以及在线购买。'."\n" + .'- 当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击[立即试用](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=EnhanceFace)对该能力进行更直观试用以及在线购买。'."\n" .'- 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。'."\n" ."\n" + .'## 应用场景'."\n" + ."\n" + .'- 拍摄素材增强：对拍摄时因曝光不足、对焦不准、手抖模糊的照片，通过人脸修复增强技术，可以弥补拍摄时的不足，对照片进行修复。'."\n" + .'- 老照片修复：对早期拍摄的分辨率低或不清晰的人像照片，进行修复增强，可以在保留老照片质感的同时提升人像清晰度。'."\n" + ."\n" .'## 特色优势'."\n" ."\n" - .'- 适应能力强：不同照片、人脸尺寸多场景下，覆盖多个年龄段识别。'."\n" - .'- 图片质量打分：支持人脸遮挡、光照、模糊度、姿态、噪声综合质量评分。'."\n" - .'- 平台服务稳定：提供在高并发，大流量下的毫秒级识别响应和保障。'."\n" + .'- 细节增强：可增强原图细节，在原片质量不足的情况下，依然能恢复出部分细节，提升照片质量。'."\n" + .'- 人像一致性：在提升细节的同时，保留与原始人像的一致性与真实感。'."\n" ."\n" .'## 接入指引'."\n" .'1. 注册阿里云账号：打开[阿里云官网](https://www.aliyun.com)，在阿里云官网右上角，单击**立即注册**，按照操作提示完成账号注册。'."\n" .'2. 开通能力：请确保您已开通[人脸人体服务](https://vision.aliyun.com/facebody)，若未开通服务请[立即开通](https://common-buy.aliyun.com/?commodityCode=viapi_facebody_public_cn#/open)。'."\n" .'> 本能力支持企业或个人认证用户开通。更多实名认证操作信息，请参见[实名认证](https://help.aliyun.com/knowledge_list/37170.html)。'."\n" .'3. 创建AccessKey：请确保您已[创建AccessKey](~~175144~~)，如果您使用的是子账号AccessKey，您需要给子账号赋予AliyunVIAPIFullAccess权限，具体操作，请参见[RAM授权](~~145025~~)。'."\n" - .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/facebody/2019-12-30/RecognizeFace?lang=JAVA&sdkStyle=dara¶ms=%7B%22ImageURL%22%3A%22http%3A%2F%2Fviapi-test.oss-cn-shanghai.aliyuncs.com%2Fviapi-3.0domepic%2Ffacebody%2FRecognizeFace%2FRecognizeFace1.png%22%7D&tab=DEMO)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" + .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/facebody/2019-12-30/EnhanceFace?lang=JAVA&sdkStyle=dara¶ms=%7B%22ImageURL%22%3A%22http%3A%2F%2Fviapi-test.oss-cn-shanghai.aliyuncs.com%2Fviapi-3.0domepic%2Ffacebody%2FEnhanceFace%2FEnhanceFace1.png%22%7D&tab=DEMO)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" .'5. 开发接入步骤：'."\n" .'- 在[SDK总览](~~145033~~)中选择您要接入使用的SDK语言。'."\n" .'- 在对应语言的SDK文档中找到AI类目为人脸人体（facebody）的SDK包进行安装。'."\n" .'- 参考文档中提供的示例代码进行适当修改后调用。'."\n" ."\n" - .'6. 示例代码：该能力常用语言的示例代码，请参见[人脸属性识别示例代码](~~465558~~)。'."\n" - .'7. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" + .'6. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" .'- [Web前端直接调用](~~467779~~)'."\n" .'- [小程序场景下直接调用](~~467780~~)'."\n" .'- [Android端直接调用](~~467781~~)'."\n" @@ -4453,219 +3525,85 @@ ."\n" .'## 输入限制'."\n" ."\n" - .'- 图像格式：JPEG、JPG、PNG、BMP。'."\n" - .'- 图像大小：不超过20 MB。'."\n" - .'- 图像分辨率：大于32×32像素，小于4096×4096像素，人脸占比不低于64×64像素。'."\n" + .'- 图像格式：JPEG、JPG、BMP、PNG。'."\n" + .'- 图像大小：不超过3 MB。'."\n" + .'- 图像分辨率：大于32×32像素，小于2048×2048像素（最长边小于等于2047像素），人脸占比不低于64×64像素。'."\n" .'- URL地址中不能包含中文字符。'."\n" + .'- 输入图像需包含人脸。'."\n" + .'- 输入图像中人脸数量不宜超过10个，否则只处理面积最大的前10个人脸。'."\n" + .'- 输入图像中的人脸不宜存在划痕、破损等，算法暂不支持此类修复。'."\n" + .'- 输入图像中的人脸质量不宜过于清晰或者分辨率过高，否则可能导致反向降质。'."\n" ."\n" .'> 当图像分辨率超过最大限制时，请先将图片进行缩放，调整图片大小，具体请参见[图片缩放](~~44688~~)。'."\n" ."\n" .'## 计费说明'."\n" - .'关于人脸属性识别的计费方式及报价，请参见[计费介绍](~~184049~~)。'."\n" - .'> 下方调试接口为付费接口，如需免费体验调试请前往[体验中心](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=RecognizeFace)。', + .'关于人脸修复增强的计费方式及报价，请参见[计费介绍](~~184049~~)。'."\n" + ."\n" + .'> 下方调试接口为付费接口，如需免费体验调试请前往[体验中心](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=EnhanceFace)。', 'requestParamsDescription' => ' ', 'responseParamsDescription' => '## SDK参考'."\n" - .'阿里云视觉AI人脸人体类目下的人脸属性识别能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。'."\n" - ."\n" - .'## 示例代码'."\n" - .'该能力常用语言的示例代码，请参见[人脸属性识别示例代码](~~465558~~)。', + .'阿里云视觉AI人脸人体类目下的人脸修复增强能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。', 'extraInfo' => '## 错误码'."\n" - .'关于人脸属性识别的错误码，详情请参见[常见错误码](~~146756~~)。'."\n" - ."\n" - .'## 开源模型体验'."\n" - .'更多开源免费模型体验及下载，详见魔搭社区：[人脸属性识别模型FairFace](https://modelscope.cn/models/damo/cv_resnet34_face-attribute-recognition_fairface/summary)、[人脸表情识别模型FER](https://modelscope.cn/models/damo/cv_vgg19_facial-expression-recognition_fer/summary)、[人脸质量模型FQA](https://modelscope.cn/models/damo/cv_manual_face-quality-assessment_fqa/summary)。'."\n" + .'关于人脸修复增强的错误码，详情请参见[常见错误码](~~146756~~)。'."\n" ."\n" .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" - .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。'."\n" - .'- 平台不存储用户在使用服务过程中涉及的原始人脸图片或文件信息。', - ], - 'RecognizePublicFace' => [ - 'summary' => '本文介绍公众人物识别RecognizePublicFace的语法及示例。', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'http', - 'https', + .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-facebody:EnhanceFace', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + ], + 'ExtractFingerPrint' => [ + 'summary' => '本文介绍指纹提取ExtractFingerPrint的语法及示例。', + 'methods' => ['post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [], 'parameters' => [ [ - 'name' => 'Task', + 'name' => 'ImageURL', 'in' => 'formData', - 'style' => 'repeatList', - 'schema' => [ - 'description' => '1', - 'type' => 'array', - 'items' => [ - 'description' => '1', - 'type' => 'object', - 'properties' => [ - 'ImageURL' => [ - 'description' => '待检测的图像URL地址。JSON数组中的每个元素是一个图片检测任务结构体（image表）。最多支持10个元素，即最多同时对10张图片进行检测。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。'."\n" - ."\n" - .'> 对于该接口，系统会自动将OSS链接地址转成内网地址然后再下载文件，所以调用该接口并不会产生OSS流量计费。', - 'type' => 'string', - 'required' => false, - 'example' => 'https://viapi-oss.oss-cn-shanghai.aliyuncs.com/doc/facebody/xxx.jpg', - 'isFileTransferUrl' => true, - ], - 'ImageData' => [ - 'description' => '图像Base64编码字符串。当与URL方式共存时，URL方式优先。'."\n" - .'文件的Base64编码处理操作，请参见[文件Base64处理](~~468191~~)。', - 'type' => 'string', - 'required' => false, - 'example' => '/9j/4AAQSkZJRgABAQAAAQABAAD/2****9j/4AAQSkZJRgABAQAAAQABAAD/2****', - ], - ], - 'required' => false, - ], - 'required' => false, - 'maxItems' => 10, - 'minItems' => 1, - ], + 'schema' => ['description' => '图像URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。'."\n" + ."\n" + .'> **ImageURL**与**ImageData**二选一，当URL方式与Base64编码方式共存时，URL方式优先。文件的Base64编码处理操作，请参见[文件Base64处理](~~468191~~)。', 'type' => 'string', 'required' => false, 'example' => 'https://viapi-test.oss-cn-shanghai.aliyuncs.com/test-team/xuhan/ExtractFingerPrint.png', 'isFileTransferUrl' => true], + ], + [ + 'name' => 'ImageData', + 'in' => 'formData', + 'schema' => ['description' => '图像的Base64编码字符串。文件的Base64编码处理操作，请参见[文件Base64处理](~~468191~~)。'."\n" + ."\n" + .'> **ImageURL**与**ImageData**二选一，当URL方式与Base64编码方式共存时，URL方式优先。', 'type' => 'string', 'required' => false, 'example' => 'iVBORw0KGgoAAAANSUhEUgAAASUAA****'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'description' => '1', + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'AC4D107C-29E3-4873-A719-0D2217EA28A8', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => 'D21978CC-C1E7-4A7A-A1B2-D5896BDC7ADF'], 'Data' => [ 'description' => '返回的结果数据内容。', 'type' => 'object', 'properties' => [ - 'Elements' => [ - 'description' => '返回识别的元素。', - 'type' => 'array', - 'items' => [ - 'description' => '1', - 'type' => 'object', - 'properties' => [ - 'ImageURL' => [ - 'description' => '对应请求中的图像URL地址。', - 'type' => 'string', - 'example' => 'https://viapi-oss.oss-cn-shanghai.aliyuncs.com/doc/facebody/xxx.jpg', - ], - 'TaskId' => [ - 'description' => '该检测任务的ID。', - 'type' => 'string', - 'example' => 'img3dhYqt1e4wO77Wnf2y@t@E-1tYAEt', - ], - 'Results' => [ - 'description' => '返回结果。调用成功时返回结果中包含一个或多个元素。', - 'type' => 'array', - 'items' => [ - 'description' => '1', - 'type' => 'object', - 'properties' => [ - 'Suggestion' => [ - 'description' => '建议您执行的操作，取值包括：'."\n" - ."\n" - .'- pass：图片正常，无需进行其余操作。'."\n" - ."\n" - .'- review：检测结果不确定，需要进行人工审核。'."\n" - ."\n" - .'- block：图片违规，建议执行进一步操作（如直接删除或做限制处理）。', - 'type' => 'string', - 'example' => 'review', - ], - 'Label' => [ - 'description' => '检测结果的分类，取值包括：'."\n" - ."\n" - .'- normal：正常图片，不包含敏感人脸。'."\n" - ."\n" - .'- sface：图片中包含敏感人脸。', - 'type' => 'string', - 'example' => 'sface', - ], - 'SubResults' => [ - 'description' => '识别出来的人脸信息列表。'."\n" - .'> 当图片中有多张人脸，默认只返回置信度最高的人脸信息。', - 'type' => 'array', - 'items' => [ - 'description' => '1', - 'type' => 'object', - 'properties' => [ - 'W' => [ - 'description' => '人脸区域宽度。', - 'type' => 'number', - 'format' => 'float', - 'example' => '132', - ], - 'Faces' => [ - 'description' => '识别出的人脸信息。', - 'type' => 'array', - 'items' => [ - 'description' => '1', - 'type' => 'object', - 'properties' => [ - 'Name' => [ - 'description' => '识别出的相似人物名称。', - 'type' => 'string', - 'example' => '张三', - ], - 'Id' => [ - 'description' => '人脸ID。', - 'type' => 'string', - 'example' => 'AliFace_0006272', - ], - 'Rate' => [ - 'description' => '相似概率。', - 'type' => 'number', - 'format' => 'float', - 'example' => '98.35', - ], - ], - ], - ], - 'H' => [ - 'description' => '人脸区域高度。', - 'type' => 'number', - 'format' => 'float', - 'example' => '153', - ], - 'Y' => [ - 'description' => '以图片左上角为坐标原点，人脸区域左上角到y轴距离。', - 'type' => 'number', - 'format' => 'float', - 'example' => '153', - ], - 'X' => [ - 'description' => '以图片左上角为坐标原点，人脸区域左上角到x轴距离。', - 'type' => 'number', - 'format' => 'float', - 'example' => '182', - ], - ], - ], - ], - 'Rate' => [ - 'description' => '检测结果的置信度，取值范围为`[0.00,100.00]`。值越高，表示属于该分类的概率越大。', - 'type' => 'number', - 'format' => 'float', - 'example' => '98.35', - ], - ], - ], - ], - ], - ], - ], + 'FingerPrint' => ['description' => '指纹提取结果图像的Base64编码字符串。', 'type' => 'string', 'example' => '/9j/4AAQSkZJRgABAQAAAQABAAD****'], ], ], ], @@ -4674,375 +3612,260 @@ ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'ParameterError', - 'errorMessage' => 'The parameter is invalid. Please check again.', - ], + ['errorCode' => 'ParameterError', 'errorMessage' => 'The parameter is invalid. Please check again.', 'description' => '参数错误，请检查参数值'], ], 403 => [ - [ - 'errorCode' => 'AuthFailed', - 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', - ], + ['errorCode' => 'AuthFailed', 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', 'description' => '授权失败，请检查RAM权限配置'], ], 408 => [ - [ - 'errorCode' => 'Timeout', - 'errorMessage' => 'The request has timed out.', - ], + ['errorCode' => 'Timeout', 'errorMessage' => 'The request has timed out.', 'description' => '请求超时，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'The service is unavailable.', - ], + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'The service is unavailable.', 'description' => '服务不可用，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"AC4D107C-29E3-4873-A719-0D2217EA28A8\\",\\n \\"Data\\": {\\n \\"Elements\\": [\\n {\\n \\"ImageURL\\": \\"https://viapi-oss.oss-cn-shanghai.aliyuncs.com/doc/facebody/xxx.jpg\\",\\n \\"TaskId\\": \\"img3dhYqt1e4wO77Wnf2y@t@E-1tYAEt\\",\\n \\"Results\\": [\\n {\\n \\"Suggestion\\": \\"review\\",\\n \\"Label\\": \\"sface\\",\\n \\"SubResults\\": [\\n {\\n \\"W\\": 132,\\n \\"Faces\\": [\\n {\\n \\"Name\\": \\"张三\\",\\n \\"Id\\": \\"AliFace_0006272\\",\\n \\"Rate\\": 98.35\\n }\\n ],\\n \\"H\\": 153,\\n \\"Y\\": 153,\\n \\"X\\": 182\\n }\\n ],\\n \\"Rate\\": 98.35\\n }\\n ]\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n AC4D107C-29E3-4873-A719-0D2217EA28A8\\n \\n \\n https://viapi-oss.oss-cn-shanghai.aliyuncs.com/doc/facebody/xxx.jpg\\n img3dhYqt1e4wO77Wnf2y@t@E-1tYAEt\\n \\n review\\n \\n \\n 132\\n \\n 张三\\n AliFace_0006272\\n 98.35\\n \\n 153\\n 153\\n 182\\n \\n 98.35\\n \\n \\n \\n","errorExample":""}]', - 'title' => '公众人脸识别', + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"D21978CC-C1E7-4A7A-A1B2-D5896BDC7ADF\\",\\n \\"Data\\": {\\n \\"FingerPrint\\": \\"/9j/4AAQSkZJRgABAQAAAQABAAD****\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n D21978CC-C1E7-4A7A-A1B2-D5896BDC7ADF\\n \\n /9j/4AAQSkZJRgABAQAAAQABAAD****\\n \\n","errorExample":""}]', + 'title' => '指纹提取', 'description' => '## 功能描述'."\n" - .'公众人物识别能力可以识别图片中的公众人物信息。'."\n" - .'公众人物是指在一定范围内具有重要影响力、拥有一定的社会地位、被大众广泛关注、且能因此从社会中得到巨大利益、与社会公共利益密切相关的人物，如领导人、科学家、企业家或社会活动家等。'."\n" + .'指纹提取能力可以对输入的一张手指拍照图像自动定位其手指区域，并生成二值化黑白按压式指纹图像。'."\n" ."\n" - .'> - 在同时检测多个Task的情况下，将按照Task的个数进行累计计费。'."\n" - .'- 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" - .'- 当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击[立即试用](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=RecognizePublicFace)对该能力进行更直观试用以及在线购买。'."\n" + .'> - 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" + .'- 当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击[立即试用](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=ExtractFingerPrint)对该能力进行更直观试用以及在线购买。'."\n" .'- 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。'."\n" ."\n" .'## 应用场景'."\n" - .'- 用户内容审核：检查识别用户提交的图片和视频中是否存在公众人物，识别是否存在法律风险。'."\n" - .'- 视频图片检索：对公众人物有关的视频图片内容进行识别并设置标签，用户可以通过公众人物姓名等检索查找出与其有关的视频和图片。'."\n" + .'线上信息采集：在云上办案过程中，上传当事人利用手机拍摄的自己的拇指图像，可通过指纹提取能力，生成一张按压式指纹图像，以此作为当事人的信息进行备案，让远程办案成为可能。'."\n" ."\n" .'## 特色优势'."\n" - .'能够准确识别出图像中的公众人物信息。'."\n" + ."\n" + .'- 智能定位：通过深度学习算法，实现手指区域的智能定位，降低手机拍摄采集的难度。'."\n" + .'- 支持多角度拍摄：支持处理任意角度的手指图片，降低指纹采集难度。'."\n" + .'- 精准还原：精准还原手指指纹，纹理视觉效果和真实按压指纹无差异。'."\n" ."\n" .'## 接入指引'."\n" .'1. 注册阿里云账号：打开[阿里云官网](https://www.aliyun.com)，在阿里云官网右上角，单击**立即注册**，按照操作提示完成账号注册。'."\n" - .'2. 开通能力：'."\n" - .'- 请确保您已开通[人脸人体服务](https://vision.aliyun.com/facebody)，若未开通服务请[立即开通](https://common-buy.aliyun.com/?commodityCode=viapi_facebody_public_cn#/open)。'."\n" - .'- 开通服务后请[提交申请](https://vision.console.aliyun.com/cn-shanghai/applyopen/facebody/RecognizePublicFace)，申请通过后方可使用。'."\n" + .'2. 开通能力：请确保您已开通[人脸人体服务](https://vision.aliyun.com/facebody)，若未开通服务请[立即开通](https://common-buy.aliyun.com/?commodityCode=viapi_facebody_public_cn#/open)。开通服务后请[提交申请](https://vision.console.aliyun.com/cn-shanghai/applyopen/facebody/ExtractFingerPrint)，申请通过后[购买QPS](https://common-buy.aliyun.com/?commodityCode=viapi_facebodyqps_public_cn#/buy)方可使用。'."\n" ."\n" .'>'."\n" .'本能力仅限企业认证用户开通。更多实名认证操作信息，请参见[实名认证](https://help.aliyun.com/knowledge_list/37170.html)。'."\n" .'>'."\n" ."\n" .'3. 创建AccessKey：请确保您已[创建AccessKey](~~175144~~)，如果您使用的是子账号AccessKey，您需要给子账号赋予AliyunVIAPIFullAccess权限，具体操作，请参见[RAM授权](~~145025~~)。'."\n" - .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/facebody/2019-12-30/RecognizePublicFace?lang=JAVA&sdkStyle=dara¶ms=%7B%22Task%22%3A%5B%7B%22ImageURL%22%3A%22%22%7D%5D%7D&tab=DEMO)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" + .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/facebody/2019-12-30/ExtractFingerPrint?lang=JAVA&sdkStyle=old)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" .'5. 开发接入步骤：'."\n" .'- 在[SDK总览](~~145033~~)中选择您要接入使用的SDK语言。'."\n" .'- 在对应语言的SDK文档中找到AI类目为人脸人体（facebody）的SDK包进行安装。'."\n" .'- 参考文档中提供的示例代码进行适当修改后调用。'."\n" ."\n" - .'6. 示例代码：该能力常用语言的示例代码，请参见[公众人物识别示例代码](~~478122~~)。'."\n" - ."\n" - .'7. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" + .'6. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" .'- [Web前端直接调用](~~467779~~)'."\n" .'- [小程序场景下直接调用](~~467780~~)'."\n" .'- [Android端直接调用](~~467781~~)'."\n" .'- [iOS端直接调用](~~467782~~)'."\n" ."\n" .'## 输入限制'."\n" - .'- 图像格式：PNG、JPG、JPEG、BMP、GIF、WEBP。'."\n" + ."\n" + .'- 图像格式：JPG、JPEG、PNG。'."\n" + ."\n" .'- 图像大小：不超过10 MB。'."\n" - .'- 图像分辨率：建议不低于256×256像素，像素过低可能会影响识别效果。'."\n" - .'- URL地址中不能包含中文字符。'."\n" ."\n" - .'> 当图像分辨率超过最大限制时，请先将图片进行缩放，调整图片大小，具体请参见[图片缩放](~~44688~~)。'."\n" + .'- 图像分辨率：大于640×360像素，小于2560×1440像素。'."\n" ."\n" - .'## 检测说明'."\n" - .'- 最长检测时间是6秒，如果在该时间限制内没有完成检测，系统会返回超时错误码。'."\n" - .'- 图像下载时间限制为3秒，如果下载时间超过3秒，系统返回下载超时。'."\n" - .'- 图像检测接口响应时间依赖图片的下载时间。请保证被检测图像所在的存储服务稳定可靠，建议您使用阿里云OSS存储或者CDN缓存。'."\n" - .'- 最多可检测10张图像。'."\n" + .'- 拍摄镜头尽量靠近手指，对角拍摄。'."\n" ."\n" - .'## 计费说明'."\n" - .'关于公众人物识别的计费方式及报价，请参见[计费介绍](~~184049~~)。'."\n" + .'- URL地址中不能包含中文字符。'."\n" ."\n" - .'> 下方调试接口为付费接口，如需免费体验调试请前往[体验中心](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=RecognizePublicFace)。'."\n" - ."\n", - 'requestParamsDescription' => ' ', + .'## 计费说明'."\n" + .'关于指纹提取的计费方式及报价，请参见[计费介绍](~~184049~~)。'."\n", 'responseParamsDescription' => '## SDK参考'."\n" - .'阿里云视觉AI人脸人体类目下的公众人物识别能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。'."\n" - ."\n" - .'## 示例代码'."\n" - .'该能力常用语言的示例代码，请参见[公众人物识别示例代码](~~478122~~)。', + .'阿里云视觉AI人脸人体类目下的指纹提取能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。', 'extraInfo' => '## 错误码'."\n" - .'关于公众人物识别的错误码，详情请参见[常见错误码](~~146756~~)。'."\n" - ."\n" - .'## 开源模型体验'."\n" - .'更多开源免费模型体验及下载，详见魔搭社区：[人脸识别OOD模型](https://modelscope.cn/models/damo/cv_ir_face-recognition-ood_rts/summary)、[ArcFace人脸识别模型](https://modelscope.cn/models/damo/cv_ir50_face-recognition_arcface/summary)、[IR人脸识别模型FRIR](https://modelscope.cn/models/damo/cv_manual_face-recognition_frir/summary)、[口罩人脸识别模型FRFM-large](https://modelscope.cn/models/damo/cv_manual_face-recognition_frfm/summary)、[口罩人脸识别模型FaceMask](https://modelscope.cn/models/damo/cv_resnet_face-recognition_facemask/summary)。'."\n" - ."\n\n" + .'关于指纹提取的错误码，详情请参见[常见错误码](~~146756~~)。'."\n" .'## 安全声明'."\n" + ."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" - .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。'."\n" - .'- 平台不存储用户在使用服务过程中涉及的原始人脸图片或文件信息。', - ], - 'MergeImageFace' => [ - 'summary' => '本文介绍图像人脸融合MergeImageFace的语法及示例。', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'http', - 'https', + .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-facebody:ExtractFingerPrint', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + ], + 'FaceBeauty' => [ + 'methods' => ['post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], + 'operationType' => 'read', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'none', - ], + 'systemTags' => [], 'parameters' => [ - [ - 'name' => 'TemplateId', - 'in' => 'formData', - 'schema' => [ - 'description' => '人脸模板的模板ID。'."\n" - ."\n" - .'> 需要先上传模版，具体操作，请参见[图像人脸融合模板增加](~~203512~~)。', - 'type' => 'string', - 'required' => true, - 'example' => '6cd509ea-54fa-4730-8e9d-c94cadcda048', - ], - ], [ 'name' => 'ImageURL', 'in' => 'formData', - 'schema' => [ - 'description' => '待融合的人脸照片，仅在模板图为单人场景下使用。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。'."\n" - .'输入限制：'."\n" - .'- 图像格式：JPG、JPEG、PNG。'."\n" - .'- 图像大小：不超过20 MB。'."\n" - .'- 图像分辨率：大于等于128×128像素，小于等于2000×2000像素，最长边小于等于2000像素。'."\n" - .'- URL地址中不能包含中文字符。'."\n" - ."\n" - .'> - 当图像分辨率超过最大限制时，请先将图片进行缩放，调整图片大小，具体请参见[图片缩放](~~44688~~)。'."\n" - .'- **ImageURL**与**MergeInfos**二选一。', - 'type' => 'string', - 'required' => false, - 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/MergeImageFace/MergeImageFace-1.png', - 'isFileTransferUrl' => true, - ], - ], - [ - 'name' => 'ModelVersion', - 'in' => 'formData', - 'schema' => [ - 'description' => '提供两版模型，分别支持脸型适配（v1）与非脸型适配（v2）的效果，具有一定区分度。默认值为v1（脸型适配版本）。', - 'type' => 'string', - 'required' => false, - 'example' => 'v1', - ], + 'schema' => ['description' => '图像URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。'."\n" + .'输入限制：'."\n" + ."\n" + .'- 图像格式：JPEG、JPG、PNG、BMP。'."\n" + .'- 图像大小：不超过4 MB。'."\n" + .'- 图像分辨率：分辨率大于10×10像素，分辨率小于2000x2000像素，最长边小于2000像素。'."\n" + .'- URL地址中不能包含中文字符。'."\n" + .'- 图像质量建议：适用于大部分肤质的人像图像，对于包含比较严重色斑、痤疮或低曝等场景的图像效果一般。', 'type' => 'string', 'required' => true, 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/FaceBeauty/FaceBeauty4.png', 'isFileTransferUrl' => true], ], [ - 'name' => 'AddWatermark', + 'name' => 'Sharp', 'in' => 'formData', - 'schema' => [ - 'description' => '是否添加水印。取值范围如下：'."\n" - ."\n" - .'- False（默认）：不添加水印。'."\n" - .'- True：添加水印。', - 'type' => 'boolean', - 'required' => false, - 'example' => 'False', - 'default' => 'false', - ], + 'schema' => ['description' => '锐化（清晰度）程度，取值范围0~1。越接近1锐化程度越高。', 'type' => 'number', 'format' => 'float', 'required' => true, 'example' => '1'], ], [ - 'name' => 'WatermarkType', + 'name' => 'Smooth', 'in' => 'formData', - 'schema' => [ - 'description' => '水印类型。取值范围如下：'."\n" - ."\n" - .'- EN（默认）：英文水印。'."\n" - .'- CN：中文水印。', - 'type' => 'string', - 'required' => false, - 'example' => 'EN', - 'default' => 'EN', - ], + 'schema' => ['description' => '平滑程度，取值范围0~1。越接近1平滑程度越高。', 'type' => 'number', 'format' => 'float', 'required' => true, 'example' => '0.1'], ], [ - 'name' => 'MergeInfos', + 'name' => 'White', 'in' => 'formData', - 'style' => 'repeatList', - 'schema' => [ - 'type' => 'array', - 'items' => [ - 'description' => '仅在模板图为多人场景下使用，指定图中每个人脸和待换脸的图像URL。'."\n" - ."\n" - .'> **ImageURL**与**MergeInfos**二选一。', - 'type' => 'object', - 'properties' => [ - 'TemplateFaceID' => [ - 'description' => '多脸模板对应的某个人脸的子ID。', - 'type' => 'string', - 'required' => false, - 'example' => '6cd509ea-54fa-4730-8e9d-c94cadcda048_0', - ], - 'ImageURL' => [ - 'description' => '该人脸待替换的图像URL。', - 'type' => 'string', - 'required' => false, - 'example' => 'http://invi-label.oss-cn-shanghai.aliyuncs.com/label/temp/faceswap/ref/ref.jpg', - ], - ], - 'required' => false, - ], - 'required' => false, - 'maxItems' => 1000, - 'minItems' => 0, - ], + 'schema' => ['description' => '美白程度，取值范围0~1。越接近1美白程度越高。', 'type' => 'number', 'format' => 'float', 'required' => true, 'example' => '0.3'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '8473A5E5-488E-4612-800E-F95B42381570', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '35C284E1-C5F5-4E5E-B7AD-97BBF485CDC8'], 'Data' => [ - 'description' => '返回的结果数据内容。', + 'description' => '返回的数据内容。', 'type' => 'object', 'properties' => [ - 'ImageURL' => [ - 'description' => '融合后的图像URL地址。'."\n" - .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。', - 'type' => 'string', - 'example' => 'http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/image-face-fusion/09dedc78-c355-442a-9312-7ab074d6de49_54dc_20210129-025407.jpg?Expires=1611890647&OSSAccessKeyId=LTAI****************&Signature=2mk2OgIrwMqrvA%2FvDdp0MNaoVU****', - ], + 'ImageURL' => ['description' => '美颜后图像的URL地址。'."\n" + .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。', 'type' => 'string', 'example' => 'http://algo-app-taobao-mm-cn-shanghai-prod.oss-cn-shanghai.aliyuncs.com/pixelai-portrait-beauty/2020_03_24/2bbbdb7907901412_facebeauty.jpg?Expires=1585277923&OSSAccessKeyId=LTAI****************&Signature=myOPfNQcRyijgrWBU%2BZ4dPuV5Q****'], ], ], ], + 'description' => '', ], ], ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'ParameterError', - 'errorMessage' => 'The parameter is invalid. Please check again.', - ], + ['errorCode' => 'ParameterError', 'errorMessage' => 'The parameter is invalid. Please check again.', 'description' => '参数错误，请检查参数值'], ], 403 => [ - [ - 'errorCode' => 'AuthFailed', - 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', - ], + ['errorCode' => 'AuthFailed', 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', 'description' => '授权失败，请检查RAM权限配置'], ], 408 => [ - [ - 'errorCode' => 'Timeout', - 'errorMessage' => 'The request has timed out.', - ], + ['errorCode' => 'Timeout', 'errorMessage' => 'The request has timed out.', 'description' => '请求超时，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'The service is unavailable.', - ], + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'The service is unavailable.', 'description' => '服务不可用，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"8473A5E5-488E-4612-800E-F95B42381570\\",\\n \\"Data\\": {\\n \\"ImageURL\\": \\"http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/image-face-fusion/09dedc78-c355-442a-9312-7ab074d6de49_54dc_20210129-025407.jpg?Expires=1611890647&OSSAccessKeyId=LTAI****************&Signature=2mk2OgIrwMqrvA%2FvDdp0MNaoVU****\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n 8473A5E5-488E-4612-800E-F95B42381570\\n \\n http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/image-face-fusion/09dedc78-c355-442a-9312-7ab074d6de49_54dc_20210129-025407.jpg?Expires=1611890647&OSSAccessKeyId=LTAI****************&Signature=2mk2OgIrwMqrvA%2FvDdp0MNaoVU****\\n \\n","errorExample":""}]', - 'title' => '合并图像人脸', + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"35C284E1-C5F5-4E5E-B7AD-97BBF485CDC8\\",\\n \\"Data\\": {\\n \\"ImageURL\\": \\"http://algo-app-taobao-mm-cn-shanghai-prod.oss-cn-shanghai.aliyuncs.com/pixelai-portrait-beauty/2020_03_24/2bbbdb7907901412_facebeauty.jpg?Expires=1585277923&OSSAccessKeyId=LTAI****************&Signature=myOPfNQcRyijgrWBU%2BZ4dPuV5Q****\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n 35C284E1-C5F5-4E5E-B7AD-97BBF485CDC8\\n \\n http://algo-app-taobao-mm-cn-shanghai-prod.oss-cn-shanghai.aliyuncs.com/pixelai-portrait-beauty/2020_03_24/2bbbdb7907901412_facebeauty.jpg?Expires=1585277923&OSSAccessKeyId=LTAI****************&Signature=myOPfNQcRyijgrWBU%2BZ4dPuV5Q****\\n \\n","errorExample":""}]', + 'title' => '人脸美颜', + 'summary' => '本文介绍人脸美颜FaceBeauty的语法及示例。', 'description' => '## 功能描述'."\n" - .'图像人脸融合功能可以将用户图中的人脸融合到模板图中的人脸位置，生成一张包含用户图人脸特征的新图像。特别注意的是，该功能严格要求使用者事先获得用户图和模版图的授权，不得用于非法或有违道德约束的场景中。'."\n" + .'人脸美颜能力可以对图像中的人脸进行美颜。产品支持以下功能：'."\n" + .'- 人脸美颜：磨皮、美白、锐化（清晰度）、平滑度等。'."\n" + .'- 参数调整：可自定义调整参数，提升个人形象。'."\n" + ."\n" .'关于该接口功能的示例图如下：'."\n" - .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20221108/mzue/MergeImageFace.png" width="400)'."\n" + .'- 输入原图'."\n" + .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20230202/pklu/FaceBeauty.png" width="300)'."\n" + ."\n" + .'- 美白'."\n" + .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20221101/lmdw/FaceBeautymeibai.jpg" width="300)'."\n" + ."\n" + .'- 磨皮'."\n" + .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20221101/isyv/FaceBeautymopi.jpg" width="300)'."\n" ."\n" .'> - 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" - .'- 当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击[立即试用](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=MergeImageFace)对该能力进行更直观试用以及在线购买。'."\n" + .'- 当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击[立即试用](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=FaceBeauty)对该能力进行更直观试用以及在线购买。'."\n" .'- 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。'."\n" ."\n" .'## 应用场景'."\n" - .'- 娱乐应用：用户将自己的人脸和已获授权的合法图像中的人物人脸进行融合。'."\n" - .'- 影视制作：适用于影视制作公司，在后期制作中通过人脸融合提升制作效率与降低成本。'."\n" - .'- 影楼获客：适用于影楼或者个人摄影工作室，将客户的人脸融合到摄影样片中，达到试妆、试衣、试拍的效果。'."\n" ."\n" - .'## 特色优势 '."\n" - .'- 高保真、低违和效果：融合后的人脸保留了替换者人脸身份信息的视觉特征，而融入被替换者人脸中又无违和感。'."\n" - .'- 表情肤色一致性：融合后的人脸最大限度保留被替换者的面目表情、肤色一致性。'."\n" - .'- 支持复杂人脸角度：支持模版人脸偏侧一定角度，融合后的结果真实稳定。'."\n" - .'- 脸型适配：支持自适应的匹配用户脸的脸型，提升融合结果的辨识度。'."\n" - .'- 支持多人脸和指定人脸：支持模版图像中多个人脸，并指定每个人脸与目标人脸进行单独融合。'."\n" + .'- 美颜相机：通过美颜相机拍摄的照片将自带美颜效果。'."\n" + .'- 摄影后期制作：通过基于深度学习的人脸美颜技术，提升人像摄影作品的艺术效果。'."\n" ."\n" - .'## 接入指引'."\n" + .'## 特色优势'."\n" + ."\n" + .'- 人脸美化：可对拍摄的照片磨皮、去黑眼圈和法令纹、美白等效果。'."\n" + .'- 清晰度保持：可维持原片的清晰度。'."\n" ."\n" + .'## 接入指引'."\n" .'1. 注册阿里云账号：打开[阿里云官网](https://www.aliyun.com)，在阿里云官网右上角，单击**立即注册**，按照操作提示完成账号注册。'."\n" .'2. 开通能力：请确保您已开通[人脸人体服务](https://vision.aliyun.com/facebody)，若未开通服务请[立即开通](https://common-buy.aliyun.com/?commodityCode=viapi_facebody_public_cn#/open)。'."\n" - ."\n" - .'>于2024年7月17日及以后开通该能力的用户可直接调用，不需提交申请。'."\n" - .'2024年7月17日之前开通该服务的用户如需调用，可通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们添加到白名单。'."\n" - .'>'."\n" - ."\n" + .'> 本能力支持企业或个人认证用户开通。更多实名认证操作信息，请参见[实名认证](https://help.aliyun.com/knowledge_list/37170.html)。'."\n" .'3. 创建AccessKey：请确保您已[创建AccessKey](~~175144~~)，如果您使用的是子账号AccessKey，您需要给子账号赋予AliyunVIAPIFullAccess权限，具体操作，请参见[RAM授权](~~145025~~)。'."\n" - .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/facebody/2019-12-30/MergeImageFace?lang=JAVA&sdkStyle=old¶ms=%7B%7D&tab=DEMO)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" - .'5. 前提条件：已通过[图像人脸融合模板增加接口](~~203512~~)（AddFaceImageTemplate）创建生成了TemplateId。'."\n" - .'6. 开发接入步骤：'."\n" + .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/facebody/2019-12-30/FaceBeauty?lang=JAVA&sdkStyle=dara¶ms={%22ImageURL%22:%22http%3A%2F%2Fviapi-test.oss-cn-shanghai.aliyuncs.com%2Fviapi-3.0domepic%2Ffacebody%2FFaceBeauty%2FFaceBeauty1.png%22,%22Sharp%22:0.3,%22Smooth%22:0.3,%22White%22:0.3}&tab=DEBUG)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" + .'5. 开发接入步骤：'."\n" .'- 在[SDK总览](~~145033~~)中选择您要接入使用的SDK语言。'."\n" .'- 在对应语言的SDK文档中找到AI类目为人脸人体（facebody）的SDK包进行安装。'."\n" .'- 参考文档中提供的示例代码进行适当修改后调用。'."\n" ."\n" - .'7. 示例代码：该能力常用语言的示例代码，请参见[图像人脸融合示例代码](~~467963~~)。'."\n" - ."\n" - .'8. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" + .'6. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" .'- [Web前端直接调用](~~467779~~)'."\n" .'- [小程序场景下直接调用](~~467780~~)'."\n" .'- [Android端直接调用](~~467781~~)'."\n" .'- [iOS端直接调用](~~467782~~)'."\n" - ."\n" + ."\n\n" .'## 输入限制'."\n" - .'- 图像格式：JPG、JPEG、PNG。'."\n" - .'- 图像大小：不超过20 MB。'."\n" - .'- 图像分辨率：大于等于128×128像素，小于等于2000×2000像素，最长边小于等于2000像素。'."\n" + ."\n" + .'- 图像格式：JPEG、JPG、PNG、BMP。'."\n" + .'- 图像大小：不超过3 MB。'."\n" + .'- 图像分辨率：分辨率大于10×10像素，分辨率小于2000x2000像素，最长边小于2000像素。'."\n" .'- URL地址中不能包含中文字符。'."\n" + .'- 图像质量建议：适用于大部分肤质的人像图像，对于包含比较严重色斑、痤疮或低曝等场景的图像效果一般。'."\n" ."\n" .'> 当图像分辨率超过最大限制时，请先将图片进行缩放，调整图片大小，具体请参见[图片缩放](~~44688~~)。'."\n" ."\n" - .'## 图像质量建议'."\n" - ."\n" - .'- 要求保证图像中的人脸清晰。图像中人脸尺寸建议大于64×64像素，人脸区域建议不大于全图区域的2/3。'."\n" - .'- 建议图像中人脸五官区域轮廓完整，无明显遮挡。人脸融合算法支持人脸偏侧一定角度，在偏侧角度不超过30度的情况下能取得更佳效果。'."\n" - .'- 含有多人脸的图像，建议图像中人脸个数不超过5个。'."\n" - ."\n" - .'推荐图像示例：'."\n" - .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20221114/jris/MergeImageFacetuijian.png" width="300)'."\n" - .'不推荐图像示例：'."\n" - .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20221114/rkbx/MergeImageFacebutuijian.png" width="300)'."\n" - ."\n" .'## 计费说明'."\n" - .'关于图像人脸融合的计费方式及报价，请参见[计费介绍](~~184049~~)。'."\n" - .'> 下方调试接口为付费接口，如需免费体验调试请前往[体验中心](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=MergeImageFace)。', - 'responseParamsDescription' => '## SDK参考'."\n" - .'阿里云视觉AI人脸人体类目下的图像人脸融合能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。'."\n" + .'关于人脸美颜的计费方式及报价，请参见[计费介绍](~~184049~~)。'."\n" ."\n" - .'## 示例代码'."\n" - .'该能力常用语言的示例代码，请参见[图像人脸融合示例代码](~~467963~~)。', + .'> 下方调试接口为付费接口，如需免费体验调试请前往[体验中心](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=FaceBeauty)。', + 'requestParamsDescription' => ' ', + 'responseParamsDescription' => '## SDK参考'."\n" + .'阿里云视觉AI人脸人体类目下的人脸美颜能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。', 'extraInfo' => '## 错误码'."\n" - .'关于图像人脸融合的错误码，详情请参见[常见错误码](~~146756~~)。'."\n" + .'关于人脸美颜的错误码，详情请参见[常见错误码](~~146756~~)。'."\n" + ."\n" + .'## 开源模型体验'."\n" + .'更多开源免费模型体验及下载，详见魔搭社区：[106点人脸关键点-通用领域-2D](https://www.modelscope.cn/models/damo/cv_mobilenet_face-2d-keypoints_alignment/summary)。'."\n" ."\n" .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。', - ], - 'BodyPosture' => [ - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'http', - 'https', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-facebody:FaceBeauty', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + ], + 'GenRealPersonVerificationToken' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -5053,113 +3876,36 @@ 'systemTags' => [], 'parameters' => [ [ - 'name' => 'ImageURL', + 'name' => 'CertificateName', 'in' => 'formData', - 'schema' => [ - 'description' => '图像URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。', - 'type' => 'string', - 'required' => true, - 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/BodyPosture/BodyPosture4.jpg', - 'isFileTransferUrl' => true, - ], + 'schema' => ['description' => '被校验的身份证人名。', 'type' => 'string', 'required' => true, 'example' => '张三', 'isFileTransferUrl' => false], ], - ], - 'responses' => [ - 200 => [ - 'schema' => [ - 'type' => 'object', - 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'B854094B-9231-4A54-89AB-C377CB0D237D', - ], + [ + 'name' => 'CertificateNumber', + 'in' => 'formData', + 'schema' => ['description' => '身份证号码。', 'type' => 'string', 'required' => true, 'example' => '33010219001123123X'], + ], + [ + 'name' => 'MetaInfo', + 'in' => 'formData', + 'schema' => ['description' => 'metainfo环境参数，需要通过客户端SDK获取。Android SDK通过getMetaInfos获取，iOS SDK通过getMetaInfo获取。', 'type' => 'string', 'required' => true, 'example' => '{"dwe":"ew4e"...}'], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'description' => '返回结构体。', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'A31006F2-22E7-4538-93BB-DE6B563643EE'], 'Data' => [ 'description' => '返回的结果数据内容。', 'type' => 'object', 'properties' => [ - 'Outputs' => [ - 'description' => '检测结果。', - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'HumanCount' => [ - 'description' => '人体的个数。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'Results' => [ - 'description' => '检测结果。', - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'Bodies' => [ - 'description' => '检测到的人体关键点信息。', - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'Positions' => [ - 'description' => '关键点坐标，为相对坐标，即相对于图像尺寸的坐标。', - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'Points' => [ - 'type' => 'array', - 'items' => [ - 'description' => '关键点\\[x,y]坐标。'."\n" - .'- x坐标，取值范围[0, 1]，相对于图像宽度width的相对坐标，实际坐标为x*width。'."\n" - .'- y坐标，取值范围[0, 1]，相对于图像高度height的相对坐标，实际坐标为y*height。', - 'type' => 'number', - 'format' => 'float', - 'example' => '[0.46296295523643494, 0.1304347813129425]', - ], - ], - ], - ], - ], - 'Confident' => [ - 'description' => '关键点置信度。', - 'type' => 'number', - 'format' => 'float', - 'example' => '0.91309475898742676', - ], - 'Label' => [ - 'description' => '关键点的标签。包括如下类型：`nose、neck、right_shoulder、right_elbow、right_wrist、left_shoulder、left_elbow、left_wrist、right_hip、right_knee、right_ankle、left_hip、left_knee、left_ankle、right_eye、left_eye、right_ear、left_ear`。', - 'type' => 'string', - 'example' => 'nose', - ], - ], - ], - ], - ], - ], - ], - ], - ], - ], - 'MetaObject' => [ - 'description' => '图像基本信息。', - 'type' => 'object', - 'properties' => [ - 'Width' => [ - 'description' => '图像宽度，单位像素。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '500', - ], - 'Height' => [ - 'description' => '图像高度，单位像素。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '500', - ], - ], - ], + 'VerificationToken' => ['description' => '可信核身认证的唯一标识。'."\n" + ."\n" + .'> - 核身认证移动端请求后未进行核身认证移动端查询就没有活体和风控结果，整体认证存在一定风险，建议移动端请求结束后进行[核身认证移动端查询](~~198724~~)，完成整体认证流程。'."\n" + .'- 调用核身认证移动端请求接口返回的verificationToken有效期时间为30分钟，从verificationToken生成时间开始算起，超过有效期再进行人脸认证会报错，请在有效期时间内完成认证。', 'type' => 'string', 'example' => '9fca3791c158a479ead9f2ba65ab3XXX'], ], ], ], @@ -5168,47 +3914,53 @@ ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'ParameterError', - 'errorMessage' => 'The parameter is invalid. Please check again.', - ], + ['errorCode' => 'ParameterError', 'errorMessage' => 'The parameter is invalid. Please check again.', 'description' => '参数错误，请检查参数值'], ], 403 => [ - [ - 'errorCode' => 'AuthFailed', - 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', - ], + ['errorCode' => 'AuthFailed', 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', 'description' => '授权失败，请检查RAM权限配置'], ], 408 => [ - [ - 'errorCode' => 'Timeout', - 'errorMessage' => 'The request has timed out.', - ], + ['errorCode' => 'Timeout', 'errorMessage' => 'The request has timed out.', 'description' => '请求超时，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'The service is unavailable.', - ], + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'The service is unavailable.', 'description' => '服务不可用，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"B854094B-9231-4A54-89AB-C377CB0D237D\\",\\n \\"Data\\": {\\n \\"Outputs\\": [\\n {\\n \\"HumanCount\\": 1,\\n \\"Results\\": [\\n {\\n \\"Bodies\\": [\\n {\\n \\"Positions\\": [\\n {\\n \\"Points\\": [\\n 0\\n ]\\n }\\n ],\\n \\"Confident\\": 0.9130947589874268,\\n \\"Label\\": \\"nose\\"\\n }\\n ]\\n }\\n ]\\n }\\n ],\\n \\"MetaObject\\": {\\n \\"Width\\": 500,\\n \\"Height\\": 500\\n }\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n B854094B-9231-4A54-89AB-C377CB0D237D\\n \\n \\n 500\\n 500\\n \\n \\n \\n \\n 0.91309475898742676\\n \\n \\n 0.46296295523643494\\n 0.1304347813129425\\n \\n \\n \\n 0.7284882664680481\\n \\n \\n 0.47685185074806213\\n 0.22282609343528748\\n \\n \\n \\n 0.78919297456741333\\n \\n \\n 0.3888888955116272\\n 0.239130437374115\\n \\n \\n \\n 1\\n \\n \\n","errorExample":""}]', - 'title' => '人体姿态关键点', - 'summary' => '本文介绍人体姿态关键点BodyPosture的语法及示例。', + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"A31006F2-22E7-4538-93BB-DE6B563643EE\\",\\n \\"Data\\": {\\n \\"VerificationToken\\": \\"9fca3791c158a479ead9f2ba65ab3XXX\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"A31006F2-22E7-4538-93BB-DE6B563643EE\\n\\n 9fca3791c158a479ead9f2ba65ab3XXX\\n","errorExample":""}]', + 'title' => '生成实人认证会话令牌', + 'summary' => '核身认证请求。', 'description' => '## 功能描述'."\n" - .'人体姿态关键点能力可以获取人体的十八个关键点信息。包括：nose、neck、right_shoulder、right_elbow、right_wrist、left_shoulder、left_elbow、left_wrist、right_hip、right_knee、right_ankle、left_hip、left_knee、left_ankle、right_eye、left_eye、right_ear、left_ear。'."\n" + .'核身认证移动端请求能力可以在移动端依据被验证的人名和身份证号码，请求身份验证的用户图像信息。'."\n" ."\n" .'> - 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" - .'- 当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击[立即试用](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=BodyPosture)对该能力进行更直观试用以及在线购买。'."\n" .'- 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。'."\n" ."\n" + .'## 应用场景'."\n" + .'- 金融机构网上开户：在金融行业手机App注册开户，通过实人认证，验证开户用户真实身份，降低运营成本，提升风控水平。'."\n" + .'- 线上政务平台注册：疫情期间，政府在App中推出线上口罩预约功能，实施实人认证，可有效防止同一人当天重复领取口罩，导致分配不均。'."\n" + .'- 修改密码或手机号码：在移动互联网App修改密码，或绑定手机号码时，通过实人认证进行用户真实身份确认。'."\n" + .'- 网约车司机认证：网约车当前运营司机身份确认，防止冒用身份驾驶运营车辆。'."\n" + .'- 金融风控：在支付、挂失、解冻、转账、取款、信贷、理财等各个环节进行用户身份验证，做好金融风险管控。'."\n" + ."\n" + .'## 特色优势'."\n" + ."\n" + .'- 金融级的指标：误识率低于1/100000，准确率高于99%。'."\n" + .'- 成熟行业应用：服务超过2亿互联网金融用户，保障超过20亿次交易安全。'."\n" + .'- 秒级活体检测：无需复杂交互动作，只需秒级即可完成活体检测，更高效，同时也具备更高级别私密性，更高安全性。'."\n" + .'- 通过金融级防攻击测试：抵御各种真实发生的伪造攻击，权威数据源验证。'."\n" + .'- 低成本落地方案：纯软件方案，支持普通摄像头，成本极低，适配室内外。'."\n" + .'- 国内外权威认证：通过公安部认证、ISO 27001信息安全体系认证，ISO30107-3人脸活体防攻击认证（iBeta PAD Level1）， ISO/TC68。'."\n" + ."\n" .'## 接入指引'."\n" .'1. 注册阿里云账号：打开[阿里云官网](https://www.aliyun.com)，在阿里云官网右上角，单击**立即注册**，按照操作提示完成账号注册。'."\n" - .'2. 开通能力：请确保您已开通[人脸人体服务](https://vision.aliyun.com/facebody)，若未开通服务请[立即开通](https://common-buy.aliyun.com/?commodityCode=viapi_facebody_public_cn#/open)。'."\n" - .'> 本能力支持企业或个人认证用户开通。更多实名认证操作信息，请参见[实名认证](https://help.aliyun.com/knowledge_list/37170.html)。'."\n" + .'2. 请确保您已开通[人脸人体服务](https://vision.aliyun.com/facebody)，若未开通服务请[立即开通](https://common-buy.aliyun.com/?commodityCode=viapi_facebody_public_cn#/open)。'."\n" + ."\n" + .'>'."\n" + .'本能力支持企业或个人认证用户开通。更多实名认证操作信息，请参见[实名认证](https://help.aliyun.com/knowledge_list/37170.html)。'."\n" + .'>'."\n" ."\n" .'3. 创建AccessKey：请确保您已[创建AccessKey](~~175144~~)，如果您使用的是子账号AccessKey，您需要给子账号赋予AliyunVIAPIFullAccess权限，具体操作，请参见[RAM授权](~~145025~~)。'."\n" - .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/facebody/2019-12-30/BodyPosture?&lang=JAVA&sdkStyle=old¶ms=%7B%22ImageURL%22%3A%22http%3A%2F%2Fviapi-test.oss-cn-shanghai.aliyuncs.com%2Fviapi-3.0domepic%2Ffacebody%2FBodyPosture%2FBodyPosture1.jpg%22%7D&tab=DEMO)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" + .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/facebody/2019-12-30/GenRealPersonVerificationToken?lang=JAVA)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" .'5. 开发接入步骤：'."\n" .'- 在[SDK总览](~~145033~~)中选择您要接入使用的SDK语言。'."\n" .'- 在对应语言的SDK文档中找到AI类目为人脸人体（facebody）的SDK包进行安装。'."\n" @@ -5220,36 +3972,61 @@ .'- [Android端直接调用](~~467781~~)'."\n" .'- [iOS端直接调用](~~467782~~)'."\n" ."\n" - .'## 输入限制'."\n" - .'- 图像格式：JPEG、JPG、BMP、PNG。'."\n" - .'- 图像大小：不超过3 MB。'."\n" - .'- URL地址中不能包含中文字符。'."\n" - ."\n" .'## 计费说明'."\n" - .'关于人体姿态关键点的计费方式及报价，请参见[计费介绍](~~184049~~)。'."\n" + .'关于核身认证移动端请求的计费方式及报价，请参见[计费介绍](~~184049~~)。'."\n" ."\n" - .'> 下方调试接口为付费接口，如需免费体验调试请前往[体验中心](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=BodyPosture)。', - 'requestParamsDescription' => ' ', + .'> 下方调试接口为付费接口。', 'responseParamsDescription' => '## SDK参考'."\n" - .'阿里云视觉AI人脸人体类目下的人体姿态关键点能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。', + .'阿里云视觉AI能力支持使用SDK调用，具体可参见：'."\n" + .'- [服务端接入教程](~~201625~~)'."\n" + .'- [iOS端接入教程](~~201379~~)'."\n" + .'- [Android端接入教程](~~201380~~)', 'extraInfo' => '## 错误码'."\n" - .'关于人体姿态关键点的错误码，详情请参见[常见错误码](~~146756~~)。'."\n" - ."\n" - .'## 开源模型体验'."\n" - .'更多开源免费模型体验及下载，详见魔搭社区：[HRNet人体关键点-2D](https://www.modelscope.cn/models/damo/cv_hrnetv2w32_body-2d-keypoints_image/summary)和[全身关键点检测-通用领域-2D](https://www.modelscope.cn/models/damo/cv_hrnetw48_human-wholebody-keypoint_image/summary)。'."\n" + .'关于核身认证移动端请求的错误码如下表所示。'."\n" + .'| 状态码 | 错误码 | 描述 |'."\n" + .'| ------ | ---------------------------- | ------------------------------------------------------------ |'."\n" + .'| 200 | 无错误码 | 刷脸认证通过。 |'."\n" + .'| 400 | INVALID_PARAMETER | 查询时传入参数不正确。联系接口提供方技术人员排查。例如身份证格式不正确。（Z8105） |'."\n" + .'| 400 | NOT_SAME_PERSON | 刷脸认证未通过，识别结果为非本人，请确认是否为本人再发起认证。抱歉，没有认出您。（Z1146） |'."\n" + .'| 500 | PROCESSING | 刷脸认证未完成。请重试，如果一直不成功，联系接口提供方技术人员排查。 |'."\n" + .'| 500 | PROCESSING | 图片安全检测不通过，请确认图片是否为正常拍摄图片。（Z1146） |'."\n" + .'| 500 | PROCESSING | 系统出错了，请您稍后再试，如果多次重试依然报错，请记录好RequestId联系阿里云技术支持工程师。（Z5137） |'."\n" + .'| 500 | INVALID_PARAM | 抱歉，系统出错了，请您稍后再试 ，如果多次重试依然报错，请记录好RequestId联系阿里云技术支持工程师。（Z5136） |'."\n" + .'| 400 | UNABLE_GET_IMAGE | 比对源不可用。远程公安网没有留底图片，无法比对。请记录好RequestId联系阿里云技术支持工程师。（Z1104） |'."\n" + .'| 400 | HIGH_RISK | 刷脸频次过高或失败次数过多，请您24小时后再来尝试。（Z1114） |'."\n" + .'| 400 | EXTRACT_FACE_FAIL | 图片提取不到人脸特征，请确认图片中是否包含人脸信息。（Z1156） |'."\n" + .'| 400 | INITIALIZE_INVALID_CERT_NAME | 姓名无效，请填写正确的姓名。(Z8109) |'."\n" + .'| 400 | INITIALIZE_INVALID_CERT_AGE | 未满14周岁的用户无法使用本产品，建议人工审核。(Z8110) |'."\n" + .'| 400 | INITIALIZE_INVALID_CERT_NO | 用户身份证号码信息无效，请填写正确的身份号码信息。(Z8111) |'."\n" + .'| 400 | QUERY_INVALID_CERTIFYID | 身份认证记录不存在，该CertifyId还没有对应的身份认证提交记录。(Z8304) |'."\n" + .'| 400 | QUERY_IMG_IS_NONE | 查询不到照片或照片不可用，可能是公安库数据问题导致。(Z8305) |'."\n" + .'| 400 | QUERY_CERTINFO_IS_NONE | 查询不到身份信息，可能是用户户口迁移、军人等特殊状态导致。(Z8306) |'."\n" + .'| 400 | QUERY_CERTINFO_ISNOT_MATCH | 姓名和身份证不一致，可能是用户的信息有误或用户的信息为假信息，建议用户确认后重新操作。(Z8307) |'."\n" + .'| 400 | QUERY_OCR_ISNOT_MATCH | 使用OCR方案时，人脸与身份证上人脸比对不一致，可能人证不符或人脸照片质量较低，建议根据业务情况分层处理，若为同一人可重新操作。(Z8308) |'."\n" + .'| 500 | SYSTEM_ERROR | 查询时发生系统错误。请重试，如果依然报错，请记录好RequestId联系阿里云技术支持工程师。（Z5139） |'."\n" ."\n" .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" - .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。', - ], - 'DetectBodyCount' => [ - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'http', - 'https', + .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。'."\n" + .'- 平台不存储用户在使用服务过程中涉及的原始人脸图片或文件信息。', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-facebody:GenRealPersonVerificationToken', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + ], + 'GenerateHumanAnimeStyle' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -5261,36 +4038,46 @@ 'parameters' => [ [ 'name' => 'ImageURL', - 'in' => 'formData', - 'schema' => [ - 'description' => '图像URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。', - 'type' => 'string', - 'required' => true, - 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/DetectBodyCount/DetectBodyCount3.jpg', - 'isFileTransferUrl' => true, - ], + 'in' => 'query', + 'schema' => ['description' => '图像URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。'."\n" + .'图片格式要求：'."\n" + ."\n" + .'- 图像格式：JPG、JPEG、PNG。'."\n" + .'- 图像大小：不超过3 MB。'."\n" + .'- 图像分辨率：大于32×32像素，小于2000×2000像素。最长边小于等于1999像素，人脸占比不低于60×60像素。'."\n" + .'- 支持有单人或多人的人脸清晰正面照，最大人脸数目限制5，人脸朝向在上下左右45度以内。'."\n" + .'- URL地址中不能包含中文字符。'."\n" + .'> 图像内容：当图像分辨率超过最大限制时，请先将图片进行缩放，调整图片大小，具体请参见[图片缩放](~~44688~~)。', 'type' => 'string', 'required' => true, 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/GenerateHumanAnimeStyle/GenerateHumanAnimeStyle8.png', 'isFileTransferUrl' => true], + ], + [ + 'name' => 'AlgoType', + 'in' => 'query', + 'schema' => ['description' => '卡通效果配置参数。取值如下：'."\n" + ."\n" + .'- anime：日漫风'."\n" + .'- 3d：3D特效'."\n" + .'- handdrawn：手绘风'."\n" + .'- sketch：铅笔画'."\n" + .'- artstyle：艺术特效'."\n" + .'- claborate ：国画工笔画'."\n" + .'- hongkong ：港漫风'."\n" + .'- comic：漫画风格'."\n" + .'- animation3d：动画3D', 'type' => 'string', 'required' => false, 'example' => 'anime', 'default' => 'anime'], ], ], 'responses' => [ 200 => [ 'schema' => [ + 'description' => '1', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '1C709078-8886-4C91-AEDE-4E04EED0A689', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '59697D68-2A6E-4553-89BD-0FADD07881E8'], 'Data' => [ 'description' => '返回的结果数据内容。', 'type' => 'object', 'properties' => [ - 'PersonNumber' => [ - 'description' => '人体的个数。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '6', - ], + 'ImageURL' => ['description' => '人物卡通化结果图的URL地址。'."\n" + .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。', 'type' => 'string', 'example' => 'https://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/viapi-video/person_image_cartoonizer/2023-10-25/55798d04-0957-4ab1-accc-0e4d2d01a039/20231025092636774205_styleanime_n2vedxruht.jpg?Expires=1698283596&OSSAccessKeyId=LTAI****************&Signature=ut2kn46Lz%2FRwqJ9jWJ0RBDut12****'], ], ], ], @@ -5299,178 +4086,187 @@ ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'ParameterError', - 'errorMessage' => 'The parameter is invalid. Please check again.', - ], + ['errorCode' => 'ParameterError', 'errorMessage' => 'The parameter is invalid. Please check again.', 'description' => '参数错误，请检查参数值'], ], 403 => [ - [ - 'errorCode' => 'AuthFailed', - 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', - ], + ['errorCode' => 'AuthFailed', 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', 'description' => '授权失败，请检查RAM权限配置'], ], 408 => [ - [ - 'errorCode' => 'Timeout', - 'errorMessage' => 'The request has timed out.', - ], + ['errorCode' => 'Timeout', 'errorMessage' => 'The request has timed out.', 'description' => '请求超时，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'The service is unavailable.', - ], + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'The service is unavailable.', 'description' => '服务不可用，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"1C709078-8886-4C91-AEDE-4E04EED0A689\\",\\n \\"Data\\": {\\n \\"PersonNumber\\": 6\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n 1C709078-8886-4C91-AEDE-4E04EED0A689\\n \\n 6\\n \\n","errorExample":""}]', - 'title' => '人体计数', - 'summary' => '本文为您介绍人体计数DetectBodyCount的语法及示例。', + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"59697D68-2A6E-4553-89BD-0FADD07881E8\\",\\n \\"Data\\": {\\n \\"ImageURL\\": \\"https://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/viapi-video/person_image_cartoonizer/2023-10-25/55798d04-0957-4ab1-accc-0e4d2d01a039/20231025092636774205_styleanime_n2vedxruht.jpg?Expires=1698283596&OSSAccessKeyId=LTAI****************&Signature=ut2kn46Lz%2FRwqJ9jWJ0RBDut12****\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n 59697D68-2A6E-4553-89BD-0FADD07881E8\\n \\n https://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/viapi-video/person_image_cartoonizer/2023-10-25/55798d04-0957-4ab1-accc-0e4d2d01a039/20231025092636774205_styleanime_n2vedxruht.jpg?Expires=1698283596&OSSAccessKeyId=LTAI****************&Signature=ut2kn46Lz%2FRwqJ9jWJ0RBDut12****\\n \\n","errorExample":""}]', + 'title' => '人物动漫化', + 'summary' => '本文介绍人物动漫化GenerateHumanAnimeStyle的语法及示例。', 'description' => '## 功能描述'."\n" - .'人体计数能力可以检测输入图片中人体的个数。'."\n" + .'人物动漫化能力可以将一张人物图像进行转换处理，生成卡通形象，并返回动漫化后的结果图像。'."\n" + .'- 支持风格：国画（NEW）、港漫（NEW）、漫画风（NEW）、动画3D（NEW）、日漫、3D、手绘、铅笔画和艺术特效9个风格。'."\n" + .'- 多人照片：可转换多人照片，一次可处理图片中最多5个人脸。'."\n" + ."\n" + .'关于该接口功能的示例图如下：'."\n" + .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20231121/ctcn/GenerateHumanAnimeStyle.png" width="600)'."\n" + ."\n" + .'- 漫画风（NEW）：漫画风格模拟复古漫画风格中的人物形象，适合各种类型的写真照片。'."\n" + .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20231121/qtpu/GenerateHumanAnimeStylemanhua1.png" width="500)'."\n" + .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20231121/nump/GenerateHumanAnimeStylemanhua2.png" width="500)'."\n" + ."\n" + .'- 动画3D风（NEW）：动画3D风格模拟动画3D的人物形象和质感，适合各种类型的写真照片。'."\n" + .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20231121/xogr/GenerateHumanAnimeStyledonghua1.png" width="500)'."\n" + .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20231121/jjgc/GenerateHumanAnimeStyledonghua2.png" width="500)'."\n" + ."\n" + .'- 港漫风（NEW）：港漫风格的能力比较综合，适合各种类型的照片。'."\n" + .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20231025/gxbu/GenerateHumanAnimeStylegangman1.png" width="500)'."\n" + .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20231025/bbbi/GenerateHumanAnimeStylegangman2.png" width="500)'."\n" + ."\n" + .'- 国画风（NEW）：国画风格适合古装写真照，如汉服、唐装等，以全身照和半身照背景简约的照片为宜。'."\n" + .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20231025/gsxw/GenerateHumanAnimeStyleguofeng1.png" width="500)'."\n" + .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20231025/wmut/GenerateHumanAnimeStyleguofeng2.png" width="500)'."\n" + ."\n" + .'- 手绘风：手绘风格适合各种类型的写真照片。'."\n" + .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20231025/smel/GenerateHumanAnimeStyleshouhui1.png" width="500)'."\n" + .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20231025/adxx/GenerateHumanAnimeStyleshouhui2.png" width="500)'."\n" + ."\n" + .'- 艺术特效：艺术特效适合照片颜色比较鲜艳，彩妆、浓妆等写真造型。'."\n" + .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20231025/dilz/GenerateHumanAnimeStyleyishu1.png" width="500)'."\n" + .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20231025/gloq/GenerateHumanAnimeStyleyishu2.png" width="500)'."\n" + ."\n" + .'- 3D特效：3D特效风格比较综合，适合各种类型的人物照片。'."\n" + .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20231025/wfbj/GenerateHumanAnimeStyle3d1.png" width="500)'."\n" + .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20231025/rnkc/GenerateHumanAnimeStyle3d2.png" width="500)'."\n" + ."\n" + .'- 日漫风：日漫风格比较综合，适合各种类型的人物照片，以Cosplay类型为佳。'."\n" + .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20231025/toby/GenerateHumanAnimeStyleriman1.png" width="500)'."\n" + .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20231025/laxr/GenerateHumanAnimeStyleriman2.png" width="500)'."\n" + ."\n" + .'- 铅笔画：铅笔画风格比较综合，适合各种类型的人物照片。'."\n" + .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20231025/yqdb/GenerateHumanAnimeStyleqianbi1.png" width="500)'."\n" + .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20231025/nakc/GenerateHumanAnimeStyleqianbi2.png" width="500)'."\n" ."\n" .'> - 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" - .'- 当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击[立即试用](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=DetectBodyCount)对该能力进行更直观试用以及在线购买。'."\n" + .'- 当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击[立即试用](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=GenerateHumanAnimeStyle)对该能力进行更直观试用以及在线购买。'."\n" .'- 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。'."\n" ."\n" + .'## 应用场景'."\n" + .'- 保护隐私：为保护图像中的人物隐私，将人物卡通化，可避免识别出原人物是谁。保留社交趣味度的同时避免过度娱乐化。'."\n" + .'- 社交娱乐：将自己的照片变成卡通人物，塑造可爱氛围，配上图文分享给朋友。'."\n" + .'- 特效应用：可用于打造个性头像以及趣味活动等场景。'."\n" + ."\n" + .'## 特色优势'."\n" + .'- 复刻人物表情：基于深度学习算法，识别人物性别、表情等特征，在卡通头像上还原。'."\n" + .'- 全身卡通化：相比人脸卡通化，可避免笑场等尴尬场景。'."\n" + .'- 多人模式：可处理情侣照、家庭照、团体类照片。'."\n" + ."\n" .'## 接入指引'."\n" .'1. 注册阿里云账号：打开[阿里云官网](https://www.aliyun.com)，在阿里云官网右上角，单击**立即注册**，按照操作提示完成账号注册。'."\n" .'2. 开通能力：请确保您已开通[人脸人体服务](https://vision.aliyun.com/facebody)，若未开通服务请[立即开通](https://common-buy.aliyun.com/?commodityCode=viapi_facebody_public_cn#/open)。'."\n" - ."\n" .'> 本能力支持企业或个人认证用户开通。更多实名认证操作信息，请参见[实名认证](https://help.aliyun.com/knowledge_list/37170.html)。'."\n" - ."\n" .'3. 创建AccessKey：请确保您已[创建AccessKey](~~175144~~)，如果您使用的是子账号AccessKey，您需要给子账号赋予AliyunVIAPIFullAccess权限，具体操作，请参见[RAM授权](~~145025~~)。'."\n" - .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/facebody/2019-12-30/DetectBodyCount?lang=JAVA&sdkStyle=old¶ms=%7B%22ImageURL%22%3A%22http%3A%2F%2Fviapi-test.oss-cn-shanghai.aliyuncs.com%2Fviapi-3.0domepic%2Ffacebody%2FDetectBodyCount%2FDetectBodyCount1.jpg%22%7D&tab=DEMO)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" + .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/facebody/2019-12-30/GenerateHumanAnimeStyle?&lang=JAVA&sdkStyle=dara¶ms=%7B%22ImageURL%22%3A%22http%3A%2F%2Fviapi-test.oss-cn-shanghai.aliyuncs.com%2Fviapi-3.0domepic%2Ffacebody%2FGenerateHumanAnimeStyle%2FGenerateHumanAnimeStyle1.png%22%2C%22AlgoType%22%3A%22anime%22%7D&tab=DEMO)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" .'5. 开发接入步骤：'."\n" .'- 在[SDK总览](~~145033~~)中选择您要接入使用的SDK语言。'."\n" .'- 在对应语言的SDK文档中找到AI类目为人脸人体（facebody）的SDK包进行安装。'."\n" .'- 参考文档中提供的示例代码进行适当修改后调用。'."\n" ."\n" - .'6. 示例代码：该能力常用语言的示例代码，请参见[人体计数示例代码](~~478769~~)。'."\n" + .'6. 示例代码：该能力常用语言的示例代码，请参见[人物动漫化示例代码](~~477407~~)。'."\n" ."\n" .'7. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" .'- [Web前端直接调用](~~467779~~)'."\n" .'- [小程序场景下直接调用](~~467780~~)'."\n" .'- [Android端直接调用](~~467781~~)'."\n" .'- [iOS端直接调用](~~467782~~)'."\n" - ."\n" + ."\n\n" .'## 输入限制'."\n" ."\n" - .'- 图像格式：JPEG、JPG、BMP、PNG。'."\n" + .'- 图像格式：JPG、JPEG、PNG。'."\n" .'- 图像大小：不超过3 MB。'."\n" + .'- 图像分辨率：大于32×32像素，小于2000×2000像素，最长边小于等于1999像素，人脸占比不低于60×60像素。'."\n" + .'- 支持有单人或多人的人脸清晰正面照，最大人脸数目限制5，人脸朝向在上下左右45度以内。'."\n" .'- URL地址中不能包含中文字符。'."\n" ."\n" - .'## 计费说明'."\n" - .'关于人体计数的计费方式及报价，请参见[计费介绍](~~184049~~)。'."\n" + .'> 当图像分辨率超过最大限制时，请先将图片进行缩放，调整图片大小，具体请参见[图片缩放](~~44688~~)。'."\n" ."\n" - .'> 下方调试接口为付费接口，如需免费体验调试请前往[体验中心](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=DetectBodyCount)。', + .'## 计费说明'."\n" + .'关于人物动漫化的计费方式及报价，请参见[计费介绍](~~184049~~)。', 'requestParamsDescription' => ' ', 'responseParamsDescription' => '## SDK参考'."\n" - .'阿里云视觉AI人脸人体类目下的人体计数能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。'."\n" - ."\n" + .'阿里云视觉AI人脸人体类目下的人脸动漫化能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。'."\n" .'## 示例代码'."\n" - .'该能力常用语言的示例代码，请参见[人体计数示例代码](~~478769~~)。'."\n", + .'该能力常用语言的示例代码，请参见[人物动漫化示例代码](~~477407~~)。', 'extraInfo' => '## 错误码'."\n" - .'关于人体计数的错误码，详情请参见[常见错误码](~~146756~~)。'."\n" - ."\n\n" - .'## 安全声明'."\n" + .'关于人物动漫化的错误码，详情请参见[常见错误码](~~146756~~)。'."\n" ."\n" + .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。', - ], - 'DetectPedestrian' => [ - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'http', - 'https', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-facebody:GenerateHumanAnimeStyle', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + ], + 'GenerateHumanSketchStyle' => [ + 'summary' => '添加人像素描风格化。', + 'methods' => ['post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', + 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [], 'parameters' => [ [ 'name' => 'ImageURL', 'in' => 'formData', - 'schema' => [ - 'description' => '图像URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。'."\n" - .'输入限制：'."\n" - ."\n" - .'- 图像格式：JPEG、JPG、PNG、BMP。'."\n" - .'- 图像大小：不超过4 MB。'."\n" - .'- 图像分辨率：分辨率大于32×32， 分辨率小于2000×2000像素，最长边小于2000像素， 人脸占比不低于64×64像素。'."\n" - .'- URL地址中不能包含中文字符。'."\n" - .'> 当图像分辨率超过最大限制时，请先将图片进行缩放，调整图片大小，具体请参见[图片缩放](~~44688~~)。', - 'type' => 'string', - 'required' => true, - 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/DetectPedestrian/DetectPedestrian8.jpg', - 'isFileTransferUrl' => true, - ], + 'schema' => ['title' => 'A short description of struct', 'description' => '图像URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。'."\n" + .'图片格式要求：'."\n" + ."\n" + .'- 图像格式：JPG、JPEG、PNG。'."\n" + .'- 图像大小：小于10 MB。'."\n" + .'- 图像分辨率：大于100×100像素，小于2000×2000像素，最长边小于等于1999像素；人脸占比不低于60×60像素。'."\n" + .'- 图像质量：支持有单人人脸的清晰正面照，人脸朝向在上下左右45度以内。'."\n" + .'- URL地址中不能包含中文字符。'."\n" + .'> 图像内容：当图像分辨率超过最大限制时，请先将图片进行缩放，调整图片大小，具体请参见[图片缩放](~~44688~~)。', 'type' => 'string', 'required' => true, 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/GenerateHumanSketchStyle/GenerateHumanSketchStyle7.png', 'isFileTransferUrl' => true], + ], + [ + 'name' => 'ReturnType', + 'in' => 'formData', + 'schema' => ['description' => '图像返回形式。取值如下：'."\n" + ."\n" + .'- head：大头照（默认）'."\n" + .'- full：全身照'."\n" + ."\n" + .'推荐使用大头照，处理效果更佳。', 'type' => 'string', 'required' => false, 'example' => 'head'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'description' => '1', + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '45DBA494-6250-42C4-80D1-7CF19BDD2CB1', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => 'E499788C-22DA-4F0E-B9C0-0E9D30A25716'], 'Data' => [ - 'description' => '返回的数据内容。', + 'description' => '返回的结果数据内容。', 'type' => 'object', 'properties' => [ - 'Elements' => [ - 'description' => '人体检测框的集合。', - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'Type' => [ - 'description' => '检测框对应的检测结果类型。仅返回参数值`person`。', - 'type' => 'string', - 'example' => 'person', - ], - 'Boxes' => [ - 'description' => '1', - 'type' => 'array', - 'items' => [ - 'description' => '检测框坐标，格式为`[left, top, right, bottom]`。其中`left`为人体检测框左上角横坐标，`top`为人体检测框左上角纵坐标，`right`为人体检测框右下角横坐标，`bottom`为人体检测框右下角纵坐标。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '[326, 293, 500, 546 ]', - ], - ], - 'Score' => [ - 'description' => '检测框的置信度，取值范围为0~1，得分越接近1表示人体框准确的概率越大。', - 'type' => 'number', - 'format' => 'float', - 'example' => '0.999', - ], - ], - ], - ], - 'Width' => [ - 'description' => '输入图像的宽度，单位像素。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '899', - ], - 'Height' => [ - 'description' => '输入图像的高度，单位像素。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '599', - ], + 'ImageURL' => ['title' => '出参图片地址', 'description' => '返回图片URL地址。'."\n" + .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。', 'type' => 'string', 'example' => 'http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/person-image-pencil/fd49dd0a-9e24-4bb5-b303-0745cdb453e0_7aa6_20210128-073045.jpg?Expires=1611820849&OSSAccessKeyId=LTAI****************&Signature=1oLYG%2FPe%2BNRIK7XcsUQYaKF%2B1C****'], ], ], ], @@ -5479,77 +4275,51 @@ ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'ParameterError', - 'errorMessage' => 'The parameter is invalid. Please check again.', - ], + ['errorCode' => 'ParameterError', 'errorMessage' => 'The parameter is invalid. Please check again.', 'description' => '参数错误，请检查参数值'], ], 403 => [ - [ - 'errorCode' => 'AuthFailed', - 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', - ], + ['errorCode' => 'AuthFailed', 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', 'description' => '授权失败，请检查RAM权限配置'], ], 408 => [ - [ - 'errorCode' => 'Timeout', - 'errorMessage' => 'The request has timed out.', - ], + ['errorCode' => 'Timeout', 'errorMessage' => 'The request has timed out.', 'description' => '请求超时，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'The service is unavailable.', - ], + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'The service is unavailable.', 'description' => '服务不可用，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"45DBA494-6250-42C4-80D1-7CF19BDD2CB1\\",\\n \\"Data\\": {\\n \\"Elements\\": [\\n {\\n \\"Type\\": \\"person\\",\\n \\"Boxes\\": [\\n 0\\n ],\\n \\"Score\\": 0.999\\n }\\n ],\\n \\"Width\\": 899,\\n \\"Height\\": 599\\n }\\n}","errorExample":""},{"type":"xml","example":"45DBA494-6250-42C4-80D1-7CF19BDD2CB1\\n\\n 599\\n \\n 0.999\\n person\\n 326\\n 293\\n 500\\n 546\\n \\n \\n 0.998\\n person\\n 181\\n 156\\n 425\\n 534\\n \\n \\n 0.993\\n person\\n 515\\n 300\\n 705\\n 549\\n \\n \\n 0.986\\n person\\n 661\\n 129\\n 797\\n 506\\n \\n \\n 0.959\\n person\\n 511\\n 271\\n 572\\n 451\\n \\n 899\\n","errorExample":""}]', - 'title' => '人体检测', - 'summary' => '本文介绍人体检测DetectPedestrian的语法及示例。', + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"E499788C-22DA-4F0E-B9C0-0E9D30A25716\\",\\n \\"Data\\": {\\n \\"ImageURL\\": \\"http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/person-image-pencil/fd49dd0a-9e24-4bb5-b303-0745cdb453e0_7aa6_20210128-073045.jpg?Expires=1611820849&OSSAccessKeyId=LTAI****************&Signature=1oLYG%2FPe%2BNRIK7XcsUQYaKF%2B1C****\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n E499788C-22DA-4F0E-B9C0-0E9D30A25716\\n \\n http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/person-image-pencil/fd49dd0a-9e24-4bb5-b303-0745cdb453e0_7aa6_20210128-073045.jpg?Expires=1611820849&OSSAccessKeyId=LTAI****************&Signature=1oLYG%2FPe%2BNRIK7XcsUQYaKF%2B1C****\\n \\n","errorExample":""}]', + 'title' => '人像素描风格化', 'description' => '## 功能描述'."\n" - .'人体检测能力可以检测图像中的所有人体。主要适用于监控场景，建议人体占图片的比例小于1/2。产品支持以下功能：'."\n" - ."\n" - .'- 人体检测：返回图像中人体矩形框位置，并输出图像中人体所在的坐标位置。'."\n" - .'- 人体信息：输出图像中人物置信度；可同时识别图片中多个人体。'."\n" + .'人像素描风格化能力可以对一张人物图像自动识别其头部区域，生成大头照下的素描画效果。返回结果的分辨率固定为512x512像素。'."\n" ."\n" .'关于该接口功能的示例图如下：'."\n" .'- 输入原图'."\n" - .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20221111/unpw/DetectPedestrian.png" width="500)'."\n" - .'- 输出结果图'."\n" - .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20221111/xqtw/DetectPedestrianresult.png" width="500)'."\n" + .'![输入图像](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20221108/qflk/GenerateHumanSketchStyle.png" width="300)'."\n" + .'- 输出效果图'."\n" + .'![生成效果](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20221108/nsbr/GenerateHumanSketchStylesumiao.png" width="300)'."\n" ."\n" .'> - 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" - .'- 当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击[立即试用](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=DetectPedestrian)对该能力进行更直观试用以及在线购买。'."\n" + .'- 当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击[立即试用](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=GenerateHumanSketchStyle)对该能力进行更直观试用以及在线购买。'."\n" .'- 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。'."\n" ."\n" .'## 应用场景'."\n" - ."\n" - .'- 记录有人视频：在摄像头录像中，通过人体检测，可以过滤无人的视频段，仅保留有人员出现的视频，减少视频存储量。'."\n" - .'- 人流统计：结合多帧人体检测结果，进行过线判断，可以运用于商场、景区、交通枢纽的人流量统计。'."\n" - .'- 在岗检测：检测固定工作岗位上是否有人员在岗。'."\n" - .'- 智能办公室：检测办公室内是否有人，智能控制照明灯或空调的开关，节约能源，绿色环保。'."\n" + .'社交娱乐：输入一张个人照片，通过人像素描风格化算法能力，会生成一张独一无二的素描肖像画。可以与朋友分享，也可以用来做头像。'."\n" ."\n" .'## 特色优势'."\n" - ."\n" - .'- 支持多角度检测：针对正面，侧面，高角度等拍摄的图像，都可以准确检测出人体。'."\n" - .'- 抗遮挡能力强：对于人体被少部分遮挡的场景，仍可以准确检测出人体。'."\n" + .'精准刻画：通过深度学习算法，精准还原人脸五官特征，连发丝都可精准还原。'."\n" ."\n" .'## 接入指引'."\n" .'1. 注册阿里云账号：打开[阿里云官网](https://www.aliyun.com)，在阿里云官网右上角，单击**立即注册**，按照操作提示完成账号注册。'."\n" .'2. 开通能力：请确保您已开通[人脸人体服务](https://vision.aliyun.com/facebody)，若未开通服务请[立即开通](https://common-buy.aliyun.com/?commodityCode=viapi_facebody_public_cn#/open)。'."\n" - ."\n" .'> 本能力支持企业或个人认证用户开通。更多实名认证操作信息，请参见[实名认证](https://help.aliyun.com/knowledge_list/37170.html)。'."\n" - ."\n" .'3. 创建AccessKey：请确保您已[创建AccessKey](~~175144~~)，如果您使用的是子账号AccessKey，您需要给子账号赋予AliyunVIAPIFullAccess权限，具体操作，请参见[RAM授权](~~145025~~)。'."\n" - .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/facebody/2019-12-30/DetectPedestrian?lang=JAVA&sdkStyle=old¶ms=%7B%22ImageURL%22%3A%22http%3A%2F%2Fviapi-test.oss-cn-shanghai.aliyuncs.com%2Fviapi-3.0domepic%2Ffacebody%2FDetectPedestrian%2FDetectPedestrian1.jpg%22%7D&tab=DEMO)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" + .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/facebody/2019-12-30/GenerateHumanSketchStyle?lang=JAVA&sdkStyle=dara¶ms=%7B%22ImageURL%22%3A%22http%3A%2F%2Fviapi-test.oss-cn-shanghai.aliyuncs.com%2Fviapi-3.0domepic%2Ffacebody%2FGenerateHumanSketchStyle%2FGenerateHumanSketchStyle1.png%22%7D&tab=DEMO)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" .'5. 开发接入步骤：'."\n" - .' - 在[SDK总览](~~145033~~)中选择您要接入使用的SDK语言。'."\n" - .' - 在对应语言的SDK文档中找到AI类目为人脸人体（facebody）的SDK包进行安装。'."\n" - .' - 参考文档中提供的示例代码进行适当修改后调用。'."\n" - ."\n" - .'6. 示例代码：该能力常用语言的示例代码，请参见[人体检测示例代码](~~601107~~)。'."\n" + .'- 在[SDK总览](~~145033~~)中选择您要接入使用的SDK语言。'."\n" + .'- 在对应语言的SDK文档中找到AI类目为人脸人体（facebody）的SDK包进行安装。'."\n" + .'- 参考文档中提供的示例代码进行适当修改后调用。'."\n" ."\n" - .'7. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" + .'6. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" .'- [Web前端直接调用](~~467779~~)'."\n" .'- [小程序场景下直接调用](~~467780~~)'."\n" .'- [Android端直接调用](~~467781~~)'."\n" @@ -5557,43 +4327,42 @@ ."\n" .'## 输入限制'."\n" ."\n" - .'- 图像格式：JPEG、JPG、PNG、BMP。'."\n" - ."\n" - .'- 图像大小：不超过3 MB。'."\n" - ."\n" - .'- 图像分辨率：分辨率大于32×32像素， 分辨率小于2000×2000像素，最长边小于2000像素，人脸占比不低于64×64像素。'."\n" - ."\n" + .'- 图像格式：JPG、JPEG、PNG。'."\n" + .'- 图像大小：小于10 MB。'."\n" + .'- 图像分辨率：大于100×100像素，小于2000×2000像素，最长边小于等于1999像素；人脸占比不低于60×60像素。'."\n" + .'- 图像质量：支持有单人人脸的清晰正面照，人脸朝向在上下左右45度以内。'."\n" .'- URL地址中不能包含中文字符。'."\n" ."\n" .'> 当图像分辨率超过最大限制时，请先将图片进行缩放，调整图片大小，具体请参见[图片缩放](~~44688~~)。'."\n" ."\n" .'## 计费说明'."\n" - .'关于人体检测的计费方式及报价，请参见[计费介绍](~~184049~~)。'."\n" - .'> 下方调试接口为付费接口，如需免费体验调试请前往[体验中心](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=DetectPedestrian)。', + .'关于人像素描风格化的计费方式及报价，请参见[计费介绍](~~184049~~)。', 'responseParamsDescription' => '## SDK参考'."\n" - .'阿里云视觉AI人脸人体类目下的人体检测能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。'."\n" - ."\n" - .'## 示例代码'."\n" - .'该能力常用语言的示例代码，请参见[人体检测示例代码](~~601107~~)。', + .'阿里云视觉AI人脸人体类目下的人像素描风格化能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。', 'extraInfo' => '## 错误码'."\n" - .'关于人体检测的错误码 ，详情请参见[常见错误码](~~146756~~)。'."\n" - ."\n" - .'## 开源模型体验'."\n" - .'更多开源免费模型体验及下载，详见魔搭社区：[人体检测-通用-Base](https://modelscope.cn/models/damo/cv_resnet18_human-detection/summary)和[实时人体检测-通用](https://modelscope.cn/models/damo/cv_tinynas_human-detection_damoyolo/summary)。'."\n" + .'关于人像素描风格化的错误码，详情请参见[常见错误码](~~146756~~)。'."\n" ."\n" .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。', - ], - 'PedestrianDetectAttribute' => [ - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-facebody:GenerateHumanSketchStyle', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + ], + 'GetFaceEntity' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -5601,358 +4370,83 @@ ], 'operationType' => 'read', 'deprecated' => false, - 'systemTags' => [], + 'systemTags' => ['operationType' => 'get'], 'parameters' => [ [ - 'name' => 'ImageURL', + 'name' => 'DbName', 'in' => 'formData', - 'schema' => [ - 'description' => '图像URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。', - 'type' => 'string', - 'required' => true, - 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/PedestrianDetectAttribute/PedestrianDetectAttribute1.jpg', - 'isFileTransferUrl' => true, - ], + 'schema' => ['description' => '数据库名称。', 'type' => 'string', 'required' => true, 'example' => 'default'], + ], + [ + 'name' => 'EntityId', + 'in' => 'formData', + 'schema' => ['description' => '实体ID。可以包含数字、字母和下划线。', 'type' => 'string', 'required' => true, 'example' => '66'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'description' => '1', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '4F609A30-F645-481E-A513-CADAA14DFB0A', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'DA7CAFEB-0A37-4496-9CDF-E3DBB6309CB2'], 'Data' => [ 'description' => '返回的结果数据内容。', 'type' => 'object', 'properties' => [ - 'Attributes' => [ - 'description' => '行人属性。', - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'Gender' => [ - 'description' => '性别。', - 'type' => 'object', - 'properties' => [ - 'Score' => [ - 'description' => '置信度。', - 'type' => 'number', - 'format' => 'float', - 'example' => '0.97989875078201294', - ], - 'Name' => [ - 'description' => 'male（男）；female（女）。', - 'type' => 'string', - 'example' => 'female', - ], - ], - ], - 'Orient' => [ - 'description' => '人体朝向。', - 'type' => 'object', - 'properties' => [ - 'Score' => [ - 'description' => '置信度。', - 'type' => 'number', - 'format' => 'float', - 'example' => '0.97838658094406128', - ], - 'Name' => [ - 'description' => 'Front（正向）；Side（侧向）；Back（背面）。', - 'type' => 'string', - 'example' => 'Front', - ], - ], - ], - 'Age' => [ - 'description' => '年龄。', - 'type' => 'object', - 'properties' => [ - 'Score' => [ - 'description' => '置信度。', - 'type' => 'number', - 'format' => 'float', - 'example' => '0.99590516090393066', - ], - 'Name' => [ - 'description' => 'AgeOver60（大于60岁）；Age18-60（18-60岁之间）；AgeLess18（小于18岁）。', - 'type' => 'string', - 'example' => 'Age18-60', - ], - ], - ], - 'UpperWear' => [ - 'description' => '上衣种类。', - 'type' => 'object', - 'properties' => [ - 'Score' => [ - 'description' => '置信度。', - 'type' => 'number', - 'format' => 'float', - 'example' => '0.89291918277740479', - ], - 'Name' => [ - 'description' => 'LongSleeve（长袖）；ShortSleeve（短袖）。', - 'type' => 'string', - 'example' => 'ShortSleeve', - ], - ], - ], - 'Glasses' => [ - 'description' => '眼镜。', - 'type' => 'object', - 'properties' => [ - 'Score' => [ - 'description' => '置信度。', - 'type' => 'number', - 'format' => 'float', - 'example' => '0.87284471094608307', - ], - 'Name' => [ - 'description' => 'Yes（戴眼镜）；No（不戴眼镜）。', - 'type' => 'string', - 'example' => 'No', - ], - ], - ], - 'LowerWear' => [ - 'description' => '下衣种类。', - 'type' => 'object', - 'properties' => [ - 'Score' => [ - 'description' => '置信度。', - 'type' => 'number', - 'format' => 'float', - 'example' => '0.6424860954284668', - ], - 'Name' => [ - 'description' => 'Trousers（长裤）；Shorts（短裤）；Skirt&Dress（裙子）。', - 'type' => 'string', - 'example' => 'Trousers', - ], - ], - ], - 'LowerColor' => [ - 'description' => '下衣颜色。', - 'type' => 'object', - 'properties' => [ - 'Score' => [ - 'description' => '置信度。', - 'type' => 'number', - 'format' => 'float', - 'example' => '0.69961744546890259', - ], - 'Name' => [ - 'description' => '黑，灰，蓝，绿，白，紫，红，棕，黄，粉，不确定。', - 'type' => 'string', - 'example' => '黑', - ], - ], - ], - 'Hat' => [ - 'description' => '帽子。', - 'type' => 'object', - 'properties' => [ - 'Score' => [ - 'description' => '置信度。', - 'type' => 'number', - 'format' => 'float', - 'example' => '0.98272394016385078', - ], - 'Name' => [ - 'description' => 'Yes（戴帽子）；No（不戴帽子）。', - 'type' => 'string', - 'example' => 'No', - ], - ], - ], - 'Handbag' => [ - 'description' => '手提包。', - 'type' => 'object', - 'properties' => [ - 'Score' => [ - 'description' => '置信度。', - 'type' => 'number', - 'format' => 'float', - 'example' => '0.55011671781539917', - ], - 'Name' => [ - 'description' => 'Yes（有手提包）；No（无手提包）。', - 'type' => 'string', - 'example' => 'Yes', - ], - ], - ], - 'Backpack' => [ - 'description' => '背包。', - 'type' => 'object', - 'properties' => [ - 'Score' => [ - 'description' => '置信度。', - 'type' => 'number', - 'format' => 'float', - 'example' => '0.96486538648605347', - ], - 'Name' => [ - 'description' => 'Yes（有背包）；No（无背包）。', - 'type' => 'string', - 'example' => 'No', - ], - ], - ], - 'UpperColor' => [ - 'description' => '上衣颜色。', - 'type' => 'object', - 'properties' => [ - 'Score' => [ - 'description' => '置信度。', - 'type' => 'number', - 'format' => 'float', - 'example' => '0.97796273231506348', - ], - 'Name' => [ - 'description' => '黑，灰，蓝，绿，白，紫，红，棕，黄，粉，不确定。', - 'type' => 'string', - 'example' => '黄', - ], - ], - ], - 'ShoulderBag' => [ - 'description' => '肩挎包。', - 'type' => 'object', - 'properties' => [ - 'Score' => [ - 'description' => '置信度。', - 'type' => 'number', - 'format' => 'float', - 'example' => '0.91198787838220596', - ], - 'Name' => [ - 'description' => 'Yes（有肩挎包）；No（无肩挎包）。', - 'type' => 'string', - 'example' => 'No', - ], - ], - ], - ], - ], - ], - 'Boxes' => [ - 'description' => '检测到行人边界框的坐标。', + 'DbName' => ['description' => '数据库名称。', 'type' => 'string', 'example' => 'default'], + 'EntityId' => ['description' => '实体ID。', 'type' => 'string', 'example' => '66'], + 'Labels' => ['description' => '查询到的人脸标签。', 'type' => 'string', 'example' => '工厂'], + 'Faces' => [ + 'description' => '查询到的人脸数据。', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ - 'BottomRightX' => [ - 'description' => '边框右下角x坐标值。', - 'type' => 'number', - 'format' => 'float', - 'example' => '584', - ], - 'TopLeftY' => [ - 'description' => '边框左上角y坐标值。', - 'type' => 'number', - 'format' => 'float', - 'example' => '27', - ], - 'Score' => [ - 'description' => '边界框置信度。', - 'type' => 'number', - 'format' => 'float', - 'example' => '0.88381063938140869', - ], - 'TopLeftX' => [ - 'description' => '边框左上角x坐标值。', - 'type' => 'number', - 'format' => 'float', - 'example' => '36', - ], - 'BottomRightY' => [ - 'description' => '边框右下角y坐标值。', - 'type' => 'number', - 'format' => 'float', - 'example' => '218', - ], + 'FaceId' => ['description' => '人脸数据ID。', 'type' => 'string', 'example' => '3'], ], + 'description' => '', ], ], - 'PersonNumber' => [ - 'description' => '检测到的行人个数，取值为正整数。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'Width' => [ - 'description' => '原图的宽度，单位像素。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '264', - ], - 'Height' => [ - 'description' => '原图的高度，单位像素。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '584', - ], ], ], ], + 'description' => '', ], ], ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'ParameterError', - 'errorMessage' => 'The parameter is invalid. Please check again.', - ], + ['errorCode' => 'ParameterError', 'errorMessage' => 'The parameter is invalid. Please check again.', 'description' => '参数错误，请检查参数值'], ], 403 => [ - [ - 'errorCode' => 'AuthFailed', - 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', - ], + ['errorCode' => 'AuthFailed', 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', 'description' => '授权失败，请检查RAM权限配置'], ], 408 => [ - [ - 'errorCode' => 'Timeout', - 'errorMessage' => 'The request has timed out.', - ], + ['errorCode' => 'Timeout', 'errorMessage' => 'The request has timed out.', 'description' => '请求超时，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'The service is unavailable.', - ], + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'The service is unavailable.', 'description' => '服务不可用，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"4F609A30-F645-481E-A513-CADAA14DFB0A\\",\\n \\"Data\\": {\\n \\"Attributes\\": [\\n {\\n \\"Gender\\": {\\n \\"Score\\": 0.9798987507820129,\\n \\"Name\\": \\"female\\"\\n },\\n \\"Orient\\": {\\n \\"Score\\": 0.9783865809440613,\\n \\"Name\\": \\"Front\\"\\n },\\n \\"Age\\": {\\n \\"Score\\": 0.9959051609039307,\\n \\"Name\\": \\"Age18-60\\"\\n },\\n \\"UpperWear\\": {\\n \\"Score\\": 0.8929191827774048,\\n \\"Name\\": \\"ShortSleeve\\"\\n },\\n \\"Glasses\\": {\\n \\"Score\\": 0.8728447109460831,\\n \\"Name\\": \\"No\\"\\n },\\n \\"LowerWear\\": {\\n \\"Score\\": 0.6424860954284668,\\n \\"Name\\": \\"Trousers\\"\\n },\\n \\"LowerColor\\": {\\n \\"Score\\": 0.6996174454689026,\\n \\"Name\\": \\"黑\\"\\n },\\n \\"Hat\\": {\\n \\"Score\\": 0.9827239401638508,\\n \\"Name\\": \\"No\\"\\n },\\n \\"Handbag\\": {\\n \\"Score\\": 0.5501167178153992,\\n \\"Name\\": \\"Yes\\"\\n },\\n \\"Backpack\\": {\\n \\"Score\\": 0.9648653864860535,\\n \\"Name\\": \\"No\\"\\n },\\n \\"UpperColor\\": {\\n \\"Score\\": 0.9779627323150635,\\n \\"Name\\": \\"黄\\"\\n },\\n \\"ShoulderBag\\": {\\n \\"Score\\": 0.911987878382206,\\n \\"Name\\": \\"No\\"\\n }\\n }\\n ],\\n \\"Boxes\\": [\\n {\\n \\"BottomRightX\\": 584,\\n \\"TopLeftY\\": 27,\\n \\"Score\\": 0.8838106393814087,\\n \\"TopLeftX\\": 36,\\n \\"BottomRightY\\": 218\\n }\\n ],\\n \\"PersonNumber\\": 1,\\n \\"Width\\": 264,\\n \\"Height\\": 584\\n }\\n}","errorExample":""},{"type":"xml","example":"4F609A30-F645-481E-A513-CADAA14DFB0A\\n\\n 1\\n \\n \\n 0.96486538648605347\\n No\\n \\n \\n 0.6424860954284668\\n Trousers\\n \\n \\n 0.97838658094406128\\n Front\\n \\n \\n 0.91198787838220596\\n No\\n \\n \\n 0.69961744546890259\\n 黑\\n \\n \\n 0.87284471094608307\\n No\\n \\n \\n 0.97796273231506348\\n 黄\\n \\n \\n 0.55011671781539917\\n Yes\\n \\n \\n 0.98272394016385078\\n No\\n \\n \\n 0.97989875078201294\\n female\\n \\n \\n 0.99590516090393066\\n Age18-60\\n \\n \\n 0.89291918277740479\\n ShortSleeve\\n \\n \\n \\n 584\\n 0.88381063938140869\\n 218\\n 27\\n 36\\n \\n","errorExample":""}]', - 'title' => '人体结构化属性', - 'summary' => '本文介绍人体结构化属性PedestrianDetectAttribute的语法及示例。', + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"DA7CAFEB-0A37-4496-9CDF-E3DBB6309CB2\\",\\n \\"Data\\": {\\n \\"DbName\\": \\"default\\",\\n \\"EntityId\\": \\"66\\",\\n \\"Labels\\": \\"工厂\\",\\n \\"Faces\\": [\\n {\\n \\"FaceId\\": \\"3\\"\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"DA7CAFEB-0A37-4496-9CDF-E3DBB6309CB2\\n\\n default\\n 66\\n 工厂\\n \\n 3\\n \\n","errorExample":""}]', + 'title' => '查询人脸样本', + 'summary' => '本文介绍查询人脸样本GetFaceEntity的语法及示例。', 'description' => '## 功能描述'."\n" - .'人体结构化属性能力可以检测图片中人体的属性，具体功能包括人体检测以及属性预估。例如：性别、年龄、朝向、帽子、眼镜、包、衣服、颜色等。'."\n" + .'查询人脸样本能力用于查询人脸数据库中的人脸样本数据。'."\n" ."\n" .'> - 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" - .'- 当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击[立即试用](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=PedestrianDetectAttribute)对该能力进行更直观试用以及在线购买。'."\n" .'- 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。'."\n" ."\n" - .'## 特色优势'."\n" - .'丰富属性：提供丰富人体属性，包括年龄、性别、是否带眼镜、有无帽子、有无背包、有无手提包、有无肩挎包、上衣颜色、上衣种类、下衣颜色、下衣种类、人体朝向等。'."\n" - ."\n" .'## 接入指引'."\n" .'1. 注册阿里云账号：打开[阿里云官网](https://www.aliyun.com)，在阿里云官网右上角，单击**立即注册**，按照操作提示完成账号注册。'."\n" .'2. 开通能力：请确保您已开通[人脸人体服务](https://vision.aliyun.com/facebody)，若未开通服务请[立即开通](https://common-buy.aliyun.com/?commodityCode=viapi_facebody_public_cn#/open)。'."\n" ."\n" - .'> 本能力支持企业或个人认证用户开通。更多实名认证操作信息，请参见[实名认证](https://help.aliyun.com/knowledge_list/37170.html)。'."\n" + .'>'."\n" + .'本能力支持企业或个人认证用户开通。更多实名认证操作信息，请参见[实名认证](https://help.aliyun.com/zh/account/user-guide/real-name-authentication/)。'."\n" + .'>'."\n" ."\n" .'3. 创建AccessKey：请确保您已[创建AccessKey](~~175144~~)，如果您使用的是子账号AccessKey，您需要给子账号赋予AliyunVIAPIFullAccess权限，具体操作，请参见[RAM授权](~~145025~~)。'."\n" - .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/facebody/2019-12-30/PedestrianDetectAttribute?lang=JAVA&sdkStyle=old¶ms=%7B%22ImageURL%22%3A%22http%3A%2F%2Fviapi-test.oss-cn-shanghai.aliyuncs.com%2Fviapi-3.0domepic%2Ffacebody%2FPedestrianDetectAttribute%2FPedestrianDetectAttribute1.jpg%22%7D&tab=DEMO)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" + .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/facebody/2019-12-30/GetFaceEntity?lang=JAVA)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" .'5. 开发接入步骤：'."\n" .'- 在[SDK总览](~~145033~~)中选择您要接入使用的SDK语言。'."\n" .'- 在对应语言的SDK文档中找到AI类目为人脸人体（facebody）的SDK包进行安装。'."\n" @@ -5964,41 +4458,40 @@ .'- [Android端直接调用](~~467781~~)'."\n" .'- [iOS端直接调用](~~467782~~)'."\n" ."\n" - .'## 输入限制'."\n" - ."\n" - .'- 图像格式：JPG、JPEG、PNG、BMP。'."\n" - ."\n" - .'- 图像大小：不大于3 MB。'."\n" - ."\n" - .'- 图像分辨率：大于20×20像素，小于2048×2048像素。'."\n" - ."\n" - .'- URL地址中不能包含中文字符。'."\n" - ."\n" - .'> 当图像分辨率超过最大限制时，请先将图片进行缩放，调整图片大小，具体请参见[图片缩放](~~44688~~)。'."\n" + .'## 限制说明'."\n" + .'查询人脸样本接口提交任务并发默认为2QPS。'."\n" ."\n" .'## 计费说明'."\n" - .'关于人体结构化属性的计费方式及报价，请参见[计费介绍](~~184049~~)。'."\n" - .'> 下方调试接口为付费接口，如需免费体验调试请前往[体验中心](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=PedestrianDetectAttribute)。', + .'查询人脸样本能力可免费调用。', 'requestParamsDescription' => ' ', 'responseParamsDescription' => '## SDK参考'."\n" - .'阿里云视觉AI人脸人体类目下的人体结构化属性能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。', + .'阿里云视觉AI人脸人体类目下的查询人脸样本能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。', 'extraInfo' => '## 错误码'."\n" - .'关于人体结构化属性的错误码，详情请参见[常见错误码](~~146756~~)。'."\n" + .'关于查询人脸样本的错误码，详情请参见[常见错误码](~~146756~~)。'."\n" ."\n" .'## 安全声明'."\n" - ."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" - .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。', + .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。'."\n" + .'- 平台不存储用户在使用服务过程中涉及的原始人脸图片或文件信息。'."\n" + .'- 平台针对超过6个月及以上没有API服务调用的用户的人脸特征向量数据进行冻结，确保无服务调用的客户信息安全。如需解冻，请通过钉钉群（23109592）联系我们。', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'viapi-facebody:GetFaceEntity', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + ], ], 'GetRealPersonVerificationResult' => [ - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -6006,22 +4499,14 @@ ], 'operationType' => 'read', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'get', - ], + 'systemTags' => ['operationType' => 'get'], 'parameters' => [ [ 'name' => 'VerificationToken', 'in' => 'formData', - 'schema' => [ - 'description' => '可信核身认证的唯一标识。'."\n" - ."\n" - .'> 已认证通过的VerificationToken不能做二次查询校验，否则会报错。', - 'type' => 'string', - 'required' => true, - 'example' => 'cwek23dw24geor89230hf2rw', - 'isFileTransferUrl' => false, - ], + 'schema' => ['description' => '可信核身认证的唯一标识。'."\n" + ."\n" + .'> 已认证通过的VerificationToken不能做二次查询校验，否则会报错。', 'type' => 'string', 'required' => true, 'example' => 'cwek23dw24geor89230hf2rw', 'isFileTransferUrl' => false], ], ], 'responses' => [ @@ -6030,23 +4515,15 @@ 'description' => '返回结构体。', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '10FC953D-7C0C-4915-8949-34E3246E5B79', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '10FC953D-7C0C-4915-8949-34E3246E5B79'], 'Data' => [ 'description' => '返回的结果数据内容。', 'type' => 'object', 'properties' => [ - 'Passed' => [ - 'description' => '认证是否通过。'."\n" - ."\n" - .'- true：通过。'."\n" - .'- false：不通过。', - 'type' => 'boolean', - 'example' => 'true', - ], + 'Passed' => ['description' => '认证是否通过。'."\n" + ."\n" + .'- true：通过。'."\n" + .'- false：不通过。', 'type' => 'boolean', 'example' => 'true'], ], ], ], @@ -6055,28 +4532,16 @@ ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'ParameterError', - 'errorMessage' => 'The parameter is invalid. Please check again.', - ], + ['errorCode' => 'ParameterError', 'errorMessage' => 'The parameter is invalid. Please check again.', 'description' => '参数错误，请检查参数值'], ], 403 => [ - [ - 'errorCode' => 'AuthFailed', - 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', - ], + ['errorCode' => 'AuthFailed', 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', 'description' => '授权失败，请检查RAM权限配置'], ], 408 => [ - [ - 'errorCode' => 'Timeout', - 'errorMessage' => 'The request has timed out.', - ], + ['errorCode' => 'Timeout', 'errorMessage' => 'The request has timed out.', 'description' => '请求超时，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'The service is unavailable.', - ], + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'The service is unavailable.', 'description' => '服务不可用，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"10FC953D-7C0C-4915-8949-34E3246E5B79\\",\\n \\"Data\\": {\\n \\"Passed\\": true\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n 10FC953D-7C0C-4915-8949-34E3246E5B79\\n \\n true\\n \\n","errorExample":""}]', @@ -6146,80 +4611,66 @@ .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。'."\n" .'- 平台不存储用户在使用服务过程中涉及的原始人脸图片或文件信息。', - ], - 'GenRealPersonVerificationToken' => [ - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'viapi-facebody:GetRealPersonVerificationResult', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + ], + 'LiquifyFace' => [ + 'summary' => '本文介绍智能瘦脸LiquifyFace的语法及示例。', + 'methods' => ['post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [], 'parameters' => [ [ - 'name' => 'CertificateName', - 'in' => 'formData', - 'schema' => [ - 'description' => '被校验的身份证人名。', - 'type' => 'string', - 'required' => true, - 'example' => '张三', - 'isFileTransferUrl' => false, - ], - ], - [ - 'name' => 'CertificateNumber', + 'name' => 'ImageURL', 'in' => 'formData', - 'schema' => [ - 'description' => '身份证号码。', - 'type' => 'string', - 'required' => true, - 'example' => '33010219001123123X', - ], + 'schema' => ['description' => '图像URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。'."\n" + .'图片格式要求：'."\n" + ."\n" + .'- 图像格式：JPG、JPEG、PNG。'."\n" + .'- 图像大小：不超过6 MB。'."\n" + .'- 图像分辨率：大于等于128×128像素，小于等于5000×5000像素，最长边小于等于5000像素。'."\n" + .'- 图像内容：至少包含1个人脸，最多不超过3个人脸，且人脸占比超过64x64像素。'."\n" + .'- URL地址中不能包含中文字符。'."\n" + .'> 图像内容：当图像分辨率超过最大限制时，请先将图片进行缩放，调整图片大小，具体请参见[图片缩放](~~44688~~)。', 'type' => 'string', 'required' => true, 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/LiquifyFace/LiquifyFace1.png', 'isFileTransferUrl' => true], ], [ - 'name' => 'MetaInfo', + 'name' => 'SlimDegree', 'in' => 'formData', - 'schema' => [ - 'description' => 'metainfo环境参数，需要通过客户端SDK获取。Android SDK通过getMetaInfos获取，iOS SDK通过getMetaInfo获取。', - 'type' => 'string', - 'required' => true, - 'example' => '{"dwe":"ew4e"...}', - ], + 'schema' => ['description' => '标准力度。取值范围为\\[0,2.0]，默认为1.0。数值越大，瘦脸效果越明显。', 'type' => 'number', 'format' => 'float', 'required' => false, 'maximum' => '2', 'minimum' => '0', 'example' => '1.0', 'default' => '1'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'description' => '返回结构体。', + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'A31006F2-22E7-4538-93BB-DE6B563643EE', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => 'CA1C8937-B30C-15E6-B804-41C357BA413B'], 'Data' => [ - 'description' => '返回的结果数据内容。', + 'description' => '返回的数据内容。', 'type' => 'object', 'properties' => [ - 'VerificationToken' => [ - 'description' => '可信核身认证的唯一标识。'."\n" - ."\n" - .'> - 核身认证移动端请求后未进行核身认证移动端查询就没有活体和风控结果，整体认证存在一定风险，建议移动端请求结束后进行[核身认证移动端查询](~~198724~~)，完成整体认证流程。'."\n" - .'- 调用核身认证移动端请求接口返回的verificationToken有效期时间为30分钟，从verificationToken生成时间开始算起，超过有效期再进行人脸认证会报错，请在有效期时间内完成认证。', - 'type' => 'string', - 'example' => '9fca3791c158a479ead9f2ba65ab3XXX', - ], + 'ImageURL' => ['description' => '瘦脸后图像的URL地址。'."\n" + .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。', 'type' => 'string', 'example' => 'http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/face-liquify/CA1C8937-B30C-15E6-B804-41C357BA413B_5eca_20210923-093411.jpg?Expires=1632391451&OSSAccessKeyId=LTAI****************&Signature=46apJQVNBz%2FFzDLEYn2M1w9MKA****'], ], ], ], @@ -6228,123 +4679,106 @@ ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'ParameterError', - 'errorMessage' => 'The parameter is invalid. Please check again.', - ], + ['errorCode' => 'ParameterError', 'errorMessage' => 'The parameter is invalid. Please check again.', 'description' => '参数错误，请检查参数值'], ], 403 => [ - [ - 'errorCode' => 'AuthFailed', - 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', - ], + ['errorCode' => 'AuthFailed', 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', 'description' => '授权失败，请检查RAM权限配置'], ], 408 => [ - [ - 'errorCode' => 'Timeout', - 'errorMessage' => 'The request has timed out.', - ], + ['errorCode' => 'Timeout', 'errorMessage' => 'The request has timed out.', 'description' => '请求超时，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'The service is unavailable.', - ], + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'The service is unavailable.', 'description' => '服务不可用，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"A31006F2-22E7-4538-93BB-DE6B563643EE\\",\\n \\"Data\\": {\\n \\"VerificationToken\\": \\"9fca3791c158a479ead9f2ba65ab3XXX\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"A31006F2-22E7-4538-93BB-DE6B563643EE\\n\\n 9fca3791c158a479ead9f2ba65ab3XXX\\n","errorExample":""}]', - 'title' => '生成实人认证会话令牌', - 'summary' => '核身认证请求。', + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"CA1C8937-B30C-15E6-B804-41C357BA413B\\",\\n \\"Data\\": {\\n \\"ImageURL\\": \\"http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/face-liquify/CA1C8937-B30C-15E6-B804-41C357BA413B_5eca_20210923-093411.jpg?Expires=1632391451&OSSAccessKeyId=LTAI****************&Signature=46apJQVNBz%2FFzDLEYn2M1w9MKA****\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n CA1C8937-B30C-15E6-B804-41C357BA413B\\n \\n http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/face-liquify/CA1C8937-B30C-15E6-B804-41C357BA413B_5eca_20210923-093411.jpg?Expires=1632391451&OSSAccessKeyId=LTAI****************&Signature=46apJQVNBz%2FFzDLEYn2M1w9MKA****\\n \\n","errorExample":""}]', + 'title' => '智能瘦脸', 'description' => '## 功能描述'."\n" - .'核身认证移动端请求能力可以在移动端依据被验证的人名和身份证号码，请求身份验证的用户图像信息。'."\n" + .'智能瘦脸功能可实现输入一张人物图像，输出脸部五官调整瘦脸后的图像。'."\n" + .'关于该接口功能的示例图如下：'."\n" + .'- 输入原图'."\n" + .'![原始图像](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20221108/smvg/LiquifyFace.png" width="250)'."\n" + ."\n" + .'- 输出结果图'."\n" + .'![瘦脸效果](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20221108/ssiz/LiquifyFaceshoulian.jpg" width="250)'."\n" ."\n" .'> - 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" + .'- 当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击[立即试用](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=LiquifyFace)对该能力进行更直观试用以及在线购买。'."\n" .'- 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。'."\n" ."\n" .'## 应用场景'."\n" - .'- 金融机构网上开户：在金融行业手机App注册开户，通过实人认证，验证开户用户真实身份，降低运营成本，提升风控水平。'."\n" - .'- 线上政务平台注册：疫情期间，政府在App中推出线上口罩预约功能，实施实人认证，可有效防止同一人当天重复领取口罩，导致分配不均。'."\n" - .'- 修改密码或手机号码：在移动互联网App修改密码，或绑定手机号码时，通过实人认证进行用户真实身份确认。'."\n" - .'- 网约车司机认证：网约车当前运营司机身份确认，防止冒用身份驾驶运营车辆。'."\n" - .'- 金融风控：在支付、挂失、解冻、转账、取款、信贷、理财等各个环节进行用户身份验证，做好金融风险管控。'."\n" + ."\n" + .'- 移动App：输入一张自拍照，通过智能瘦脸算法能力，生成更具魅力的面庞。'."\n" + .'- 写真自拍：对大量修图需求进行批量智能瘦脸，助力婚纱影楼或图像直播场景，降本提效。'."\n" ."\n" .'## 特色优势'."\n" ."\n" - .'- 金融级的指标：误识率低于1/100000，准确率高于99%。'."\n" - .'- 成熟行业应用：服务超过2亿互联网金融用户，保障超过20亿次交易安全。'."\n" - .'- 秒级活体检测：无需复杂交互动作，只需秒级即可完成活体检测，更高效，同时也具备更高级别私密性，更高安全性。'."\n" - .'- 通过金融级防攻击测试：抵御各种真实发生的伪造攻击，权威数据源验证。'."\n" - .'- 低成本落地方案：纯软件方案，支持普通摄像头，成本极低，适配室内外。'."\n" - .'- 国内外权威认证：通过公安部认证、ISO 27001信息安全体系认证，ISO30107-3人脸活体防攻击认证（iBeta PAD Level1）， ISO/TC68。'."\n" + .'- 精准刻画：通过深度学习算法，精准分析人脸五官特征，实现完美自然的面部美型效果。'."\n" + .'- 支持多角度：正面侧面等多种角度的人脸均能智能判别和处理。'."\n" + .'- 支持多人脸：支持单人脸或多人脸的精准美型。'."\n" ."\n" .'## 接入指引'."\n" .'1. 注册阿里云账号：打开[阿里云官网](https://www.aliyun.com)，在阿里云官网右上角，单击**立即注册**，按照操作提示完成账号注册。'."\n" - .'2. 请确保您已开通[人脸人体服务](https://vision.aliyun.com/facebody)，若未开通服务请[立即开通](https://common-buy.aliyun.com/?commodityCode=viapi_facebody_public_cn#/open)。'."\n" - ."\n" - .'>'."\n" - .'本能力支持企业或个人认证用户开通。更多实名认证操作信息，请参见[实名认证](https://help.aliyun.com/knowledge_list/37170.html)。'."\n" - .'>'."\n" - ."\n" + .'2. 开通能力：请确保您已开通[人脸人体服务](https://vision.aliyun.com/facebody)，若未开通服务请[立即开通](https://common-buy.aliyun.com/?commodityCode=viapi_facebody_public_cn#/open)。'."\n" + .'> 本能力支持企业或个人认证用户开通。更多实名认证操作信息，请参见[实名认证](https://help.aliyun.com/knowledge_list/37170.html)。'."\n" .'3. 创建AccessKey：请确保您已[创建AccessKey](~~175144~~)，如果您使用的是子账号AccessKey，您需要给子账号赋予AliyunVIAPIFullAccess权限，具体操作，请参见[RAM授权](~~145025~~)。'."\n" - .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/facebody/2019-12-30/GenRealPersonVerificationToken?lang=JAVA)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" + .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/facebody/2019-12-30/LiquifyFace?lang=JAVA&sdkStyle=dara¶ms=%7B%22ImageURL%22%3A%22http%3A%2F%2Fviapi-test.oss-cn-shanghai.aliyuncs.com%2Fviapi-3.0domepic%2Ffacebody%2FLiquifyFace%2FLiquifyFace1.png%22%7D&tab=DEMO)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" .'5. 开发接入步骤：'."\n" .'- 在[SDK总览](~~145033~~)中选择您要接入使用的SDK语言。'."\n" .'- 在对应语言的SDK文档中找到AI类目为人脸人体（facebody）的SDK包进行安装。'."\n" .'- 参考文档中提供的示例代码进行适当修改后调用。'."\n" ."\n" - .'6. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" + .'6. 示例代码：该能力常用语言的示例代码，请参见[智能瘦脸示例代码](~~2253469~~)。'."\n" + ."\n" + .'7. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" .'- [Web前端直接调用](~~467779~~)'."\n" .'- [小程序场景下直接调用](~~467780~~)'."\n" .'- [Android端直接调用](~~467781~~)'."\n" .'- [iOS端直接调用](~~467782~~)'."\n" ."\n" - .'## 计费说明'."\n" - .'关于核身认证移动端请求的计费方式及报价，请参见[计费介绍](~~184049~~)。'."\n" + .'## 输入限制'."\n" + .'- 图像格式：JPG、JPEG、PNG。'."\n" + .'- 图像大小：不超过6 MB。'."\n" + .'- 图像分辨率：大于等于128×128像素，小于等于5000×5000像素，最长边小于等于5000像素。'."\n" + .'- 图像内容：至少包含1个人脸，最多不超过3个人脸，且人脸占比超过64x64像素。'."\n" + .'- URL地址中不能包含中文字符。'."\n" ."\n" - .'> 下方调试接口为付费接口。', + .'>当图像分辨率超过最大限制时，请先将图片进行缩放，调整图片大小，具体请参见[图片缩放](~~44688~~)。 '."\n" + ."\n" + .'## 计费说明'."\n" + .'关于智能瘦脸的计费方式及报价，请参见[计费介绍](~~184049~~)。', 'responseParamsDescription' => '## SDK参考'."\n" - .'阿里云视觉AI能力支持使用SDK调用，具体可参见：'."\n" - .'- [服务端接入教程](~~201625~~)'."\n" - .'- [iOS端接入教程](~~201379~~)'."\n" - .'- [Android端接入教程](~~201380~~)', + .'阿里云视觉AI人脸人体类目下的智能瘦脸能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。'."\n" + ."\n" + .'## 示例代码'."\n" + .'该能力常用语言的示例代码，请参见[智能瘦脸示例代码](~~2253469~~)。', 'extraInfo' => '## 错误码'."\n" - .'关于核身认证移动端请求的错误码如下表所示。'."\n" - .'| 状态码 | 错误码 | 描述 |'."\n" - .'| ------ | ---------------------------- | ------------------------------------------------------------ |'."\n" - .'| 200 | 无错误码 | 刷脸认证通过。 |'."\n" - .'| 400 | INVALID_PARAMETER | 查询时传入参数不正确。联系接口提供方技术人员排查。例如身份证格式不正确。（Z8105） |'."\n" - .'| 400 | NOT_SAME_PERSON | 刷脸认证未通过，识别结果为非本人，请确认是否为本人再发起认证。抱歉，没有认出您。（Z1146） |'."\n" - .'| 500 | PROCESSING | 刷脸认证未完成。请重试，如果一直不成功，联系接口提供方技术人员排查。 |'."\n" - .'| 500 | PROCESSING | 图片安全检测不通过，请确认图片是否为正常拍摄图片。（Z1146） |'."\n" - .'| 500 | PROCESSING | 系统出错了，请您稍后再试，如果多次重试依然报错，请记录好RequestId联系阿里云技术支持工程师。（Z5137） |'."\n" - .'| 500 | INVALID_PARAM | 抱歉，系统出错了，请您稍后再试 ，如果多次重试依然报错，请记录好RequestId联系阿里云技术支持工程师。（Z5136） |'."\n" - .'| 400 | UNABLE_GET_IMAGE | 比对源不可用。远程公安网没有留底图片，无法比对。请记录好RequestId联系阿里云技术支持工程师。（Z1104） |'."\n" - .'| 400 | HIGH_RISK | 刷脸频次过高或失败次数过多，请您24小时后再来尝试。（Z1114） |'."\n" - .'| 400 | EXTRACT_FACE_FAIL | 图片提取不到人脸特征，请确认图片中是否包含人脸信息。（Z1156） |'."\n" - .'| 400 | INITIALIZE_INVALID_CERT_NAME | 姓名无效，请填写正确的姓名。(Z8109) |'."\n" - .'| 400 | INITIALIZE_INVALID_CERT_AGE | 未满14周岁的用户无法使用本产品，建议人工审核。(Z8110) |'."\n" - .'| 400 | INITIALIZE_INVALID_CERT_NO | 用户身份证号码信息无效，请填写正确的身份号码信息。(Z8111) |'."\n" - .'| 400 | QUERY_INVALID_CERTIFYID | 身份认证记录不存在，该CertifyId还没有对应的身份认证提交记录。(Z8304) |'."\n" - .'| 400 | QUERY_IMG_IS_NONE | 查询不到照片或照片不可用，可能是公安库数据问题导致。(Z8305) |'."\n" - .'| 400 | QUERY_CERTINFO_IS_NONE | 查询不到身份信息，可能是用户户口迁移、军人等特殊状态导致。(Z8306) |'."\n" - .'| 400 | QUERY_CERTINFO_ISNOT_MATCH | 姓名和身份证不一致，可能是用户的信息有误或用户的信息为假信息，建议用户确认后重新操作。(Z8307) |'."\n" - .'| 400 | QUERY_OCR_ISNOT_MATCH | 使用OCR方案时，人脸与身份证上人脸比对不一致，可能人证不符或人脸照片质量较低，建议根据业务情况分层处理，若为同一人可重新操作。(Z8308) |'."\n" - .'| 500 | SYSTEM_ERROR | 查询时发生系统错误。请重试，如果依然报错，请记录好RequestId联系阿里云技术支持工程师。（Z5139） |'."\n" + .'关于智能瘦脸的错误码，详情请参见[常见错误码](~~146756~~)。'."\n" + ."\n" + .'## 开源模型体验'."\n" + .'更多开源免费模型体验及下载，详见魔搭社区：[106点人脸关键点-通用领域-2D](https://www.modelscope.cn/models/damo/cv_mobilenet_face-2d-keypoints_alignment/summary)。'."\n" ."\n" .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" - .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。'."\n" - .'- 平台不存储用户在使用服务过程中涉及的原始人脸图片或文件信息。', - ], - 'DetectCelebrity' => [ - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', + .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-facebody:LiquifyFace', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + ], + 'ListFaceDbs' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -6352,125 +4786,79 @@ ], 'operationType' => 'read', 'deprecated' => false, - 'systemTags' => [], + 'systemTags' => ['operationType' => 'get'], 'parameters' => [ [ - 'name' => 'ImageURL', + 'name' => 'Offset', 'in' => 'formData', - 'schema' => [ - 'description' => '图像URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。', - 'type' => 'string', - 'required' => true, - 'example' => 'https://viapi-oss.oss-cn-shanghai.aliyuncs.com/doc/facebody/xxx.jpg', - 'isFileTransferUrl' => true, - ], + 'schema' => ['description' => '默认起始页从0开始，不填写默认从0页开始返回数据。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '1'], + ], + [ + 'name' => 'Limit', + 'in' => 'formData', + 'schema' => ['description' => '每页最多显示的样本数目，范围1~200，默认200。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '50'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'description' => '1', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '4E92C0D4-BB0F-4F25-AD13-E87D02FAA205', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '2B93C43A-F824-40C8-AF79-844342B0F43A'], 'Data' => [ - 'description' => '返回的结果数据内容。', + 'description' => '返回的数据内容。', 'type' => 'object', 'properties' => [ - 'FaceRecognizeResults' => [ - 'description' => '识别结果数据。', + 'DbList' => [ + 'description' => '数据库列表。', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ - 'FaceBoxes' => [ - 'description' => '1', - 'type' => 'array', - 'items' => [ - 'description' => '人脸框坐标信息。格式为`[x，y，width，height]`。x和y为人脸框的左上角坐标，width和height为人脸框的宽和高。x、y、width和height四个值均为人脸框与输入图像宽和高的等比值。', - 'type' => 'number', - 'format' => 'float', - 'example' => '[0.285,0.202,0.534,0.721]', - ], - ], - 'Name' => [ - 'description' => '识别出的人物名称。', - 'type' => 'string', - 'example' => '张三', - ], + 'Name' => ['description' => '数据库名称。', 'type' => 'string', 'example' => 'default'], ], + 'description' => '', ], ], - 'Width' => [ - 'description' => '图像宽度，单位像素。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1000', - ], - 'Height' => [ - 'description' => '图像高度，单位像素。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1000', - ], ], ], ], + 'description' => '', ], ], ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'ParameterError', - 'errorMessage' => 'The parameter is invalid. Please check again.', - ], + ['errorCode' => 'ParameterError', 'errorMessage' => 'The parameter is invalid. Please check again.', 'description' => '参数错误，请检查参数值'], ], 403 => [ - [ - 'errorCode' => 'AuthFailed', - 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', - ], + ['errorCode' => 'AuthFailed', 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', 'description' => '授权失败，请检查RAM权限配置'], ], 408 => [ - [ - 'errorCode' => 'Timeout', - 'errorMessage' => 'The request has timed out.', - ], + ['errorCode' => 'Timeout', 'errorMessage' => 'The request has timed out.', 'description' => '请求超时，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'The service is unavailable.', - ], + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'The service is unavailable.', 'description' => '服务不可用，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"4E92C0D4-BB0F-4F25-AD13-E87D02FAA205\\",\\n \\"Data\\": {\\n \\"FaceRecognizeResults\\": [\\n {\\n \\"FaceBoxes\\": [\\n 0\\n ],\\n \\"Name\\": \\"张三\\"\\n }\\n ],\\n \\"Width\\": 1000,\\n \\"Height\\": 1000\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n 4E92C0D4-BB0F-4F25-AD13-E87D02FAA205\\n \\n \\n 0.285\\n 0.202\\n 0.534\\n 0.721\\n 张三\\n \\n 1000\\n 1000\\n \\n","errorExample":""}]', - 'title' => '明星识别', - 'summary' => '本文介绍明星识别DetectCelebrity的语法及示例。', + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"2B93C43A-F824-40C8-AF79-844342B0F43A\\",\\n \\"Data\\": {\\n \\"DbList\\": [\\n {\\n \\"Name\\": \\"default\\"\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n 2B93C43A-F824-40C8-AF79-844342B0F43A\\n \\n \\n default\\n \\n \\n","errorExample":""}]', + 'title' => '查看人脸数据库列表', + 'summary' => '本文介绍查看数据库列表ListFaceDbs的语法及示例。', 'description' => '## 功能描述'."\n" - .'明星识别能力可以识别图像中的明星人物。可以识别超过2.7万个明星人物。'."\n" + .'本能力用于查询人脸数据库列表。人脸数据库最多只能返回200条记录。'."\n" ."\n" .'> - 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" - .'- 当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击[立即试用](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=DetectCelebrity)对该能力进行更直观试用以及在线购买。'."\n" .'- 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。'."\n" ."\n" .'## 接入指引'."\n" .'1. 注册阿里云账号：打开[阿里云官网](https://www.aliyun.com)，在阿里云官网右上角，单击**立即注册**，按照操作提示完成账号注册。'."\n" - .'2. 开通能力：'."\n" - .'- 请确保您已开通[人脸人体服务](https://vision.aliyun.com/facebody)，若未开通服务请[立即开通](https://common-buy.aliyun.com/?commodityCode=viapi_facebody_public_cn#/open)。'."\n" - .'- 开通服务后请[提交申请](https://vision.console.aliyun.com/cn-shanghai/applyopen/facebody/DetectCelebrity)，申请通过后方可使用。'."\n" - ."\n" + .'2. 开通能力：请确保您已开通[人脸人体服务](https://vision.aliyun.com/facebody)，若未开通服务请[立即开通](https://common-buy.aliyun.com/?commodityCode=viapi_facebody_public_cn#/open)。'."\n" .'>'."\n" - .'本能力仅限企业认证用户开通。更多实名认证操作信息，请参见[实名认证](https://help.aliyun.com/knowledge_list/37170.html)。'."\n" + .'本能力支持企业或个人认证用户开通。更多实名认证操作信息，请参见[实名认证](https://help.aliyun.com/knowledge_list/37170.html)。'."\n" .'>'."\n" ."\n" .'3. 创建AccessKey：请确保您已[创建AccessKey](~~175144~~)，如果您使用的是子账号AccessKey，您需要给子账号赋予AliyunVIAPIFullAccess权限，具体操作，请参见[RAM授权](~~145025~~)。'."\n" - .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/facebody/2019-12-30/DetectCelebrity?lang=JAVA&sdkStyle=dara¶ms=%7B%22ImageURL%22%3A%22%22%7D&tab=DEMO)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" + .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/facebody/2019-12-30/ListFaceDbs?lang=JAVA)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" .'5. 开发接入步骤：'."\n" .'- 在[SDK总览](~~145033~~)中选择您要接入使用的SDK语言。'."\n" .'- 在对应语言的SDK文档中找到AI类目为人脸人体（facebody）的SDK包进行安装。'."\n" @@ -6482,37 +4870,40 @@ .'- [Android端直接调用](~~467781~~)'."\n" .'- [iOS端直接调用](~~467782~~)'."\n" ."\n" - .'## 输入限制'."\n" - .'- 图像格式：JPEG、JPG、PNG。'."\n" - .'- 图像大小：不超过3 MB。'."\n" - .'- URL地址不能包含中文字符。'."\n" + .'## 限制说明'."\n" + .'查询人脸数据库列表接口提交任务并发默认为2QPS。'."\n" ."\n" .'## 计费说明'."\n" - .'关于明星识别的计费方式及报价，请参见[计费介绍](~~184049~~)。'."\n" - ."\n" - .'> 下方调试接口为付费接口，如需免费体验调试请前往[体验中心](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=DetectCelebrity)。', + .'查询人脸数据库列表能力可免费调用。', 'requestParamsDescription' => ' ', 'responseParamsDescription' => '## SDK参考'."\n" - .'阿里云视觉AI人脸人体类目下的明星识别能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。', + .'阿里云视觉AI人脸人体类目下的查询人脸数据库列表能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。', 'extraInfo' => '## 错误码'."\n" - .'关于明星识别的错误码，详情请参见[常见错误码](~~146756~~)。'."\n" + .'关于查询人脸数据库列表的错误码，详情请参见[常见错误码](~~146756~~)。'."\n" ."\n" - .'## 开源模型体验'."\n" - .'更多开源免费模型体验及下载，详见魔搭社区：[人脸识别OOD模型](https://modelscope.cn/models/damo/cv_ir_face-recognition-ood_rts/summary)、[ArcFace人脸识别模型](https://modelscope.cn/models/damo/cv_ir50_face-recognition_arcface/summary)、[IR人脸识别模型FRIR](https://modelscope.cn/models/damo/cv_manual_face-recognition_frir/summary)、[口罩人脸识别模型FRFM-large](https://modelscope.cn/models/damo/cv_manual_face-recognition_frfm/summary)、[口罩人脸识别模型FaceMask](https://modelscope.cn/models/damo/cv_resnet_face-recognition_facemask/summary)。'."\n" - ."\n\n" .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。'."\n" - .'- 平台不存储用户在使用服务过程中涉及的原始人脸图片或文件信息。', - ], - 'DetectVideoLivingFace' => [ - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'http', - 'https', + .'- 平台不存储用户在使用服务过程中涉及的原始人脸图片或文件信息。'."\n" + .'- 平台针对超过6个月及以上没有API服务调用的用户的人脸特征向量数据进行冻结，确保无服务调用的客户信息安全。如需解冻，请通过钉钉群（23109592）联系我们。', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'viapi-facebody:ListFaceDbs', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + ], + 'ListFaceEntities' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -6520,18 +4911,42 @@ ], 'operationType' => 'read', 'deprecated' => false, - 'systemTags' => [], + 'systemTags' => ['operationType' => 'get'], 'parameters' => [ [ - 'name' => 'VideoUrl', + 'name' => 'DbName', 'in' => 'formData', - 'schema' => [ - 'description' => '输入待检测人脸的视频URL。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。', - 'type' => 'string', - 'required' => true, - 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/DetectVideoLivingFace/DetectVideoLivingFace1.mp4', - 'isFileTransferUrl' => true, - ], + 'schema' => ['description' => '数据库名称。', 'type' => 'string', 'required' => true, 'example' => 'default'], + ], + [ + 'name' => 'Offset', + 'in' => 'formData', + 'schema' => ['description' => '起始记录，取值范围0~2000。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '1'], + ], + [ + 'name' => 'Limit', + 'in' => 'formData', + 'schema' => ['description' => '每页最多显示的样本数目，取值范围1~200。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '50'], + ], + [ + 'name' => 'Token', + 'in' => 'formData', + 'schema' => ['description' => '当查询结果超过2000条时，需要使用上一次请求返回的Token作为请求下一页的参数。', 'type' => 'string', 'required' => false, 'example' => '2'], + ], + [ + 'name' => 'Labels', + 'in' => 'formData', + 'schema' => ['description' => '自定义标签，最多支持10个标签，多个标签以英文逗号（,）分割。', 'type' => 'string', 'required' => false, 'example' => '视觉智能'], + ], + [ + 'name' => 'EntityIdPrefix', + 'in' => 'formData', + 'schema' => ['description' => '样本ID前缀，包含数字、字母和下划线。', 'type' => 'string', 'required' => false, 'example' => 'U1'], + ], + [ + 'name' => 'Order', + 'in' => 'formData', + 'schema' => ['description' => '排列方式。包括asc（升序）和desc（降序）。', 'type' => 'string', 'required' => false, 'example' => 'asc'], ], ], 'responses' => [ @@ -6539,94 +4954,68 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '8E92F28B-F889-48CB-9FCC-3207CFA2215E', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'DA7CAFEB-0A37-4496-9CDF-E3DBB6309CB2'], 'Data' => [ 'description' => '返回的结果数据内容。', 'type' => 'object', 'properties' => [ - 'Elements' => [ - 'description' => '检测结果数据。', + 'Token' => ['description' => '当查询结果超过2000条时，可以使用Token来查询下一页的数据。', 'type' => 'string', 'example' => '2'], + 'TotalCount' => ['description' => '人脸样本的总数量。', 'type' => 'integer', 'format' => 'int32', 'example' => '200'], + 'Entities' => [ + 'description' => '查询到的实体数据。', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ - 'Rect' => [ - 'type' => 'array', - 'items' => [ - 'description' => '检测出的人脸位置。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '[374, 6, 493,106 ]', - ], - ], - 'LiveConfidence' => [ - 'description' => '活体的置信度，取值范围为0~1。', - 'type' => 'number', - 'format' => 'float', - 'example' => '0.72464925050735474', - ], - 'FaceConfidence' => [ - 'description' => '人脸的置信度，取值范围为0~1。', - 'type' => 'number', - 'format' => 'float', - 'example' => '0.84644949436187744', - ], + 'DbName' => ['description' => '人脸样本所在的数据库名称。', 'type' => 'string', 'example' => 'default'], + 'EntityId' => ['description' => '实体ID，如员工编号。', 'type' => 'string', 'example' => '222'], + 'Labels' => ['description' => '查询到的人脸数据标签。', 'type' => 'string', 'example' => '视觉智能'], + 'CreatedAt' => ['description' => '人脸样本的创建时间。', 'type' => 'integer', 'format' => 'int64', 'example' => '1589203871832'], + 'FaceCount' => ['description' => '人脸样本包含的人脸数量。', 'type' => 'integer', 'format' => 'int32', 'example' => '3'], + 'UpdatedAt' => ['description' => '人脸样本的更新时间。', 'type' => 'integer', 'format' => 'int64', 'example' => '1589203871832'], ], + 'description' => '', ], ], ], ], ], + 'description' => '', ], ], ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'ParameterError', - 'errorMessage' => 'The parameter is invalid. Please check again.', - ], + ['errorCode' => 'ParameterError', 'errorMessage' => 'The parameter is invalid. Please check again.', 'description' => '参数错误，请检查参数值'], ], 403 => [ - [ - 'errorCode' => 'AuthFailed', - 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', - ], + ['errorCode' => 'AuthFailed', 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', 'description' => '授权失败，请检查RAM权限配置'], ], 408 => [ - [ - 'errorCode' => 'Timeout', - 'errorMessage' => 'The request has timed out.', - ], + ['errorCode' => 'Timeout', 'errorMessage' => 'The request has timed out.', 'description' => '请求超时，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'The service is unavailable.', - ], + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'The service is unavailable.', 'description' => '服务不可用，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"8E92F28B-F889-48CB-9FCC-3207CFA2215E\\",\\n \\"Data\\": {\\n \\"Elements\\": [\\n {\\n \\"Rect\\": [\\n 0\\n ],\\n \\"LiveConfidence\\": 0.7246492505073547,\\n \\"FaceConfidence\\": 0.8464494943618774\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"8E92F28B-F889-48CB-9FCC-3207CFA2215E\\n\\n \\n 0.84644949436187744\\n 374\\n 6\\n 493\\n 106\\n 0.72464925050735474\\n \\n","errorExample":""}]', - 'title' => '视频活体检测', - 'summary' => '本文介绍视频活体检测DetectVideoLivingFace的语法及示例。', + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"DA7CAFEB-0A37-4496-9CDF-E3DBB6309CB2\\",\\n \\"Data\\": {\\n \\"Token\\": \\"2\\",\\n \\"TotalCount\\": 200,\\n \\"Entities\\": [\\n {\\n \\"DbName\\": \\"default\\",\\n \\"EntityId\\": \\"222\\",\\n \\"Labels\\": \\"视觉智能\\",\\n \\"CreatedAt\\": 1589203871832,\\n \\"FaceCount\\": 3,\\n \\"UpdatedAt\\": 1589203871832\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n DA7CAFEB-0A37-4496-9CDF-E3DBB6309CB2\\n \\n 2\\n 200\\n \\n default\\n 222\\n 视觉智能\\n 1589203871832\\n 3\\n 1589203871832\\n \\n \\n","errorExample":""}]', + 'title' => '查询人脸样本列表', + 'summary' => '本文介绍查询人脸样本列表ListFaceEntities的语法及示例。', 'description' => '## 功能描述'."\n" - .'视频活体检测能力可以检测输入视频中的人脸来自直接拍摄还是翻拍。当视频中出现多个人脸时，对画面中面积最大的人脸进行判断，需要确保待检测人脸五官清晰可见。'."\n" + .'查询人脸样本列表能力用于查询人脸数据库中的人脸样本列表。'."\n" ."\n" .'> - 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" - .'- 当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击[立即试用](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=DetectVideoLivingFace)对该能力进行更直观试用以及在线购买。'."\n" .'- 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。'."\n" ."\n" .'## 接入指引'."\n" .'1. 注册阿里云账号：打开[阿里云官网](https://www.aliyun.com)，在阿里云官网右上角，单击**立即注册**，按照操作提示完成账号注册。'."\n" .'2. 开通能力：请确保您已开通[人脸人体服务](https://vision.aliyun.com/facebody)，若未开通服务请[立即开通](https://common-buy.aliyun.com/?commodityCode=viapi_facebody_public_cn#/open)。'."\n" - .'> 本能力支持企业或个人认证用户开通。更多实名认证操作信息，请参见[实名认证](https://help.aliyun.com/knowledge_list/37170.html)。'."\n" + .'>'."\n" + .'本能力支持企业或个人认证用户开通。更多实名认证操作信息，请参见[实名认证](https://help.aliyun.com/knowledge_list/37170.html)。'."\n" + .'>'."\n" ."\n" .'3. 创建AccessKey：请确保您已[创建AccessKey](~~175144~~)，如果您使用的是子账号AccessKey，您需要给子账号赋予AliyunVIAPIFullAccess权限，具体操作，请参见[RAM授权](~~145025~~)。'."\n" - .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/facebody/2019-12-30/DetectVideoLivingFace?lang=JAVA&sdkStyle=dara¶ms=%7B%22Type%22%3A0%2C%22VideoUrl%22%3A%22http%3A%2F%2Fviapi-test.oss-cn-shanghai.aliyuncs.com%2Fviapi-3.0domepic%2Ffacebody%2FDetectVideoLivingFace%2FDetectVideoLivingFace1.mp4%22%7D&tab=DEMO)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" + .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/facebody/2019-12-30/ListFaceEntities?lang=JAVA)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" .'5. 开发接入步骤：'."\n" .'- 在[SDK总览](~~145033~~)中选择您要接入使用的SDK语言。'."\n" .'- 在对应语言的SDK文档中找到AI类目为人脸人体（facebody）的SDK包进行安装。'."\n" @@ -6638,111 +5027,128 @@ .'- [Android端直接调用](~~467781~~)'."\n" .'- [iOS端直接调用](~~467782~~)'."\n" ."\n" - .'## 输入限制'."\n" - .'- 视频格式：MP4、AVI。'."\n" - .'- 视频大小：不超过30 MB。'."\n" - .'- 视频分辨率：大于64×64像素以上，视频长度大于3秒。其中人脸尺寸建议大于64×64像素。'."\n" - .'- 建议输入的视频帧率不低于15帧/秒。'."\n" - .'- URL地址中不能包含中文字符。'."\n" + .'## 限制说明'."\n" + .'查询人脸样本列表接口提交任务并发默认为2QPS。'."\n" ."\n" .'## 计费说明'."\n" - .'关于视频活体检测的计费方式及报价，请参见[计费介绍](~~184049~~)。'."\n" - ."\n" - .'> 下方调试接口为付费接口，如需免费体验调试请前往[体验中心](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=DetectVideoLivingFace)。', + .'查询人脸样本列表能力可免费调用。', 'requestParamsDescription' => ' ', 'responseParamsDescription' => '## SDK参考'."\n" - .'阿里云视觉AI人脸人体类目下的视频活体检测能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。', + .'阿里云视觉AI人脸人体类目下的查询人脸样本列表能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。', 'extraInfo' => '## 错误码'."\n" - .'关于视频活体检测的错误码，详情请参见[常见错误码](~~146756~~)。'."\n" - ."\n" - .'## 开源模型体验'."\n" - .'更多开源免费模型体验及下载，详见魔搭社区：[人脸活体检测模型-RGB](https://modelscope.cn/models/damo/cv_manual_face-liveness_flrgb/summary)、[人脸活体检测模型-IR](https://modelscope.cn/models/damo/cv_manual_face-liveness_flir/summary)、[静默人脸活体检测模型-炫彩](https://modelscope.cn/models/damo/cv_manual_face-liveness_flxc/summary)。'."\n" + .'关于查询人脸样本列表的错误码，详情请参见[常见错误码](~~146756~~)。'."\n" ."\n" .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。'."\n" - .'- 平台不存储用户在使用服务过程中涉及的原始人脸图片或文件信息。', - ], - 'GenerateHumanAnimeStyle' => [ - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', + .'- 平台不存储用户在使用服务过程中涉及的原始人脸图片或文件信息。'."\n" + .'- 平台针对超过6个月及以上没有API服务调用的用户的人脸特征向量数据进行冻结，确保无服务调用的客户信息安全。如需解冻，请通过钉钉群（23109592）联系我们。', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'viapi-facebody:ListFaceEntities', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + ], + 'MergeImageFace' => [ + 'summary' => '本文介绍图像人脸融合MergeImageFace的语法及示例。', + 'methods' => ['post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', 'deprecated' => false, - 'systemTags' => [], + 'systemTags' => ['operationType' => 'none'], 'parameters' => [ + [ + 'name' => 'TemplateId', + 'in' => 'formData', + 'schema' => ['description' => '人脸模板的模板ID。'."\n" + ."\n" + .'> 需要先上传模版，具体操作，请参见[图像人脸融合模板增加](~~203512~~)。', 'type' => 'string', 'required' => true, 'example' => '6cd509ea-54fa-4730-8e9d-c94cadcda048'], + ], [ 'name' => 'ImageURL', - 'in' => 'query', - 'schema' => [ - 'description' => '图像URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。'."\n" - .'图片格式要求：'."\n" - ."\n" - .'- 图像格式：JPG、JPEG、PNG。'."\n" - .'- 图像大小：不超过3 MB。'."\n" - .'- 图像分辨率：大于32×32像素，小于2000×2000像素。最长边小于等于1999像素，人脸占比不低于60×60像素。'."\n" - .'- 支持有单人或多人的人脸清晰正面照，最大人脸数目限制5，人脸朝向在上下左右45度以内。'."\n" - .'- URL地址中不能包含中文字符。'."\n" - .'> 图像内容：当图像分辨率超过最大限制时，请先将图片进行缩放，调整图片大小，具体请参见[图片缩放](~~44688~~)。', - 'type' => 'string', - 'required' => true, - 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/GenerateHumanAnimeStyle/GenerateHumanAnimeStyle8.png', - 'isFileTransferUrl' => true, - ], + 'in' => 'formData', + 'schema' => ['description' => '待融合的人脸照片，仅在模板图为单人场景下使用。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。'."\n" + .'输入限制：'."\n" + .'- 图像格式：JPG、JPEG、PNG。'."\n" + .'- 图像大小：不超过20 MB。'."\n" + .'- 图像分辨率：大于等于128×128像素，小于等于2000×2000像素，最长边小于等于2000像素。'."\n" + .'- URL地址中不能包含中文字符。'."\n" + ."\n" + .'> - 当图像分辨率超过最大限制时，请先将图片进行缩放，调整图片大小，具体请参见[图片缩放](~~44688~~)。'."\n" + .'- **ImageURL**与**MergeInfos**二选一。', 'type' => 'string', 'required' => false, 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/MergeImageFace/MergeImageFace-1.png', 'isFileTransferUrl' => true], ], [ - 'name' => 'AlgoType', - 'in' => 'query', + 'name' => 'ModelVersion', + 'in' => 'formData', + 'schema' => ['description' => '提供两版模型，分别支持脸型适配（v1）与非脸型适配（v2）的效果，具有一定区分度。默认值为v1（脸型适配版本）。', 'type' => 'string', 'required' => false, 'example' => 'v1'], + ], + [ + 'name' => 'AddWatermark', + 'in' => 'formData', + 'schema' => ['description' => '是否添加水印。取值范围如下：'."\n" + ."\n" + .'- False（默认）：不添加水印。'."\n" + .'- True：添加水印。', 'type' => 'boolean', 'required' => false, 'example' => 'False', 'default' => 'false'], + ], + [ + 'name' => 'WatermarkType', + 'in' => 'formData', + 'schema' => ['description' => '水印类型。取值范围如下：'."\n" + ."\n" + .'- EN（默认）：英文水印。'."\n" + .'- CN：中文水印。', 'type' => 'string', 'required' => false, 'example' => 'EN', 'default' => 'EN'], + ], + [ + 'name' => 'MergeInfos', + 'in' => 'formData', + 'style' => 'repeatList', 'schema' => [ - 'description' => '卡通效果配置参数。取值如下：'."\n" - ."\n" - .'- anime：日漫风'."\n" - .'- 3d：3D特效'."\n" - .'- handdrawn：手绘风'."\n" - .'- sketch：铅笔画'."\n" - .'- artstyle：艺术特效'."\n" - .'- claborate ：国画工笔画'."\n" - .'- hongkong ：港漫风'."\n" - .'- comic：漫画风格'."\n" - .'- animation3d：动画3D', - 'type' => 'string', + 'type' => 'array', + 'items' => [ + 'description' => '仅在模板图为多人场景下使用，指定图中每个人脸和待换脸的图像URL。'."\n" + ."\n" + .'> **ImageURL**与**MergeInfos**二选一。', + 'type' => 'object', + 'properties' => [ + 'TemplateFaceID' => ['description' => '多脸模板对应的某个人脸的子ID。', 'type' => 'string', 'required' => false, 'example' => '6cd509ea-54fa-4730-8e9d-c94cadcda048_0'], + 'ImageURL' => ['description' => '该人脸待替换的图像URL。', 'type' => 'string', 'required' => false, 'example' => 'http://invi-label.oss-cn-shanghai.aliyuncs.com/label/temp/faceswap/ref/ref.jpg'], + ], + 'required' => false, + ], 'required' => false, - 'example' => 'anime', - 'default' => 'anime', + 'maxItems' => 1000, + 'minItems' => 0, + 'description' => '', ], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'description' => '1', + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '59697D68-2A6E-4553-89BD-0FADD07881E8', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => '8473A5E5-488E-4612-800E-F95B42381570'], 'Data' => [ 'description' => '返回的结果数据内容。', 'type' => 'object', 'properties' => [ - 'ImageURL' => [ - 'description' => '人物卡通化结果图的URL地址。'."\n" - .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。', - 'type' => 'string', - 'example' => 'https://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/viapi-video/person_image_cartoonizer/2023-10-25/55798d04-0957-4ab1-accc-0e4d2d01a039/20231025092636774205_styleanime_n2vedxruht.jpg?Expires=1698283596&OSSAccessKeyId=LTAI****************&Signature=ut2kn46Lz%2FRwqJ9jWJ0RBDut12****', - ], + 'ImageURL' => ['description' => '融合后的图像URL地址。'."\n" + .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。', 'type' => 'string', 'example' => 'http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/image-face-fusion/09dedc78-c355-442a-9312-7ab074d6de49_54dc_20210129-025407.jpg?Expires=1611890647&OSSAccessKeyId=LTAI****************&Signature=2mk2OgIrwMqrvA%2FvDdp0MNaoVU****'], ], ], ], @@ -6751,186 +5157,138 @@ ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'ParameterError', - 'errorMessage' => 'The parameter is invalid. Please check again.', - ], + ['errorCode' => 'ParameterError', 'errorMessage' => 'The parameter is invalid. Please check again.', 'description' => '参数错误，请检查参数值'], ], 403 => [ - [ - 'errorCode' => 'AuthFailed', - 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', - ], + ['errorCode' => 'AuthFailed', 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', 'description' => '授权失败，请检查RAM权限配置'], ], 408 => [ - [ - 'errorCode' => 'Timeout', - 'errorMessage' => 'The request has timed out.', - ], + ['errorCode' => 'Timeout', 'errorMessage' => 'The request has timed out.', 'description' => '请求超时，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'The service is unavailable.', - ], + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'The service is unavailable.', 'description' => '服务不可用，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"59697D68-2A6E-4553-89BD-0FADD07881E8\\",\\n \\"Data\\": {\\n \\"ImageURL\\": \\"https://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/viapi-video/person_image_cartoonizer/2023-10-25/55798d04-0957-4ab1-accc-0e4d2d01a039/20231025092636774205_styleanime_n2vedxruht.jpg?Expires=1698283596&OSSAccessKeyId=LTAI****************&Signature=ut2kn46Lz%2FRwqJ9jWJ0RBDut12****\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n 59697D68-2A6E-4553-89BD-0FADD07881E8\\n \\n https://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/viapi-video/person_image_cartoonizer/2023-10-25/55798d04-0957-4ab1-accc-0e4d2d01a039/20231025092636774205_styleanime_n2vedxruht.jpg?Expires=1698283596&OSSAccessKeyId=LTAI****************&Signature=ut2kn46Lz%2FRwqJ9jWJ0RBDut12****\\n \\n","errorExample":""}]', - 'title' => '人物动漫化', - 'summary' => '本文介绍人物动漫化GenerateHumanAnimeStyle的语法及示例。', + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"8473A5E5-488E-4612-800E-F95B42381570\\",\\n \\"Data\\": {\\n \\"ImageURL\\": \\"http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/image-face-fusion/09dedc78-c355-442a-9312-7ab074d6de49_54dc_20210129-025407.jpg?Expires=1611890647&OSSAccessKeyId=LTAI****************&Signature=2mk2OgIrwMqrvA%2FvDdp0MNaoVU****\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n 8473A5E5-488E-4612-800E-F95B42381570\\n \\n http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/image-face-fusion/09dedc78-c355-442a-9312-7ab074d6de49_54dc_20210129-025407.jpg?Expires=1611890647&OSSAccessKeyId=LTAI****************&Signature=2mk2OgIrwMqrvA%2FvDdp0MNaoVU****\\n \\n","errorExample":""}]', + 'title' => '合并图像人脸', 'description' => '## 功能描述'."\n" - .'人物动漫化能力可以将一张人物图像进行转换处理，生成卡通形象，并返回动漫化后的结果图像。'."\n" - .'- 支持风格：国画（NEW）、港漫（NEW）、漫画风（NEW）、动画3D（NEW）、日漫、3D、手绘、铅笔画和艺术特效9个风格。'."\n" - .'- 多人照片：可转换多人照片，一次可处理图片中最多5个人脸。'."\n" - ."\n" + .'图像人脸融合功能可以将用户图中的人脸融合到模板图中的人脸位置，生成一张包含用户图人脸特征的新图像。特别注意的是，该功能严格要求使用者事先获得用户图和模版图的授权，不得用于非法或有违道德约束的场景中。'."\n" .'关于该接口功能的示例图如下：'."\n" - .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20231121/ctcn/GenerateHumanAnimeStyle.png" width="600)'."\n" - ."\n" - .'- 漫画风（NEW）：漫画风格模拟复古漫画风格中的人物形象，适合各种类型的写真照片。'."\n" - .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20231121/qtpu/GenerateHumanAnimeStylemanhua1.png" width="500)'."\n" - .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20231121/nump/GenerateHumanAnimeStylemanhua2.png" width="500)'."\n" - ."\n" - .'- 动画3D风（NEW）：动画3D风格模拟动画3D的人物形象和质感，适合各种类型的写真照片。'."\n" - .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20231121/xogr/GenerateHumanAnimeStyledonghua1.png" width="500)'."\n" - .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20231121/jjgc/GenerateHumanAnimeStyledonghua2.png" width="500)'."\n" - ."\n" - .'- 港漫风（NEW）：港漫风格的能力比较综合，适合各种类型的照片。'."\n" - .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20231025/gxbu/GenerateHumanAnimeStylegangman1.png" width="500)'."\n" - .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20231025/bbbi/GenerateHumanAnimeStylegangman2.png" width="500)'."\n" - ."\n" - .'- 国画风（NEW）：国画风格适合古装写真照，如汉服、唐装等，以全身照和半身照背景简约的照片为宜。'."\n" - .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20231025/gsxw/GenerateHumanAnimeStyleguofeng1.png" width="500)'."\n" - .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20231025/wmut/GenerateHumanAnimeStyleguofeng2.png" width="500)'."\n" - ."\n" - .'- 手绘风：手绘风格适合各种类型的写真照片。'."\n" - .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20231025/smel/GenerateHumanAnimeStyleshouhui1.png" width="500)'."\n" - .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20231025/adxx/GenerateHumanAnimeStyleshouhui2.png" width="500)'."\n" - ."\n" - .'- 艺术特效：艺术特效适合照片颜色比较鲜艳，彩妆、浓妆等写真造型。'."\n" - .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20231025/dilz/GenerateHumanAnimeStyleyishu1.png" width="500)'."\n" - .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20231025/gloq/GenerateHumanAnimeStyleyishu2.png" width="500)'."\n" - ."\n" - .'- 3D特效：3D特效风格比较综合，适合各种类型的人物照片。'."\n" - .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20231025/wfbj/GenerateHumanAnimeStyle3d1.png" width="500)'."\n" - .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20231025/rnkc/GenerateHumanAnimeStyle3d2.png" width="500)'."\n" - ."\n" - .'- 日漫风：日漫风格比较综合，适合各种类型的人物照片，以Cosplay类型为佳。'."\n" - .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20231025/toby/GenerateHumanAnimeStyleriman1.png" width="500)'."\n" - .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20231025/laxr/GenerateHumanAnimeStyleriman2.png" width="500)'."\n" - ."\n" - .'- 铅笔画：铅笔画风格比较综合，适合各种类型的人物照片。'."\n" - .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20231025/yqdb/GenerateHumanAnimeStyleqianbi1.png" width="500)'."\n" - .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20231025/nakc/GenerateHumanAnimeStyleqianbi2.png" width="500)'."\n" + .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20221108/mzue/MergeImageFace.png" width="400)'."\n" ."\n" .'> - 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" - .'- 当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击[立即试用](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=GenerateHumanAnimeStyle)对该能力进行更直观试用以及在线购买。'."\n" + .'- 当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击[立即试用](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=MergeImageFace)对该能力进行更直观试用以及在线购买。'."\n" .'- 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。'."\n" ."\n" .'## 应用场景'."\n" - .'- 保护隐私：为保护图像中的人物隐私，将人物卡通化，可避免识别出原人物是谁。保留社交趣味度的同时避免过度娱乐化。'."\n" - .'- 社交娱乐：将自己的照片变成卡通人物，塑造可爱氛围，配上图文分享给朋友。'."\n" - .'- 特效应用：可用于打造个性头像以及趣味活动等场景。'."\n" + .'- 娱乐应用：用户将自己的人脸和已获授权的合法图像中的人物人脸进行融合。'."\n" + .'- 影视制作：适用于影视制作公司，在后期制作中通过人脸融合提升制作效率与降低成本。'."\n" + .'- 影楼获客：适用于影楼或者个人摄影工作室，将客户的人脸融合到摄影样片中，达到试妆、试衣、试拍的效果。'."\n" ."\n" - .'## 特色优势'."\n" - .'- 复刻人物表情：基于深度学习算法，识别人物性别、表情等特征，在卡通头像上还原。'."\n" - .'- 全身卡通化：相比人脸卡通化，可避免笑场等尴尬场景。'."\n" - .'- 多人模式：可处理情侣照、家庭照、团体类照片。'."\n" + .'## 特色优势 '."\n" + .'- 高保真、低违和效果：融合后的人脸保留了替换者人脸身份信息的视觉特征，而融入被替换者人脸中又无违和感。'."\n" + .'- 表情肤色一致性：融合后的人脸最大限度保留被替换者的面目表情、肤色一致性。'."\n" + .'- 支持复杂人脸角度：支持模版人脸偏侧一定角度，融合后的结果真实稳定。'."\n" + .'- 脸型适配：支持自适应的匹配用户脸的脸型，提升融合结果的辨识度。'."\n" + .'- 支持多人脸和指定人脸：支持模版图像中多个人脸，并指定每个人脸与目标人脸进行单独融合。'."\n" ."\n" .'## 接入指引'."\n" + ."\n" .'1. 注册阿里云账号：打开[阿里云官网](https://www.aliyun.com)，在阿里云官网右上角，单击**立即注册**，按照操作提示完成账号注册。'."\n" .'2. 开通能力：请确保您已开通[人脸人体服务](https://vision.aliyun.com/facebody)，若未开通服务请[立即开通](https://common-buy.aliyun.com/?commodityCode=viapi_facebody_public_cn#/open)。'."\n" - .'> 本能力支持企业或个人认证用户开通。更多实名认证操作信息，请参见[实名认证](https://help.aliyun.com/knowledge_list/37170.html)。'."\n" + ."\n" + .'>于2024年7月17日及以后开通该能力的用户可直接调用，不需提交申请。'."\n" + .'2024年7月17日之前开通该服务的用户如需调用，可通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们添加到白名单。'."\n" + .'>'."\n" + ."\n" .'3. 创建AccessKey：请确保您已[创建AccessKey](~~175144~~)，如果您使用的是子账号AccessKey，您需要给子账号赋予AliyunVIAPIFullAccess权限，具体操作，请参见[RAM授权](~~145025~~)。'."\n" - .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/facebody/2019-12-30/GenerateHumanAnimeStyle?&lang=JAVA&sdkStyle=dara¶ms=%7B%22ImageURL%22%3A%22http%3A%2F%2Fviapi-test.oss-cn-shanghai.aliyuncs.com%2Fviapi-3.0domepic%2Ffacebody%2FGenerateHumanAnimeStyle%2FGenerateHumanAnimeStyle1.png%22%2C%22AlgoType%22%3A%22anime%22%7D&tab=DEMO)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" - .'5. 开发接入步骤：'."\n" + .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/facebody/2019-12-30/MergeImageFace?lang=JAVA&sdkStyle=old¶ms=%7B%7D&tab=DEMO)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" + .'5. 前提条件：已通过[图像人脸融合模板增加接口](~~203512~~)（AddFaceImageTemplate）创建生成了TemplateId。'."\n" + .'6. 开发接入步骤：'."\n" .'- 在[SDK总览](~~145033~~)中选择您要接入使用的SDK语言。'."\n" .'- 在对应语言的SDK文档中找到AI类目为人脸人体（facebody）的SDK包进行安装。'."\n" .'- 参考文档中提供的示例代码进行适当修改后调用。'."\n" ."\n" - .'6. 示例代码：该能力常用语言的示例代码，请参见[人物动漫化示例代码](~~477407~~)。'."\n" + .'7. 示例代码：该能力常用语言的示例代码，请参见[图像人脸融合示例代码](~~467963~~)。'."\n" ."\n" - .'7. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" + .'8. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" .'- [Web前端直接调用](~~467779~~)'."\n" .'- [小程序场景下直接调用](~~467780~~)'."\n" .'- [Android端直接调用](~~467781~~)'."\n" .'- [iOS端直接调用](~~467782~~)'."\n" - ."\n\n" - .'## 输入限制'."\n" ."\n" + .'## 输入限制'."\n" .'- 图像格式：JPG、JPEG、PNG。'."\n" - .'- 图像大小：不超过3 MB。'."\n" - .'- 图像分辨率：大于32×32像素，小于2000×2000像素，最长边小于等于1999像素，人脸占比不低于60×60像素。'."\n" - .'- 支持有单人或多人的人脸清晰正面照，最大人脸数目限制5，人脸朝向在上下左右45度以内。'."\n" + .'- 图像大小：不超过20 MB。'."\n" + .'- 图像分辨率：大于等于128×128像素，小于等于2000×2000像素，最长边小于等于2000像素。'."\n" .'- URL地址中不能包含中文字符。'."\n" ."\n" .'> 当图像分辨率超过最大限制时，请先将图片进行缩放，调整图片大小，具体请参见[图片缩放](~~44688~~)。'."\n" ."\n" + .'## 图像质量建议'."\n" + ."\n" + .'- 要求保证图像中的人脸清晰。图像中人脸尺寸建议大于64×64像素，人脸区域建议不大于全图区域的2/3。'."\n" + .'- 建议图像中人脸五官区域轮廓完整，无明显遮挡。人脸融合算法支持人脸偏侧一定角度，在偏侧角度不超过30度的情况下能取得更佳效果。'."\n" + .'- 含有多人脸的图像，建议图像中人脸个数不超过5个。'."\n" + ."\n" + .'推荐图像示例：'."\n" + .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20221114/jris/MergeImageFacetuijian.png" width="300)'."\n" + .'不推荐图像示例：'."\n" + .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20221114/rkbx/MergeImageFacebutuijian.png" width="300)'."\n" + ."\n" .'## 计费说明'."\n" - .'关于人物动漫化的计费方式及报价，请参见[计费介绍](~~184049~~)。', - 'requestParamsDescription' => ' ', + .'关于图像人脸融合的计费方式及报价，请参见[计费介绍](~~184049~~)。'."\n" + .'> 下方调试接口为付费接口，如需免费体验调试请前往[体验中心](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=MergeImageFace)。', 'responseParamsDescription' => '## SDK参考'."\n" - .'阿里云视觉AI人脸人体类目下的人脸动漫化能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。'."\n" + .'阿里云视觉AI人脸人体类目下的图像人脸融合能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。'."\n" + ."\n" .'## 示例代码'."\n" - .'该能力常用语言的示例代码，请参见[人物动漫化示例代码](~~477407~~)。', + .'该能力常用语言的示例代码，请参见[图像人脸融合示例代码](~~467963~~)。', 'extraInfo' => '## 错误码'."\n" - .'关于人物动漫化的错误码，详情请参见[常见错误码](~~146756~~)。'."\n" + .'关于图像人脸融合的错误码，详情请参见[常见错误码](~~146756~~)。'."\n" ."\n" .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。', - ], - 'GenerateHumanSketchStyle' => [ - 'summary' => '添加人像素描风格化。', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'http', - 'https', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'viapi-facebody:MergeImageFace', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + ], + 'MonitorExamination' => [ + 'summary' => '本文介绍线上监考MonitorExamination的语法及示例。', + 'methods' => ['post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [], 'parameters' => [ [ - 'name' => 'ImageURL', + 'name' => 'Type', 'in' => 'formData', - 'schema' => [ - 'title' => 'A short description of struct', - 'description' => '图像URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。'."\n" - .'图片格式要求：'."\n" - ."\n" - .'- 图像格式：JPG、JPEG、PNG。'."\n" - .'- 图像大小：小于10 MB。'."\n" - .'- 图像分辨率：大于100×100像素，小于2000×2000像素，最长边小于等于1999像素；人脸占比不低于60×60像素。'."\n" - .'- 图像质量：支持有单人人脸的清晰正面照，人脸朝向在上下左右45度以内。'."\n" - .'- URL地址中不能包含中文字符。'."\n" - .'> 图像内容：当图像分辨率超过最大限制时，请先将图片进行缩放，调整图片大小，具体请参见[图片缩放](~~44688~~)。', - 'type' => 'string', - 'required' => true, - 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/GenerateHumanSketchStyle/GenerateHumanSketchStyle7.png', - 'isFileTransferUrl' => true, - ], + 'schema' => ['title' => 'A short description of struct', 'description' => '检测类型。'."\n" + ."\n" + .'- 0：屏幕聊天工具检测'."\n" + .'- 1：考生状态检测', 'type' => 'integer', 'format' => 'int64', 'required' => true, 'maximum' => '1', 'minimum' => '0', 'example' => '1'], ], [ - 'name' => 'ReturnType', + 'name' => 'ImageURL', 'in' => 'formData', - 'schema' => [ - 'description' => '图像返回形式。取值如下：'."\n" - ."\n" - .'- head：大头照（默认）'."\n" - .'- full：全身照'."\n" - ."\n" - .'推荐使用大头照，处理效果更佳。', - 'type' => 'string', - 'required' => false, - 'example' => 'head', - ], + 'schema' => ['description' => '图像URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。', 'type' => 'string', 'required' => true, 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/MonitorExamination/1MonitorExamination1.jpg', 'isFileTransferUrl' => true], ], ], 'responses' => [ @@ -6940,23 +5298,59 @@ 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'E499788C-22DA-4F0E-B9C0-0E9D30A25716', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => 'D0F6EB94-73B6-4CB8-B266-22D2F221C475'], 'Data' => [ 'description' => '返回的结果数据内容。', 'type' => 'object', 'properties' => [ - 'ImageURL' => [ - 'title' => '出参图片地址', - 'description' => '返回图片URL地址。'."\n" - .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。', - 'type' => 'string', - 'example' => 'http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/person-image-pencil/fd49dd0a-9e24-4bb5-b303-0745cdb453e0_7aa6_20210128-073045.jpg?Expires=1611820849&OSSAccessKeyId=LTAI****************&Signature=1oLYG%2FPe%2BNRIK7XcsUQYaKF%2B1C****', + 'FaceInfo' => [ + 'description' => '中心人物的人脸信息。当请求参数Type取值为1时显示该参数。', + 'type' => 'object', + 'properties' => [ + 'Completeness' => ['description' => '人脸完整度分数，取值范围\\(0,1)。', 'type' => 'number', 'format' => 'float', 'example' => '1'], + 'FaceNumber' => ['description' => '检测到的人脸人数，0代表未检测到考生人脸。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], + 'Pose' => [ + 'description' => '正对摄像机时3个角度都为0， 取值范围正负90度之间。', + 'type' => 'object', + 'properties' => [ + 'Pitch' => ['description' => '上下俯仰角角度，抬头为正值，低头为负值。', 'type' => 'number', 'format' => 'float', 'example' => '-0.9185499548912048'], + 'Roll' => ['description' => '人脸在画面中顺时针转动为正值，逆时针转动为负值。', 'type' => 'number', 'format' => 'float', 'example' => '-0.18541647493839264'], + 'Yaw' => ['description' => '向左看为正值，向右看为负值。', 'type' => 'number', 'format' => 'float', 'example' => '8.095342636108398'], + ], + ], + ], + ], + 'PersonInfo' => [ + 'description' => '中心人物的属性行为信息。当请求参数Type取值为1时显示该参数。', + 'type' => 'object', + 'properties' => [ + 'CellPhone' => [ + 'description' => '打电话。', + 'type' => 'object', + 'properties' => [ + 'Score' => ['description' => '打电话的概率分数，取值范围\\(0,1)。', 'type' => 'number', 'format' => 'float', 'example' => '0.39076218008995056'], + 'Threshold' => ['description' => '建议阈值。'."\n" + ."\n" + .'> 仅作为参考，实际应用中根据测试情况选取合适的Score阈值即可。', 'type' => 'number', 'format' => 'float', 'example' => '0.6'], + ], + ], + 'EarPhone' => [ + 'description' => '戴耳机。', + 'type' => 'object', + 'properties' => [ + 'Score' => ['description' => '戴耳机的概率分数，取值范围\\(0,1)。', 'type' => 'number', 'format' => 'float', 'example' => '0.7980290651321411'], + 'Threshold' => ['description' => '建议阈值。'."\n" + ."\n" + .'> 仅作为参考，实际应用中根据测试情况选取合适的Score阈值即可。', 'type' => 'number', 'format' => 'float', 'example' => '0.6'], + ], + ], + 'PersonNumber' => ['description' => '检测到的总人数，0代表未检测到考生。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], + ], ], + 'ChatScore' => ['description' => '屏幕截图包含聊天工具的概率，取值范围\\(0,1)。'."\n" + .'当请求参数Type取值为0时显示该参数。', 'type' => 'number', 'format' => 'float', 'example' => '0.28805577754974365'], + 'Threshold' => ['description' => '建议阈值，取值范围\\(0,1)。当ChatScore大于阈值时，系统判定输入屏幕截图中包含聊天工具。'."\n" + .'当请求参数Type取值为0时显示该参数。', 'type' => 'number', 'format' => 'float', 'example' => '0.5'], ], ], ], @@ -6965,63 +5359,58 @@ ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'ParameterError', - 'errorMessage' => 'The parameter is invalid. Please check again.', - ], + ['errorCode' => 'ParameterError', 'errorMessage' => 'The parameter is invalid. Please check again.', 'description' => '参数错误，请检查参数值'], ], 403 => [ - [ - 'errorCode' => 'AuthFailed', - 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', - ], + ['errorCode' => 'AuthFailed', 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', 'description' => '授权失败，请检查RAM权限配置'], ], 408 => [ - [ - 'errorCode' => 'Timeout', - 'errorMessage' => 'The request has timed out.', - ], + ['errorCode' => 'Timeout', 'errorMessage' => 'The request has timed out.', 'description' => '请求超时，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'The service is unavailable.', - ], + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'The service is unavailable.', 'description' => '服务不可用，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"E499788C-22DA-4F0E-B9C0-0E9D30A25716\\",\\n \\"Data\\": {\\n \\"ImageURL\\": \\"http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/person-image-pencil/fd49dd0a-9e24-4bb5-b303-0745cdb453e0_7aa6_20210128-073045.jpg?Expires=1611820849&OSSAccessKeyId=LTAI****************&Signature=1oLYG%2FPe%2BNRIK7XcsUQYaKF%2B1C****\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n E499788C-22DA-4F0E-B9C0-0E9D30A25716\\n \\n http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/person-image-pencil/fd49dd0a-9e24-4bb5-b303-0745cdb453e0_7aa6_20210128-073045.jpg?Expires=1611820849&OSSAccessKeyId=LTAI****************&Signature=1oLYG%2FPe%2BNRIK7XcsUQYaKF%2B1C****\\n \\n","errorExample":""}]', - 'title' => '人像素描风格化', + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"D0F6EB94-73B6-4CB8-B266-22D2F221C475\\",\\n \\"Data\\": {\\n \\"FaceInfo\\": {\\n \\"Completeness\\": 1,\\n \\"FaceNumber\\": 1,\\n \\"Pose\\": {\\n \\"Pitch\\": -0.9185499548912048,\\n \\"Roll\\": -0.18541647493839264,\\n \\"Yaw\\": 8.095342636108398\\n }\\n },\\n \\"PersonInfo\\": {\\n \\"CellPhone\\": {\\n \\"Score\\": 0.39076218008995056,\\n \\"Threshold\\": 0.6\\n },\\n \\"EarPhone\\": {\\n \\"Score\\": 0.7980290651321411,\\n \\"Threshold\\": 0.6\\n },\\n \\"PersonNumber\\": 1\\n },\\n \\"ChatScore\\": 0.28805577754974365,\\n \\"Threshold\\": 0.5\\n }\\n}","errorExample":""},{"type":"xml","example":"D0F6EB94-73B6-4CB8-B266-22D2F221C475\\n\\n \\n 1\\n 1\\n \\n -0.91854995\\n -0.18541647\\n 8.095343\\n \\n \\n \\n \\n 0.39076218\\n 0.6\\n \\n \\n 0.79802907\\n 0.6\\n \\n 1\\n \\n 0.28805578\\n 0.5\\n","errorExample":""}]', + 'title' => '线上监考', 'description' => '## 功能描述'."\n" - .'人像素描风格化能力可以对一张人物图像自动识别其头部区域，生成大头照下的素描画效果。返回结果的分辨率固定为512x512像素。'."\n" + .'在线监考能力可以对线上考试的考生行为进行识别，支持屏幕聊天工具检测和考生状态检测。'."\n" ."\n" - .'关于该接口功能的示例图如下：'."\n" - .'- 输入原图'."\n" - .'![输入图像](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20221108/qflk/GenerateHumanSketchStyle.png" width="300)'."\n" - .'- 输出效果图'."\n" - .'![生成效果](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20221108/nsbr/GenerateHumanSketchStylesumiao.png" width="300)'."\n" + .'- 屏幕聊天工具检测：输入截屏图像，判断是否出现常见的聊天工具。'."\n" + .'- 考生状态检测：利用考生的前置摄像机获取图像，判断出现的人脸人体个数、人脸角度朝向、是否戴耳机，是否使用手机。'."\n" ."\n" .'> - 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" - .'- 当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击[立即试用](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=GenerateHumanSketchStyle)对该能力进行更直观试用以及在线购买。'."\n" + .'- 当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击[立即试用](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=MonitorExamination)对该能力进行更直观试用以及在线购买。'."\n" .'- 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。'."\n" ."\n" .'## 应用场景'."\n" - .'社交娱乐：输入一张个人照片，通过人像素描风格化算法能力，会生成一张独一无二的素描肖像画。可以与朋友分享，也可以用来做头像。'."\n" + .'- 个人远程在线考试。'."\n" + .'- 个人线下固定机位考试。'."\n" ."\n" .'## 特色优势'."\n" - .'精准刻画：通过深度学习算法，精准还原人脸五官特征，连发丝都可精准还原。'."\n" + ."\n" + .'- 功能集成度高，一个接口可输出对当前考生的所有行为监测。'."\n" + .'- 针对常见聊天工具有单独的页面检测，可杜绝考生远程聊天作弊。'."\n" + .'- 可支持单机位（如PC），也可根据需求支持双机位算法（如手机架设）。'."\n" ."\n" .'## 接入指引'."\n" .'1. 注册阿里云账号：打开[阿里云官网](https://www.aliyun.com)，在阿里云官网右上角，单击**立即注册**，按照操作提示完成账号注册。'."\n" .'2. 开通能力：请确保您已开通[人脸人体服务](https://vision.aliyun.com/facebody)，若未开通服务请[立即开通](https://common-buy.aliyun.com/?commodityCode=viapi_facebody_public_cn#/open)。'."\n" - .'> 本能力支持企业或个人认证用户开通。更多实名认证操作信息，请参见[实名认证](https://help.aliyun.com/knowledge_list/37170.html)。'."\n" + ."\n" + .'>'."\n" + .'本能力支持企业或个人认证用户开通。更多实名认证操作信息，请参见[实名认证](https://help.aliyun.com/knowledge_list/37170.html)。'."\n" + .'>'."\n" + ."\n" .'3. 创建AccessKey：请确保您已[创建AccessKey](~~175144~~)，如果您使用的是子账号AccessKey，您需要给子账号赋予AliyunVIAPIFullAccess权限，具体操作，请参见[RAM授权](~~145025~~)。'."\n" - .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/facebody/2019-12-30/GenerateHumanSketchStyle?lang=JAVA&sdkStyle=dara¶ms=%7B%22ImageURL%22%3A%22http%3A%2F%2Fviapi-test.oss-cn-shanghai.aliyuncs.com%2Fviapi-3.0domepic%2Ffacebody%2FGenerateHumanSketchStyle%2FGenerateHumanSketchStyle1.png%22%7D&tab=DEMO)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" + .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/facebody/2019-12-30/MonitorExamination?lang=JAVA&sdkStyle=old¶ms=%7B%22ImageURL%22%3A%22http%3A%2F%2Fviapi-test.oss-cn-shanghai.aliyuncs.com%2Fviapi-3.0domepic%2Ffacebody%2FMonitorExamination%2F1MonitorExamination1.jpg%22%2C%22Type%22%3A1%7D&tab=DEMO)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" .'5. 开发接入步骤：'."\n" .'- 在[SDK总览](~~145033~~)中选择您要接入使用的SDK语言。'."\n" .'- 在对应语言的SDK文档中找到AI类目为人脸人体（facebody）的SDK包进行安装。'."\n" .'- 参考文档中提供的示例代码进行适当修改后调用。'."\n" ."\n" - .'6. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" + .'6. 示例代码：该能力常用语言的示例代码，请参见[线上监考示例代码](~~2249024~~)。'."\n" + ."\n" + .'7. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" .'- [Web前端直接调用](~~467779~~)'."\n" .'- [小程序场景下直接调用](~~467780~~)'."\n" .'- [Android端直接调用](~~467781~~)'."\n" @@ -7029,34 +5418,45 @@ ."\n" .'## 输入限制'."\n" ."\n" - .'- 图像格式：JPG、JPEG、PNG。'."\n" - .'- 图像大小：小于10 MB。'."\n" - .'- 图像分辨率：大于100×100像素，小于2000×2000像素，最长边小于等于1999像素；人脸占比不低于60×60像素。'."\n" - .'- 图像质量：支持有单人人脸的清晰正面照，人脸朝向在上下左右45度以内。'."\n" + .'- 图像格式：JPG、PNG。'."\n" + .'- 图像大小：小于5 MB。'."\n" + .'- 图像分辨率：建议大于480×640像素，小于720×1280像素。'."\n" .'- URL地址中不能包含中文字符。'."\n" ."\n" .'> 当图像分辨率超过最大限制时，请先将图片进行缩放，调整图片大小，具体请参见[图片缩放](~~44688~~)。'."\n" ."\n" .'## 计费说明'."\n" - .'关于人像素描风格化的计费方式及报价，请参见[计费介绍](~~184049~~)。', + .'关于线上监考的计费方式及报价，请参见[计费介绍](~~184049~~)。'."\n" + .'> 下方调试接口为付费接口，如需免费体验调试请前往[体验中心](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=MonitorExamination)。', 'responseParamsDescription' => '## SDK参考'."\n" - .'阿里云视觉AI人脸人体类目下的人像素描风格化能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。', - 'extraInfo' => '## 错误码'."\n" - .'关于人像素描风格化的错误码，详情请参见[常见错误码](~~146756~~)。'."\n" + .'阿里云视觉AI人脸人体类目下的线上监考能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。'."\n" ."\n" + .'## 示例代码'."\n" + .'该能力常用语言的示例代码，请参见[线上监考示例代码](~~2249024~~)。', + 'extraInfo' => '## 错误码'."\n" + .'关于在线监考的错误码，详情请参见[常见错误码](~~146756~~)。'."\n" .'## 安全声明'."\n" + ."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。', - ], - 'RecognizeAction' => [ - 'summary' => '本文介绍动作行为识别RecognizeAction的语法及示例。', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'http', - 'https', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-facebody:MonitorExamination', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + ], + 'PedestrianDetectAttribute' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -7067,216 +5467,178 @@ 'systemTags' => [], 'parameters' => [ [ - 'name' => 'Type', - 'in' => 'formData', - 'schema' => [ - 'description' => '输入内容类型，包括视频和图像两种类型。'."\n" - ."\n" - .'- 0：表示输入视频URL或视频Base64编码字符串。'."\n" - ."\n" - .'- 1：表示输入图像URL或图像Base64编码字符串。'."\n" - ."\n" - .'- 其他：非法输入。'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'required' => true, - 'example' => '0', - ], - ], - [ - 'name' => 'VideoUrl', - 'in' => 'formData', - 'schema' => [ - 'description' => 'Type为0时需要输入的视频URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。', - 'type' => 'string', - 'required' => false, - 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/RecognizeAction/RecognizeAction-video1.mp4', - 'isFileTransferUrl' => true, - ], - ], - [ - 'name' => 'URLList', - 'in' => 'formData', - 'style' => 'repeatList', - 'schema' => [ - 'description' => '图像列表', - 'type' => 'array', - 'items' => [ - 'description' => '图像列表', - 'type' => 'object', - 'properties' => [ - 'URL' => [ - 'description' => 'Type为1时需要输入的图像URL地址，**必须输入4张图像，且4张图像建议为两秒钟视频均匀采样的图像，分辨率和通道数必须一致**。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。', - 'type' => 'string', - 'required' => false, - 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/RecognizeAction/1RecognizeAction1.png', - 'isFileTransferUrl' => true, - ], - 'imageData' => [ - 'description' => '图像Base64编码字符串，与URL共存时，URL优先。文件的Base64编码处理操作，请参见[文件Base64处理](~~468191~~)。', - 'type' => 'string', - 'required' => false, - 'example' => '/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAgGBgcGBQgHBwcJCQgQ****', - ], - ], - 'required' => false, - ], - 'required' => false, - 'maxItems' => 300, - ], - ], - [ - 'name' => 'VideoData', + 'name' => 'ImageURL', 'in' => 'formData', - 'schema' => [ - 'description' => '视频Base64编码字符串，与VideoURL共存时，VideoURL优先。文件的Base64编码处理操作，请参见[文件Base64处理](~~468191~~)。', - 'type' => 'string', - 'required' => false, - 'example' => 'iVBORw0KGgoAAAANSUhEUgAAAoAAAAHJCAIAAACaEB9NAAEAAElEQVR4nNT9Wb****', - ], + 'schema' => ['description' => '图像URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。', 'type' => 'string', 'required' => true, 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/PedestrianDetectAttribute/PedestrianDetectAttribute1.jpg', 'isFileTransferUrl' => true], ], ], 'responses' => [ 200 => [ 'schema' => [ + 'description' => '1', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'E9C40AF5-A7F8-49D5-8A0C-B21F15A07F17', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '4F609A30-F645-481E-A513-CADAA14DFB0A'], 'Data' => [ 'description' => '返回的结果数据内容。', 'type' => 'object', 'properties' => [ - 'Elements' => [ - 'description' => '返回的结果元素列表。', + 'Attributes' => [ + 'description' => '行人属性。', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ - 'Scores' => [ - 'type' => 'array', - 'items' => [ - 'description' => '行为类别的置信度。取值范围0~1，值越大，识别到的动作越准确。系统根据算法，为不同的动作给出判断的阈值标准，您也可以根据自己的实际情况，对判断的阈值标准进行调整。'."\n" - ."\n" - .'- 举手：0.5（低于0.5则认为不是举手行为，否则认为是举手行为。）'."\n" - ."\n" - .'- 吃喝：0.5（低于0.5则认为不是吃喝行为，否则认为是吃喝行为。）'."\n" - ."\n" - .'- 吸烟：0.5（低于0.5则认为不是吸烟行为，否则认为是吸烟行为。）'."\n" - ."\n" - .'- 打电话：0.5（低于0.5则认为不是打电话行为，否则认为是打电话行为。）'."\n" - ."\n" - .'- 玩手机：0.5（低于0.5则认为不是玩手机行为，否则认为是玩手机行为。）'."\n" - ."\n" - .'- 趴桌睡觉：0.5（低于0.5则认为不是趴桌睡觉行为，否则认为是趴桌睡觉行为。）'."\n" - ."\n" - .'- 跌倒：0.5（低于0.5则认为不是跌倒行为，否则认为是跌倒行为。）'."\n" - .'- 洗手：0.5（低于0.5则认为不是洗手行为，否则认为是洗手行为。）'."\n" - .'- 拍照：0.5（低于0.5则认为不是拍照行为，否则认为是拍照行为。）', - 'type' => 'number', - 'format' => 'float', - 'example' => '0.702967643737793', + 'Gender' => [ + 'description' => '性别。', + 'type' => 'object', + 'properties' => [ + 'Score' => ['description' => '置信度。', 'type' => 'number', 'format' => 'float', 'example' => '0.97989875078201294'], + 'Name' => ['description' => 'male（男）；female（女）。', 'type' => 'string', 'example' => 'female'], ], ], - 'Labels' => [ - 'type' => 'array', - 'items' => [ - 'description' => '识别到的行为类别。', - 'type' => 'string', - 'example' => '跌倒', + 'Orient' => [ + 'description' => '人体朝向。', + 'type' => 'object', + 'properties' => [ + 'Score' => ['description' => '置信度。', 'type' => 'number', 'format' => 'float', 'example' => '0.97838658094406128'], + 'Name' => ['description' => 'Front（正向）；Side（侧向）；Back（背面）。', 'type' => 'string', 'example' => 'Front'], ], ], - 'Boxes' => [ - 'description' => '具体动作的坐标框列表。', - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'Box' => [ - 'type' => 'array', - 'items' => [ - 'description' => '具体动作的坐标框信息。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '[1119,576,1373,970]', - ], - ], - ], + 'Age' => [ + 'description' => '年龄。', + 'type' => 'object', + 'properties' => [ + 'Score' => ['description' => '置信度。', 'type' => 'number', 'format' => 'float', 'example' => '0.99590516090393066'], + 'Name' => ['description' => 'AgeOver60（大于60岁）；Age18-60（18-60岁之间）；AgeLess18（小于18岁）。', 'type' => 'string', 'example' => 'Age18-60'], ], ], - 'Timestamp' => [ - 'description' => '当前行为在视频或者图像中发生的时间戳信息。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '3', + 'UpperWear' => [ + 'description' => '上衣种类。', + 'type' => 'object', + 'properties' => [ + 'Score' => ['description' => '置信度。', 'type' => 'number', 'format' => 'float', 'example' => '0.89291918277740479'], + 'Name' => ['description' => 'LongSleeve（长袖）；ShortSleeve（短袖）。', 'type' => 'string', 'example' => 'ShortSleeve'], + ], ], - ], - ], - ], - ], - ], - ], - ], - ], - ], - 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'ParameterError', - 'errorMessage' => 'The parameter is invalid. Please check again.', - ], - ], - 403 => [ - [ - 'errorCode' => 'AuthFailed', - 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', - ], - ], - 408 => [ - [ - 'errorCode' => 'Timeout', - 'errorMessage' => 'The request has timed out.', - ], - ], - 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'The service is unavailable.', - ], - ], - ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"E9C40AF5-A7F8-49D5-8A0C-B21F15A07F17\\",\\n \\"Data\\": {\\n \\"Elements\\": [\\n {\\n \\"Scores\\": [\\n 0.702967643737793\\n ],\\n \\"Labels\\": [\\n \\"跌倒\\"\\n ],\\n \\"Boxes\\": [\\n {\\n \\"Box\\": [\\n 0\\n ]\\n }\\n ],\\n \\"Timestamp\\": 3\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"E9C40AF5-A7F8-49D5-8A0C-B21F15A07F17\\n\\n \\n 1\\n \\n \\n 0.702967643737793\\n 跌倒\\n 3\\n \\n 1119\\n 576\\n 1373\\n 970\\n \\n \\n \\n 0.7334273457527161\\n 跌倒\\n 5\\n \\n 1128\\n 613\\n 1363\\n 991\\n \\n \\n","errorExample":""}]', - 'title' => '动作行为识别', - 'description' => '## 功能描述'."\n" - .'动作行为识别能力可以识别视频和图像中的人体动作行为，并返回识别后的行为类别。当前可以识别的行为类别包括：举手、吃喝、吸烟、打电话、玩手机、趴桌睡觉、跌倒、洗手、拍照。您可以根据系统提供的动作置信度判断阈值，对识别的动作进行判断。'."\n" - ."\n" - .'**动作行为识别适用范围：**'."\n" - .'- 举手：手臂伸直高高举起，手腕高过头顶。'."\n" - .'- 吃喝：吃东西或者喝水。'."\n" - .'- 吸烟：将烟点着，真吸烟，画面中需要能看清烟。'."\n" - .'- 打电话：电话或者微信语音，手机必须靠近耳朵或者嘴边。'."\n" - .'- 玩手机：用手机打字、浏览手机、看视频、玩游戏，视频聊天等玩手机行为，画面中需要能看清手机。'."\n" - .'- 趴桌睡觉：头趴在桌子上睡觉。'."\n" - .'- 跌倒：整个人跌倒在地，身体倒下。'."\n" - .'- 洗手：在水龙头或者盆中洗手。'."\n" - .'- 拍照：手机稍微举起，用手机对着某人或物拍照。'."\n" + 'Glasses' => [ + 'description' => '眼镜。', + 'type' => 'object', + 'properties' => [ + 'Score' => ['description' => '置信度。', 'type' => 'number', 'format' => 'float', 'example' => '0.87284471094608307'], + 'Name' => ['description' => 'Yes（戴眼镜）；No（不戴眼镜）。', 'type' => 'string', 'example' => 'No'], + ], + ], + 'LowerWear' => [ + 'description' => '下衣种类。', + 'type' => 'object', + 'properties' => [ + 'Score' => ['description' => '置信度。', 'type' => 'number', 'format' => 'float', 'example' => '0.6424860954284668'], + 'Name' => ['description' => 'Trousers（长裤）；Shorts（短裤）；Skirt&Dress（裙子）。', 'type' => 'string', 'example' => 'Trousers'], + ], + ], + 'LowerColor' => [ + 'description' => '下衣颜色。', + 'type' => 'object', + 'properties' => [ + 'Score' => ['description' => '置信度。', 'type' => 'number', 'format' => 'float', 'example' => '0.69961744546890259'], + 'Name' => ['description' => '黑，灰，蓝，绿，白，紫，红，棕，黄，粉，不确定。', 'type' => 'string', 'example' => '黑'], + ], + ], + 'Hat' => [ + 'description' => '帽子。', + 'type' => 'object', + 'properties' => [ + 'Score' => ['description' => '置信度。', 'type' => 'number', 'format' => 'float', 'example' => '0.98272394016385078'], + 'Name' => ['description' => 'Yes（戴帽子）；No（不戴帽子）。', 'type' => 'string', 'example' => 'No'], + ], + ], + 'Handbag' => [ + 'description' => '手提包。', + 'type' => 'object', + 'properties' => [ + 'Score' => ['description' => '置信度。', 'type' => 'number', 'format' => 'float', 'example' => '0.55011671781539917'], + 'Name' => ['description' => 'Yes（有手提包）；No（无手提包）。', 'type' => 'string', 'example' => 'Yes'], + ], + ], + 'Backpack' => [ + 'description' => '背包。', + 'type' => 'object', + 'properties' => [ + 'Score' => ['description' => '置信度。', 'type' => 'number', 'format' => 'float', 'example' => '0.96486538648605347'], + 'Name' => ['description' => 'Yes（有背包）；No（无背包）。', 'type' => 'string', 'example' => 'No'], + ], + ], + 'UpperColor' => [ + 'description' => '上衣颜色。', + 'type' => 'object', + 'properties' => [ + 'Score' => ['description' => '置信度。', 'type' => 'number', 'format' => 'float', 'example' => '0.97796273231506348'], + 'Name' => ['description' => '黑，灰，蓝，绿，白，紫，红，棕，黄，粉，不确定。', 'type' => 'string', 'example' => '黄'], + ], + ], + 'ShoulderBag' => [ + 'description' => '肩挎包。', + 'type' => 'object', + 'properties' => [ + 'Score' => ['description' => '置信度。', 'type' => 'number', 'format' => 'float', 'example' => '0.91198787838220596'], + 'Name' => ['description' => 'Yes（有肩挎包）；No（无肩挎包）。', 'type' => 'string', 'example' => 'No'], + ], + ], + ], + 'description' => '', + ], + ], + 'Boxes' => [ + 'description' => '检测到行人边界框的坐标。', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'BottomRightX' => ['description' => '边框右下角x坐标值。', 'type' => 'number', 'format' => 'float', 'example' => '584'], + 'TopLeftY' => ['description' => '边框左上角y坐标值。', 'type' => 'number', 'format' => 'float', 'example' => '27'], + 'Score' => ['description' => '边界框置信度。', 'type' => 'number', 'format' => 'float', 'example' => '0.88381063938140869'], + 'TopLeftX' => ['description' => '边框左上角x坐标值。', 'type' => 'number', 'format' => 'float', 'example' => '36'], + 'BottomRightY' => ['description' => '边框右下角y坐标值。', 'type' => 'number', 'format' => 'float', 'example' => '218'], + ], + 'description' => '', + ], + ], + 'PersonNumber' => ['description' => '检测到的行人个数，取值为正整数。', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'Width' => ['description' => '原图的宽度，单位像素。', 'type' => 'integer', 'format' => 'int64', 'example' => '264'], + 'Height' => ['description' => '原图的高度，单位像素。', 'type' => 'integer', 'format' => 'int64', 'example' => '584'], + ], + ], + ], + ], + ], + ], + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'ParameterError', 'errorMessage' => 'The parameter is invalid. Please check again.', 'description' => '参数错误，请检查参数值'], + ], + 403 => [ + ['errorCode' => 'AuthFailed', 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', 'description' => '授权失败，请检查RAM权限配置'], + ], + 408 => [ + ['errorCode' => 'Timeout', 'errorMessage' => 'The request has timed out.', 'description' => '请求超时，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], + ], + 503 => [ + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'The service is unavailable.', 'description' => '服务不可用，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], + ], + ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"4F609A30-F645-481E-A513-CADAA14DFB0A\\",\\n \\"Data\\": {\\n \\"Attributes\\": [\\n {\\n \\"Gender\\": {\\n \\"Score\\": 0.9798987507820129,\\n \\"Name\\": \\"female\\"\\n },\\n \\"Orient\\": {\\n \\"Score\\": 0.9783865809440613,\\n \\"Name\\": \\"Front\\"\\n },\\n \\"Age\\": {\\n \\"Score\\": 0.9959051609039307,\\n \\"Name\\": \\"Age18-60\\"\\n },\\n \\"UpperWear\\": {\\n \\"Score\\": 0.8929191827774048,\\n \\"Name\\": \\"ShortSleeve\\"\\n },\\n \\"Glasses\\": {\\n \\"Score\\": 0.8728447109460831,\\n \\"Name\\": \\"No\\"\\n },\\n \\"LowerWear\\": {\\n \\"Score\\": 0.6424860954284668,\\n \\"Name\\": \\"Trousers\\"\\n },\\n \\"LowerColor\\": {\\n \\"Score\\": 0.6996174454689026,\\n \\"Name\\": \\"黑\\"\\n },\\n \\"Hat\\": {\\n \\"Score\\": 0.9827239401638508,\\n \\"Name\\": \\"No\\"\\n },\\n \\"Handbag\\": {\\n \\"Score\\": 0.5501167178153992,\\n \\"Name\\": \\"Yes\\"\\n },\\n \\"Backpack\\": {\\n \\"Score\\": 0.9648653864860535,\\n \\"Name\\": \\"No\\"\\n },\\n \\"UpperColor\\": {\\n \\"Score\\": 0.9779627323150635,\\n \\"Name\\": \\"黄\\"\\n },\\n \\"ShoulderBag\\": {\\n \\"Score\\": 0.911987878382206,\\n \\"Name\\": \\"No\\"\\n }\\n }\\n ],\\n \\"Boxes\\": [\\n {\\n \\"BottomRightX\\": 584,\\n \\"TopLeftY\\": 27,\\n \\"Score\\": 0.8838106393814087,\\n \\"TopLeftX\\": 36,\\n \\"BottomRightY\\": 218\\n }\\n ],\\n \\"PersonNumber\\": 1,\\n \\"Width\\": 264,\\n \\"Height\\": 584\\n }\\n}","errorExample":""},{"type":"xml","example":"4F609A30-F645-481E-A513-CADAA14DFB0A\\n\\n 1\\n \\n \\n 0.96486538648605347\\n No\\n \\n \\n 0.6424860954284668\\n Trousers\\n \\n \\n 0.97838658094406128\\n Front\\n \\n \\n 0.91198787838220596\\n No\\n \\n \\n 0.69961744546890259\\n 黑\\n \\n \\n 0.87284471094608307\\n No\\n \\n \\n 0.97796273231506348\\n 黄\\n \\n \\n 0.55011671781539917\\n Yes\\n \\n \\n 0.98272394016385078\\n No\\n \\n \\n 0.97989875078201294\\n female\\n \\n \\n 0.99590516090393066\\n Age18-60\\n \\n \\n 0.89291918277740479\\n ShortSleeve\\n \\n \\n \\n 584\\n 0.88381063938140869\\n 218\\n 27\\n 36\\n \\n","errorExample":""}]', + 'title' => '人体结构化属性', + 'summary' => '本文介绍人体结构化属性PedestrianDetectAttribute的语法及示例。', + 'description' => '## 功能描述'."\n" + .'人体结构化属性能力可以检测图片中人体的属性，具体功能包括人体检测以及属性预估。例如：性别、年龄、朝向、帽子、眼镜、包、衣服、颜色等。'."\n" ."\n" .'> - 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" - .'- 当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击[立即试用](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=RecognizeAction)对该能力进行更直观试用以及在线购买。'."\n" + .'- 当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击[立即试用](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=PedestrianDetectAttribute)对该能力进行更直观试用以及在线购买。'."\n" .'- 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。'."\n" ."\n" - .'## 应用场景'."\n" - .'- 驾驶员监控系统（DMS）：检测驾驶员是否存在吸烟、吃喝、打电话、玩手机等影响安全驾驶的行为。'."\n" - .'- 学习状况监测：监测学习过程是否存在举手、玩手机、趴桌子睡觉等行为。'."\n" - .'- 公共场所行为监测：监测在博物馆、展览馆等公共场所是否存在吸烟、打电话、拍照等不文明行为，以及是否有跌倒这样的异常情况发生。'."\n" - .'- 工作场所监督：监测在工作场所是否存在吃喝、吸烟、打电话、趴桌子睡觉等行为，是否有按要求洗手。'."\n" - ."\n" .'## 特色优势'."\n" - .'- 覆盖多种应用场景：支持识别举手、吃喝、吸烟、打电话、玩手机、睡觉、跌打、洗手、拍照等行为，涵盖驾驶、学习、泛安防等多种场景。'."\n" - .'- 适应多种光照条件：适应在自然光、室内光照、夜晚红外模式等光照条件下的行为识别。'."\n" + .'丰富属性：提供丰富人体属性，包括年龄、性别、是否带眼镜、有无帽子、有无背包、有无手提包、有无肩挎包、上衣颜色、上衣种类、下衣颜色、下衣种类、人体朝向等。'."\n" ."\n" .'## 接入指引'."\n" .'1. 注册阿里云账号：打开[阿里云官网](https://www.aliyun.com)，在阿里云官网右上角，单击**立即注册**，按照操作提示完成账号注册。'."\n" @@ -7285,15 +5647,13 @@ .'> 本能力支持企业或个人认证用户开通。更多实名认证操作信息，请参见[实名认证](https://help.aliyun.com/knowledge_list/37170.html)。'."\n" ."\n" .'3. 创建AccessKey：请确保您已[创建AccessKey](~~175144~~)，如果您使用的是子账号AccessKey，您需要给子账号赋予AliyunVIAPIFullAccess权限，具体操作，请参见[RAM授权](~~145025~~)。'."\n" - .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/facebody/2019-12-30/RecognizeAction?lang=JAVA&sdkStyle=old¶ms=%7B%22Type%22%3A1%2C%22URLList%22%3A%5B%7B%22URL%22%3A%22http%3A%2F%2Fviapi-test.oss-cn-shanghai.aliyuncs.com%2Fviapi-3.0domepic%2Ffacebody%2FRecognizeAction%2F1RecognizeAction1.png%22%7D%2C%7B%22URL%22%3A%22http%3A%2F%2Fviapi-test.oss-cn-shanghai.aliyuncs.com%2Fviapi-3.0domepic%2Ffacebody%2FRecognizeAction%2F1RecognizeAction2.png%22%7D%2C%7B%22URL%22%3A%22http%3A%2F%2Fviapi-test.oss-cn-shanghai.aliyuncs.com%2Fviapi-3.0domepic%2Ffacebody%2FRecognizeAction%2F1RecognizeAction3.png%22%7D%2C%7B%22URL%22%3A%22http%3A%2F%2Fviapi-test.oss-cn-shanghai.aliyuncs.com%2Fviapi-3.0domepic%2Ffacebody%2FRecognizeAction%2F1RecognizeAction4.png%22%7D%5D%7D&tab=DEMO)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" + .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/facebody/2019-12-30/PedestrianDetectAttribute?lang=JAVA&sdkStyle=old¶ms=%7B%22ImageURL%22%3A%22http%3A%2F%2Fviapi-test.oss-cn-shanghai.aliyuncs.com%2Fviapi-3.0domepic%2Ffacebody%2FPedestrianDetectAttribute%2FPedestrianDetectAttribute1.jpg%22%7D&tab=DEMO)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" .'5. 开发接入步骤：'."\n" .'- 在[SDK总览](~~145033~~)中选择您要接入使用的SDK语言。'."\n" .'- 在对应语言的SDK文档中找到AI类目为人脸人体（facebody）的SDK包进行安装。'."\n" .'- 参考文档中提供的示例代码进行适当修改后调用。'."\n" ."\n" - .'6. 示例代码：该能力常用语言的示例代码，请参见[动作行为识别示例代码](~~478479~~)。'."\n" - ."\n" - .'7. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" + .'6. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" .'- [Web前端直接调用](~~467779~~)'."\n" .'- [小程序场景下直接调用](~~467780~~)'."\n" .'- [Android端直接调用](~~467781~~)'."\n" @@ -7301,136 +5661,119 @@ ."\n" .'## 输入限制'."\n" ."\n" - .'- 视频要求：'."\n" - .' 1. 时长大于2秒，小于5秒。如果输入视频时长大于5秒，系统仅返回前5秒的检测结果。'."\n" - .' 2. 视频大小应小于10 MB。'."\n" - .' 3. 分辨率大于256×256像素，小于等于1280×720像素。'."\n" - .' 4. 支持一些常见的视频格式，例如MPEG、AVI、MOV、MP4。'."\n" + .'- 图像格式：JPG、JPEG、PNG、BMP。'."\n" ."\n" - .' > 建议为居家摄像头或近距离监控场景。即摄像头固定不动，拍摄距离为2米~10米。'."\n" - .'- 图像要求：'."\n" + .'- 图像大小：不大于3 MB。'."\n" ."\n" - .' 1. 帧数4帧，必须是同一个视频连续2秒均匀抽帧的结果。如果输入4帧非同一个视频中的，会导致识别报错。'."\n" - .' 2. 分辨率大于256×256像素，小于等于1280×720像素。'."\n" - .' 3. 支持的格式为JPEG、PNG、BMP、JPG。'."\n" - .' 4. 可使用URL与Base64编码字符串混合输入。'."\n" + .'- 图像分辨率：大于20×20像素，小于2048×2048像素。'."\n" ."\n" - .'- URL地址中不能包含中文字符。', + .'- URL地址中不能包含中文字符。'."\n" + ."\n" + .'> 当图像分辨率超过最大限制时，请先将图片进行缩放，调整图片大小，具体请参见[图片缩放](~~44688~~)。'."\n" + ."\n" + .'## 计费说明'."\n" + .'关于人体结构化属性的计费方式及报价，请参见[计费介绍](~~184049~~)。'."\n" + .'> 下方调试接口为付费接口，如需免费体验调试请前往[体验中心](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=PedestrianDetectAttribute)。', 'requestParamsDescription' => ' ', 'responseParamsDescription' => '## SDK参考'."\n" - .'阿里云视觉AI人脸人体类目下的动作行为识别能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。'."\n" - ."\n" - .'## 示例代码'."\n" - .'该能力常用语言的示例代码，请参见[动作行为识别示例代码](~~478479~~)。', + .'阿里云视觉AI人脸人体类目下的人体结构化属性能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。', 'extraInfo' => '## 错误码'."\n" - .'关于动作行为识别的错误码，详情请参见[常见错误码](~~146756~~)。'."\n" - ."\n\n" + .'关于人体结构化属性的错误码，详情请参见[常见错误码](~~146756~~)。'."\n" + ."\n" .'## 安全声明'."\n" ."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。', - ], - 'RecognizeExpression' => [ - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'http', - 'https', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-facebody:PedestrianDetectAttribute', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + ], + 'QueryFaceImageTemplate' => [ + 'summary' => '本文介绍图像人脸融合模板查询QueryFaceImageTemplate的语法及示例。', + 'methods' => ['get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'readAndWrite', - 'systemTags' => [], + 'deprecated' => false, + 'systemTags' => ['operationType' => 'get'], 'parameters' => [ [ - 'name' => 'ImageURL', - 'in' => 'formData', - 'schema' => [ - 'description' => '图像URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。', - 'type' => 'string', - 'required' => true, - 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/RecognizeExpression/RecognizeExpression7.jpg', - 'isFileTransferUrl' => true, - ], + 'name' => 'TemplateId', + 'in' => 'query', + 'schema' => ['description' => '待查询的模板ID。如果未传TemplateId，返回该用户的模板列表；如果传入TemplateId，仅返回对应的结果。', 'type' => 'string', 'required' => false, 'example' => '6cd509ea-54fa-4730-8e9d-c94cadcda048'], + ], + [ + 'name' => 'PageNo', + 'in' => 'query', + 'schema' => ['description' => '当前页数设置，默认第1页。取值范围为1~5000。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'maximum' => '5000', 'minimum' => '1', 'example' => '1', 'default' => '1'], + ], + [ + 'name' => 'PageSize', + 'in' => 'query', + 'schema' => ['description' => '当前页条数设置，默认100条。取值范围为1~500。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'maximum' => '500', 'minimum' => '1', 'example' => '100', 'default' => '100'], ], ], 'responses' => [ 200 => [ 'schema' => [ + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'E1C4C576-1799-4079-A934-15BC406A54EF', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => '7C29675C-751F-4D2F-86FB-2BD8D69AC860'], 'Data' => [ 'description' => '返回的结果数据内容。', 'type' => 'object', 'properties' => [ + 'Total' => ['description' => '当前账号下的可用模板总数量。', 'type' => 'integer', 'format' => 'int64', 'example' => '20'], 'Elements' => [ - 'description' => '各个子元素的识别结果。', + 'description' => '模板列表。', 'type' => 'array', 'items' => [ - 'description' => '各个子元素的识别结果。', 'type' => 'object', 'properties' => [ - 'FaceRectangle' => [ - 'description' => '人脸区域信息。', - 'type' => 'object', - 'properties' => [ - 'Top' => [ - 'description' => '以图像左上角为坐标原点，人脸区域左上角的y坐标。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '67', - ], - 'Width' => [ - 'description' => '人脸区域的宽度。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '113', - ], - 'Height' => [ - 'description' => '人脸区域的高度。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '154', - ], - 'Left' => [ - 'description' => '以图像左上角为坐标原点，人脸区域左上角的x坐标。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '370', + 'CreateTime' => ['description' => '模板创建时间。', 'type' => 'string', 'example' => '2021-01-29 10:19:05'], + 'UpdateTime' => ['description' => '模板更新时间。', 'type' => 'string', 'example' => '2021-01-29 10:19:05'], + 'UserId' => ['description' => '用户ID。', 'type' => 'string', 'example' => 'zhangsan'], + 'TemplateId' => ['description' => '模板ID。', 'type' => 'string', 'example' => '6cd509ea-54fa-4730-8e9d-c94cadcda048'], + 'TemplateURL' => ['description' => '新增模板时设置的人脸模板图像地址。', 'type' => 'string', 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/MergeImageFace/MergeImageFace-1.png'], + 'FaceInfos' => [ + 'description' => '用户输入图为多个人脸时，返回各人脸ID和位置信息。', + 'type' => 'array', + 'items' => [ + 'description' => '用户输入图为多个人脸时，返回各人脸ID和位置信息。', + 'type' => 'object', + 'properties' => [ + 'TemplateFaceID' => ['description' => '人脸对应的子模板ID。', 'type' => 'string', 'example' => '6cd509ea-54fa-4730-8e9d-c94cadcda048'], + 'FaceRect' => [ + 'description' => '人脸对应的位置信息。', + 'type' => 'object', + 'properties' => [ + 'X' => ['description' => '人脸框左上角横坐标。', 'type' => 'string', 'example' => '254'], + 'Y' => ['description' => '人脸框左上角纵坐标。', 'type' => 'string', 'example' => '318'], + 'Height' => ['description' => '人脸框高度。', 'type' => 'string', 'example' => '94'], + 'Width' => ['description' => '人脸框宽度。', 'type' => 'string', 'example' => '89'], + ], + ], ], ], ], - 'Expression' => [ - 'description' => '表情类别。取值如下：'."\n" - ."\n" - .'- neutral：中性'."\n" - .'- happiness：高兴'."\n" - .'- surprise：惊讶'."\n" - .'- sadness：伤心'."\n" - .'- anger：生气'."\n" - .'- disgust：厌恶'."\n" - .'- fear：害怕'."\n" - .'- pouty：嘟嘴'."\n" - .'- grimace：做鬼脸', - 'type' => 'string', - 'example' => 'happiness', - ], - 'FaceProbability' => [ - 'description' => '人脸的概率，取值范围为0~1。', - 'type' => 'number', - 'format' => 'float', - 'example' => '0.88330078125', - ], ], + 'description' => '', ], ], ], @@ -7441,490 +5784,419 @@ ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'ParameterError', - 'errorMessage' => 'The parameter is invalid. Please check again.', - ], + ['errorCode' => 'ParameterError', 'errorMessage' => 'The parameter is invalid. Please check again.', 'description' => '参数错误，请检查参数值'], ], 403 => [ - [ - 'errorCode' => 'AuthFailed', - 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', - ], + ['errorCode' => 'AuthFailed', 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', 'description' => '授权失败，请检查RAM权限配置'], ], 408 => [ - [ - 'errorCode' => 'Timeout', - 'errorMessage' => 'The request has timed out.', - ], + ['errorCode' => 'Timeout', 'errorMessage' => 'The request has timed out.', 'description' => '请求超时，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'The service is unavailable.', - ], + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'The service is unavailable.', 'description' => '服务不可用，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"E1C4C576-1799-4079-A934-15BC406A54EF\\",\\n \\"Data\\": {\\n \\"Elements\\": [\\n {\\n \\"FaceRectangle\\": {\\n \\"Top\\": 67,\\n \\"Width\\": 113,\\n \\"Height\\": 154,\\n \\"Left\\": 370\\n },\\n \\"Expression\\": \\"happiness\\",\\n \\"FaceProbability\\": 0.88330078125\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n E1C4C576-1799-4079-A934-15BC406A54EF\\n \\n \\n \\n 67\\n 113\\n 154\\n 370\\n \\n happiness\\n 0.8833008\\n \\n \\n","errorExample":""}]', - 'title' => '表情识别', - 'summary' => '本文为您介绍表情识别RecognizeExpression的语法及示例。', + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"7C29675C-751F-4D2F-86FB-2BD8D69AC860\\",\\n \\"Data\\": {\\n \\"Total\\": 20,\\n \\"Elements\\": [\\n {\\n \\"CreateTime\\": \\"2021-01-29 10:19:05\\",\\n \\"UpdateTime\\": \\"2021-01-29 10:19:05\\",\\n \\"UserId\\": \\"zhangsan\\",\\n \\"TemplateId\\": \\"6cd509ea-54fa-4730-8e9d-c94cadcda048\\",\\n \\"TemplateURL\\": \\"http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/MergeImageFace/MergeImageFace-1.png\\",\\n \\"FaceInfos\\": [\\n {\\n \\"TemplateFaceID\\": \\"6cd509ea-54fa-4730-8e9d-c94cadcda048\\",\\n \\"FaceRect\\": {\\n \\"X\\": \\"254\\",\\n \\"Y\\": \\"318\\",\\n \\"Height\\": \\"94\\",\\n \\"Width\\": \\"89\\"\\n }\\n }\\n ]\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n 7C29675C-751F-4D2F-86FB-2BD8D69AC860\\n \\n 20\\n \\n 2021-01-29 10:19:05\\n 2021-01-29 10:19:05\\n zhangsan\\n 6cd509ea-54fa-4730-8e9d-c94cadcda048\\n http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/MergeImageFace/MergeImageFace-1.png\\n \\n 6cd509ea-54fa-4730-8e9d-c94cadcda048\\n \\n 254\\n 318\\n 94\\n 89\\n \\n \\n \\n \\n","errorExample":""}]', + 'title' => '查询人脸图像模板', 'description' => '## 功能描述'."\n" - .'表情识别能力可以检测和识别图片中人脸的表情。表情种类为：neutral（中性）、happiness（高兴）、surprise（惊讶）、sadness（伤心）、anger（生气）、disgust（厌恶）、fear（害怕）、pouty（嘟嘴）、grimace（鬼脸）。'."\n" - .'关于该接口功能的示例图如下：'."\n" - ."\n" - .'- 输入原图'."\n" - .'![](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20231206/ggvw/RecognizeExpression.jpeg" width="500)'."\n" - .'- 检测返回结果示意图'."\n" - .'![](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20231206/iddo/RecognizeExpression1.png" width="500)'."\n" + .'图像人脸融合模板查询功能可以查询用户添加过的人脸模板图。'."\n" ."\n" .'> - 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" - .'- 当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击[立即试用](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=RecognizeExpression)对该能力进行更直观试用以及在线购买。'."\n" .'- 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。'."\n" ."\n" - .'## 应用场景'."\n" - .'- 面部识别场景：通过识别用户人脸面部表情，对面部的真实表情进行检测和控制。'."\n" - .'- 表情识别场景：通过表情识别技术，来确定被识别对象的心理情绪理解。'."\n" - .'- 互动娱乐场景：获取表情、情绪等人脸属性信息，实现特效相机等互动娱乐功能。'."\n" - ."\n" - .'## 特色优势'."\n" - ."\n" - .'- 支持识别多种表情：中性、高兴、惊讶、伤心、生气、厌恶、害怕、嘟嘴、鬼脸等9种情绪。'."\n" - .'- 简单易用：可直接调用的API接口，服务简单易用，易被集成，兼容性强。'."\n" - .'- 尊重客户隐私，图片上传24小时内删除，服务不留存客户图像。'."\n" - ."\n" .'## 接入指引'."\n" - .'1. 注册阿里云账号：打开[阿里云官网](https://www.aliyun.com)，在阿里云官网右上角，单击**立即注册**，按照操作提示完成账号注册。'."\n" - .'2. 开通能力：请确保您已开通[人脸人体服务](https://vision.aliyun.com/facebody)，若未开通服务请[立即开通](https://common-buy.aliyun.com/?commodityCode=viapi_facebody_public_cn#/open)。'."\n" - .'> 本能力支持企业或个人认证用户开通。更多实名认证操作信息，请参见[实名认证](https://help.aliyun.com/knowledge_list/37170.html)。'."\n" + .'1. 注册阿里云账号：打开[阿里云官网](https://www.aliyun.com)，在阿里云官网右上角，单击**立即注册**，按照操作提示完成账号注册。'."\n" + .'2. 开通能力：请确保您已开通[人脸人体服务](https://vision.aliyun.com/facebody)，若未开通服务请[立即开通](https://common-buy.aliyun.com/?commodityCode=viapi_facebody_public_cn#/open)。'."\n" + .'>'."\n" + .'本能力仅限企业认证用户开通。更多实名认证操作信息，请参见[实名认证](https://help.aliyun.com/knowledge_list/37170.html)。'."\n" + .'>'."\n" + ."\n" .'3. 创建AccessKey：请确保您已[创建AccessKey](~~175144~~)，如果您使用的是子账号AccessKey，您需要给子账号赋予AliyunVIAPIFullAccess权限，具体操作，请参见[RAM授权](~~145025~~)。'."\n" - .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/facebody/2019-12-30/RecognizeExpression?lang=JAVA&sdkStyle=dara¶ms=%7B%22ImageURL%22%3A%22http%3A%2F%2Fviapi-test.oss-cn-shanghai.aliyuncs.com%2Fviapi-3.0domepic%2Ffacebody%2FRecognizeExpression%2FRecognizeExpression1.jpg%22%7D&tab=DEMO)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" - .'5. 开发接入步骤：'."\n" + .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/facebody/2019-12-30/QueryFaceImageTemplate?lang=JAVA&sdkStyle=old¶ms=%7B%7D&tab=DEMO)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" + .'5. 前提条件：已通过[图像人脸融合模板增加接口](~~203512~~)（AddFaceImageTemplate）创建生成了TemplateId。'."\n" + .'6. 开发接入步骤：'."\n" .'- 在[SDK总览](~~145033~~)中选择您要接入使用的SDK语言。'."\n" .'- 在对应语言的SDK文档中找到AI类目为人脸人体（facebody）的SDK包进行安装。'."\n" .'- 参考文档中提供的示例代码进行适当修改后调用。'."\n" ."\n" - .'6. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" + .'7. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" .'- [Web前端直接调用](~~467779~~)'."\n" .'- [小程序场景下直接调用](~~467780~~)'."\n" .'- [Android端直接调用](~~467781~~)'."\n" .'- [iOS端直接调用](~~467782~~)'."\n" - ."\n\n" - .'## 输入限制'."\n" - .'- 图像格式：JPEG、JPG、BMP、PNG、TIF、WEBP。'."\n" - .'- 图像大小：不超过3 MB。'."\n" - .'- 图片分辨率：大于5×5像素，小于2048×2048像素，人脸占比不低于64×64像素。'."\n" - .'- URL地址中不能包含中文字符。'."\n" - ."\n" - .'> 当图像分辨率超过最大限制时，请先将图片进行缩放，调整图片大小，具体请参见[图片缩放](~~44688~~)。'."\n" ."\n" .'## 计费说明'."\n" - .'关于表情识别的计费方式及报价，请参见[计费介绍](~~184049~~)。'."\n" - ."\n" - .'> 下方调试接口为付费接口，如需免费体验调试请前往[体验中心](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=RecognizeExpression)。'."\n", - 'requestParamsDescription' => ' ', + .'图像人脸融合模板查询能力可免费调用。', 'responseParamsDescription' => '## SDK参考'."\n" - .'阿里云视觉AI人脸人体类目下的表情识别能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。', - 'extraInfo' => '## 错误码'."\n" - .'关于表情识别的错误码，详情请参见[常见错误码](~~146756~~)。'."\n" - ."\n" - .'## 开源模型体验'."\n" - .'更多开源免费模型体验及下载，详见魔搭社区：[人脸属性识别模型FairFace](https://modelscope.cn/models/damo/cv_resnet34_face-attribute-recognition_fairface/summary)、[人脸表情识别模型FER](https://modelscope.cn/models/damo/cv_vgg19_facial-expression-recognition_fer/summary)、[人脸质量模型FQA](https://modelscope.cn/models/damo/cv_manual_face-quality-assessment_fqa/summary)。'."\n" - ."\n" + .'阿里云视觉AI人脸人体类目下的图像人脸融合模板查询能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。', + 'extraInfo' => '## 错误码'."\n" + .'关于图像人脸融合模板查询的错误码，详情请参见[常见错误码](~~146756~~)。'."\n" + ."\n\n" .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" - .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。'."\n" - .'- 平台不存储用户在使用服务过程中涉及的原始人脸图片或文件信息。', - ], - 'BatchAddFaces' => [ - 'summary' => '本文介绍批量添加人脸数据BatchAddFaces的语法及示例。', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'http', - 'https', + .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'viapi-facebody:QueryFaceImageTemplate', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + ], + 'RecognizeAction' => [ + 'summary' => '本文介绍动作行为识别RecognizeAction的语法及示例。', + 'methods' => ['post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'write', + 'operationType' => 'read', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'none', - 'riskType' => 'none', - 'chargeType' => 'free', - 'tenantRelevance' => 'publicInformation', - ], + 'systemTags' => [], 'parameters' => [ [ - 'name' => 'DbName', - 'in' => 'formData', - 'schema' => [ - 'description' => '数据库名称。支持小写字母、数字、下划线的组合，长度1~64。', - 'type' => 'string', - 'required' => true, - 'example' => 'default', - ], - ], - [ - 'name' => 'EntityId', - 'in' => 'formData', - 'schema' => [ - 'description' => '实体ID，用来标识用户的唯一性，如用户ID、员工ID等。每个实体可包含多张人脸图片。支持大小写字母、数字、下划线的组合，长度为1~64。', - 'type' => 'string', - 'required' => true, - 'example' => 'U1', - ], - ], - [ - 'name' => 'SimilarityScoreThresholdInEntity', + 'name' => 'Type', 'in' => 'formData', - 'schema' => [ - 'description' => '类内相似度阈值。将新增人脸图片与**EntityId**内已有人脸进行相似比对，小于该阈值则表示与其他人脸图片差异较大，添加失败.；若**EntityId**内没有人脸存在，则添加成功。取值范围\\[0.0,100.0]。0.0或空则表示不做类内相似度判断逻辑。参考值见[人脸比对1:1](~~151891~~)接口的返回结果字段**Thresholds**。', - 'type' => 'number', - 'format' => 'float', - 'required' => false, - 'example' => '50.0', - ], + 'schema' => ['description' => '输入内容类型，包括视频和图像两种类型。'."\n" + ."\n" + .'- 0：表示输入视频URL或视频Base64编码字符串。'."\n" + ."\n" + .'- 1：表示输入图像URL或图像Base64编码字符串。'."\n" + ."\n" + .'- 其他：非法输入。'."\n", 'type' => 'integer', 'format' => 'int32', 'required' => true, 'example' => '0'], ], [ - 'name' => 'SimilarityScoreThresholdBetweenEntity', + 'name' => 'VideoUrl', 'in' => 'formData', - 'schema' => [ - 'description' => '类间相似度阈值。将新增人脸图片与其他所有**EntityId**内已有人脸进行相似比对，大于等于该阈值则表示其他**EntityId**内存在相似人脸，出现重复，添加失败。取值范围\\[0.0,100.0]。0.0或空则表示不做类间相似度判断逻辑。参考值见[人脸比对1:1](~~151891~~)接口的返回结果字段**Thresholds**。'."\n" - ."\n" - .'> 类间相似度阈值检查仅适用于每个EntityId下首次上传的第一张人脸图片。', - 'type' => 'number', - 'format' => 'float', - 'required' => false, - 'example' => '50.0', - ], + 'schema' => ['description' => 'Type为0时需要输入的视频URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。', 'type' => 'string', 'required' => false, 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/RecognizeAction/RecognizeAction-video1.mp4', 'isFileTransferUrl' => true], ], [ - 'name' => 'Faces', + 'name' => 'URLList', 'in' => 'formData', - 'style' => 'json', + 'style' => 'repeatList', 'schema' => [ - 'description' => '人脸信息。', + 'description' => '图像列表', 'type' => 'array', 'items' => [ - 'description' => '1', + 'description' => '图像列表', 'type' => 'object', 'properties' => [ - 'ExtraData' => [ - 'description' => '自定义信息。支持字母、数字、标点符号和汉字。不超过512个字符。', - 'type' => 'string', - 'required' => false, - 'example' => '王小二', - ], - 'ImageURL' => [ - 'description' => '人脸图像URL地址。人脸必须是正面无遮挡单人人脸。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。URL长度不超过1024个字符。', - 'type' => 'string', - 'required' => true, - 'example' => 'https://viapi-test.oss-cn-shanghai.aliyuncs.com/test/imgsearch/demo/1.png', - 'isFileTransferUrl' => true, - ], + 'URL' => ['description' => 'Type为1时需要输入的图像URL地址，**必须输入4张图像，且4张图像建议为两秒钟视频均匀采样的图像，分辨率和通道数必须一致**。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。', 'type' => 'string', 'required' => false, 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/RecognizeAction/1RecognizeAction1.png', 'isFileTransferUrl' => true], + 'imageData' => ['description' => '图像Base64编码字符串，与URL共存时，URL优先。文件的Base64编码处理操作，请参见[文件Base64处理](~~468191~~)。', 'type' => 'string', 'required' => false, 'example' => '/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAgGBgcGBQgHBwcJCQgQ****'], ], 'required' => false, ], - 'required' => true, - 'maxItems' => 5, + 'required' => false, + 'maxItems' => 300, ], ], [ - 'name' => 'QualityScoreThreshold', + 'name' => 'VideoData', 'in' => 'formData', - 'schema' => [ - 'description' => '质量分阈值。对新增人脸图片进行质量分析判断，得到的质量分小于该阈值则表示新增人脸图片质量不符合要求，添加失败。取值范围\\[0.0,100.0]。0.0或空则表示不做质量分判断逻辑。', - 'type' => 'number', - 'format' => 'float', - 'required' => false, - 'example' => '50.0', - ], + 'schema' => ['description' => '视频Base64编码字符串，与VideoURL共存时，VideoURL优先。文件的Base64编码处理操作，请参见[文件Base64处理](~~468191~~)。', 'type' => 'string', 'required' => false, 'example' => 'iVBORw0KGgoAAAANSUhEUgAAAoAAAAHJCAIAAACaEB9NAAEAAElEQVR4nNT9Wb****'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => '1', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'C46A46D0-3263-181A-A1EE-0901E4595390', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'E9C40AF5-A7F8-49D5-8A0C-B21F15A07F17'], 'Data' => [ 'description' => '返回的结果数据内容。', 'type' => 'object', 'properties' => [ - 'InsertedFaces' => [ - 'description' => '添加成功的记录结果。', - 'type' => 'array', - 'items' => [ - 'description' => '1', - 'type' => 'object', - 'properties' => [ - 'ImageURL' => [ - 'description' => '人脸图像地址，与输入的ImageUrl相同，用来标记图像记录。', - 'type' => 'string', - 'example' => 'https://viapi-test.oss-cn-shanghai.aliyuncs.com/test/imgsearch/demo/xxxx.png', - ], - 'FaceId' => [ - 'description' => '输出人脸ID。', - 'type' => 'string', - 'example' => '16350536', - ], - 'QualitieScore' => [ - 'description' => '输入图像中的人脸质量分。', - 'type' => 'number', - 'format' => 'float', - 'example' => '99.79581', - ], - ], - ], - ], - 'FailedFaces' => [ - 'description' => '添加失败的记录结果。', + 'Elements' => [ + 'description' => '返回的结果元素列表。', 'type' => 'array', 'items' => [ - 'description' => '1', 'type' => 'object', 'properties' => [ - 'ImageURL' => [ - 'description' => '人脸图像地址，与输入的ImageUrl相同，用来标记图像记录。', - 'type' => 'string', - 'example' => 'https://viapi-test.oss-cn-shanghai.aliyuncs.com/test/imgsearch/demo/xxxx.png', + 'Scores' => [ + 'type' => 'array', + 'items' => ['description' => '行为类别的置信度。取值范围0~1，值越大，识别到的动作越准确。系统根据算法，为不同的动作给出判断的阈值标准，您也可以根据自己的实际情况，对判断的阈值标准进行调整。'."\n" + ."\n" + .'- 举手：0.5（低于0.5则认为不是举手行为，否则认为是举手行为。）'."\n" + ."\n" + .'- 吃喝：0.5（低于0.5则认为不是吃喝行为，否则认为是吃喝行为。）'."\n" + ."\n" + .'- 吸烟：0.5（低于0.5则认为不是吸烟行为，否则认为是吸烟行为。）'."\n" + ."\n" + .'- 打电话：0.5（低于0.5则认为不是打电话行为，否则认为是打电话行为。）'."\n" + ."\n" + .'- 玩手机：0.5（低于0.5则认为不是玩手机行为，否则认为是玩手机行为。）'."\n" + ."\n" + .'- 趴桌睡觉：0.5（低于0.5则认为不是趴桌睡觉行为，否则认为是趴桌睡觉行为。）'."\n" + ."\n" + .'- 跌倒：0.5（低于0.5则认为不是跌倒行为，否则认为是跌倒行为。）'."\n" + .'- 洗手：0.5（低于0.5则认为不是洗手行为，否则认为是洗手行为。）'."\n" + .'- 拍照：0.5（低于0.5则认为不是拍照行为，否则认为是拍照行为。）', 'type' => 'number', 'format' => 'float', 'example' => '0.702967643737793'], + 'description' => '', ], - 'Code' => [ - 'description' => '错误码。', - 'type' => 'string', - 'example' => 'ClientError.IllegalArgument', + 'Labels' => [ + 'type' => 'array', + 'items' => ['description' => '识别到的行为类别。', 'type' => 'string', 'example' => '跌倒'], + 'description' => '', ], - 'Message' => [ - 'description' => '错误信息。', - 'type' => 'string', - 'example' => 'not found the db=test', + 'Boxes' => [ + 'description' => '具体动作的坐标框列表。', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'Box' => [ + 'type' => 'array', + 'items' => ['description' => '具体动作的坐标框信息。', 'type' => 'integer', 'format' => 'int32', 'example' => '[1119,576,1373,970]'], + 'description' => '', + ], + ], + 'description' => '', + ], ], + 'Timestamp' => ['description' => '当前行为在视频或者图像中发生的时间戳信息。', 'type' => 'integer', 'format' => 'int32', 'example' => '3'], ], + 'description' => '', ], ], ], ], ], + 'description' => '', ], ], ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'ParameterError', - 'errorMessage' => 'The parameter is invalid. Please check again.', - ], + ['errorCode' => 'ParameterError', 'errorMessage' => 'The parameter is invalid. Please check again.', 'description' => '参数错误，请检查参数值'], ], 403 => [ - [ - 'errorCode' => 'AuthFailed', - 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', - ], + ['errorCode' => 'AuthFailed', 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', 'description' => '授权失败，请检查RAM权限配置'], ], 408 => [ - [ - 'errorCode' => 'Timeout', - 'errorMessage' => 'The request has timed out.', - ], + ['errorCode' => 'Timeout', 'errorMessage' => 'The request has timed out.', 'description' => '请求超时，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'The service is unavailable.', - ], + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'The service is unavailable.', 'description' => '服务不可用，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"C46A46D0-3263-181A-A1EE-0901E4595390\\",\\n \\"Data\\": {\\n \\"InsertedFaces\\": [\\n {\\n \\"ImageURL\\": \\"https://viapi-test.oss-cn-shanghai.aliyuncs.com/test/imgsearch/demo/xxxx.png\\",\\n \\"FaceId\\": \\"16350536\\",\\n \\"QualitieScore\\": 99.79581\\n }\\n ],\\n \\"FailedFaces\\": [\\n {\\n \\"ImageURL\\": \\"https://viapi-test.oss-cn-shanghai.aliyuncs.com/test/imgsearch/demo/xxxx.png\\",\\n \\"Code\\": \\"ClientError.IllegalArgument\\",\\n \\"Message\\": \\"not found the db=test\\"\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n C46A46D0-3263-181A-A1EE-0901E4595390\\n \\n \\n https://viapi-test.oss-cn-shanghai.aliyuncs.com/test/imgsearch/demo/xxxx.png\\n 16350536\\n 99.79581\\n \\n \\n https://viapi-test.oss-cn-shanghai.aliyuncs.com/test/imgsearch/demo/xxxx.png\\n ClientError.IllegalArgument\\n not found the db=test\\n \\n \\n","errorExample":""}]', - 'title' => '批量添加人脸数据', + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"E9C40AF5-A7F8-49D5-8A0C-B21F15A07F17\\",\\n \\"Data\\": {\\n \\"Elements\\": [\\n {\\n \\"Scores\\": [\\n 0.702967643737793\\n ],\\n \\"Labels\\": [\\n \\"跌倒\\"\\n ],\\n \\"Boxes\\": [\\n {\\n \\"Box\\": [\\n 0\\n ]\\n }\\n ],\\n \\"Timestamp\\": 3\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"E9C40AF5-A7F8-49D5-8A0C-B21F15A07F17\\n\\n \\n 1\\n \\n \\n 0.702967643737793\\n 跌倒\\n 3\\n \\n 1119\\n 576\\n 1373\\n 970\\n \\n \\n \\n 0.7334273457527161\\n 跌倒\\n 5\\n \\n 1128\\n 613\\n 1363\\n 991\\n \\n \\n","errorExample":""}]', + 'title' => '动作行为识别', 'description' => '## 功能描述'."\n" - .'批量添加人脸数据能力可以为已创建好的人脸样本中批量添加人脸数据，每个人脸样本最多可以添加5张人脸照片，所以批量添加最多一次添加5张人脸照片。'."\n" + .'动作行为识别能力可以识别视频和图像中的人体动作行为，并返回识别后的行为类别。当前可以识别的行为类别包括：举手、吃喝、吸烟、打电话、玩手机、趴桌睡觉、跌倒、洗手、拍照。您可以根据系统提供的动作置信度判断阈值，对识别的动作进行判断。'."\n" + ."\n" + .'**动作行为识别适用范围：**'."\n" + .'- 举手：手臂伸直高高举起，手腕高过头顶。'."\n" + .'- 吃喝：吃东西或者喝水。'."\n" + .'- 吸烟：将烟点着，真吸烟，画面中需要能看清烟。'."\n" + .'- 打电话：电话或者微信语音，手机必须靠近耳朵或者嘴边。'."\n" + .'- 玩手机：用手机打字、浏览手机、看视频、玩游戏，视频聊天等玩手机行为，画面中需要能看清手机。'."\n" + .'- 趴桌睡觉：头趴在桌子上睡觉。'."\n" + .'- 跌倒：整个人跌倒在地，身体倒下。'."\n" + .'- 洗手：在水龙头或者盆中洗手。'."\n" + .'- 拍照：手机稍微举起，用手机对着某人或物拍照。'."\n" ."\n" .'> - 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" + .'- 当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击[立即试用](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=RecognizeAction)对该能力进行更直观试用以及在线购买。'."\n" .'- 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。'."\n" ."\n" + .'## 应用场景'."\n" + .'- 驾驶员监控系统（DMS）：检测驾驶员是否存在吸烟、吃喝、打电话、玩手机等影响安全驾驶的行为。'."\n" + .'- 学习状况监测：监测学习过程是否存在举手、玩手机、趴桌子睡觉等行为。'."\n" + .'- 公共场所行为监测：监测在博物馆、展览馆等公共场所是否存在吸烟、打电话、拍照等不文明行为，以及是否有跌倒这样的异常情况发生。'."\n" + .'- 工作场所监督：监测在工作场所是否存在吃喝、吸烟、打电话、趴桌子睡觉等行为，是否有按要求洗手。'."\n" + ."\n" + .'## 特色优势'."\n" + .'- 覆盖多种应用场景：支持识别举手、吃喝、吸烟、打电话、玩手机、睡觉、跌打、洗手、拍照等行为，涵盖驾驶、学习、泛安防等多种场景。'."\n" + .'- 适应多种光照条件：适应在自然光、室内光照、夜晚红外模式等光照条件下的行为识别。'."\n" + ."\n" .'## 接入指引'."\n" .'1. 注册阿里云账号：打开[阿里云官网](https://www.aliyun.com)，在阿里云官网右上角，单击**立即注册**，按照操作提示完成账号注册。'."\n" .'2. 开通能力：请确保您已开通[人脸人体服务](https://vision.aliyun.com/facebody)，若未开通服务请[立即开通](https://common-buy.aliyun.com/?commodityCode=viapi_facebody_public_cn#/open)。'."\n" ."\n" - .'>'."\n" - .'本能力支持企业或个人认证用户开通。更多实名认证操作信息，请参见[实名认证](https://help.aliyun.com/knowledge_list/37170.html)。'."\n" - .'>'."\n" + .'> 本能力支持企业或个人认证用户开通。更多实名认证操作信息，请参见[实名认证](https://help.aliyun.com/knowledge_list/37170.html)。'."\n" ."\n" .'3. 创建AccessKey：请确保您已[创建AccessKey](~~175144~~)，如果您使用的是子账号AccessKey，您需要给子账号赋予AliyunVIAPIFullAccess权限，具体操作，请参见[RAM授权](~~145025~~)。'."\n" - .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/facebody/2019-12-30/BatchAddFaces?lang=JAVA)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" + .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/facebody/2019-12-30/RecognizeAction?lang=JAVA&sdkStyle=old¶ms=%7B%22Type%22%3A1%2C%22URLList%22%3A%5B%7B%22URL%22%3A%22http%3A%2F%2Fviapi-test.oss-cn-shanghai.aliyuncs.com%2Fviapi-3.0domepic%2Ffacebody%2FRecognizeAction%2F1RecognizeAction1.png%22%7D%2C%7B%22URL%22%3A%22http%3A%2F%2Fviapi-test.oss-cn-shanghai.aliyuncs.com%2Fviapi-3.0domepic%2Ffacebody%2FRecognizeAction%2F1RecognizeAction2.png%22%7D%2C%7B%22URL%22%3A%22http%3A%2F%2Fviapi-test.oss-cn-shanghai.aliyuncs.com%2Fviapi-3.0domepic%2Ffacebody%2FRecognizeAction%2F1RecognizeAction3.png%22%7D%2C%7B%22URL%22%3A%22http%3A%2F%2Fviapi-test.oss-cn-shanghai.aliyuncs.com%2Fviapi-3.0domepic%2Ffacebody%2FRecognizeAction%2F1RecognizeAction4.png%22%7D%5D%7D&tab=DEMO)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" .'5. 开发接入步骤：'."\n" .'- 在[SDK总览](~~145033~~)中选择您要接入使用的SDK语言。'."\n" .'- 在对应语言的SDK文档中找到AI类目为人脸人体（facebody）的SDK包进行安装。'."\n" .'- 参考文档中提供的示例代码进行适当修改后调用。'."\n" ."\n" - .'6. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" + .'6. 示例代码：该能力常用语言的示例代码，请参见[动作行为识别示例代码](~~478479~~)。'."\n" + ."\n" + .'7. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" .'- [Web前端直接调用](~~467779~~)'."\n" .'- [小程序场景下直接调用](~~467780~~)'."\n" .'- [Android端直接调用](~~467781~~)'."\n" .'- [iOS端直接调用](~~467782~~)'."\n" ."\n" .'## 输入限制'."\n" - .'- 图像格式：JPG、JPEG、PNG、BMP。'."\n" - .'- 图像大小：不超过5 MB。'."\n" - .'- 图像分辨率：大于32×32像素，小于4096×4096像素。人脸占比不低于64×64像素。'."\n" - .'- URL地址中不能包含中文字符。'."\n" ."\n" - .'>当图像分辨率超过最大限制时，请先将图片进行缩放，调整图片大小，具体请参见[图片缩放](~~44688~~)。 '."\n" + .'- 视频要求：'."\n" + .' 1. 时长大于2秒，小于5秒。如果输入视频时长大于5秒，系统仅返回前5秒的检测结果。'."\n" + .' 2. 视频大小应小于10 MB。'."\n" + .' 3. 分辨率大于256×256像素，小于等于1280×720像素。'."\n" + .' 4. 支持一些常见的视频格式，例如MPEG、AVI、MOV、MP4。'."\n" ."\n" - .'## 限制说明'."\n" - .'批量添加人脸数据接口提交任务并发默认为2QPS。'."\n" + .' > 建议为居家摄像头或近距离监控场景。即摄像头固定不动，拍摄距离为2米~10米。'."\n" + .'- 图像要求：'."\n" ."\n" - .'## 计费说明'."\n" - .'批量添加人脸数据能力可免费调用。', + .' 1. 帧数4帧，必须是同一个视频连续2秒均匀抽帧的结果。如果输入4帧非同一个视频中的，会导致识别报错。'."\n" + .' 2. 分辨率大于256×256像素，小于等于1280×720像素。'."\n" + .' 3. 支持的格式为JPEG、PNG、BMP、JPG。'."\n" + .' 4. 可使用URL与Base64编码字符串混合输入。'."\n" + ."\n" + .'- URL地址中不能包含中文字符。', 'requestParamsDescription' => ' ', 'responseParamsDescription' => '## SDK参考'."\n" - .'阿里云视觉AI人脸人体类目下的批量添加人脸数据能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。', - 'extraInfo' => '## 错误码'."\n" - .'关于批量添加人脸数据的错误码，详情请参见[常见错误码](~~146756~~)。'."\n" + .'阿里云视觉AI人脸人体类目下的动作行为识别能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。'."\n" ."\n" + .'## 示例代码'."\n" + .'该能力常用语言的示例代码，请参见[动作行为识别示例代码](~~478479~~)。', + 'extraInfo' => '## 错误码'."\n" + .'关于动作行为识别的错误码，详情请参见[常见错误码](~~146756~~)。'."\n" + ."\n\n" .'## 安全声明'."\n" ."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" - .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。'."\n" - .'- 平台不存储用户在使用服务过程中涉及的原始人脸图片或文件信息。'."\n" - .'- 平台针对超过6个月及以上没有API服务调用的用户的人脸特征向量数据进行冻结，确保无服务调用的客户信息安全。如需解冻，请通过钉钉群（23109592）联系我们。', - ], - 'ExtractFingerPrint' => [ - 'summary' => '本文介绍指纹提取ExtractFingerPrint的语法及示例。', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'http', - 'https', + .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-facebody:RecognizeAction', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + ], + 'RecognizeExpression' => [ + 'methods' => ['post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'deprecated' => false, + 'operationType' => 'readAndWrite', 'systemTags' => [], 'parameters' => [ [ 'name' => 'ImageURL', 'in' => 'formData', - 'schema' => [ - 'description' => '图像URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。'."\n" - ."\n" - .'> **ImageURL**与**ImageData**二选一，当URL方式与Base64编码方式共存时，URL方式优先。文件的Base64编码处理操作，请参见[文件Base64处理](~~468191~~)。', - 'type' => 'string', - 'required' => false, - 'example' => 'https://viapi-test.oss-cn-shanghai.aliyuncs.com/test-team/xuhan/ExtractFingerPrint.png', - 'isFileTransferUrl' => true, - ], - ], - [ - 'name' => 'ImageData', - 'in' => 'formData', - 'schema' => [ - 'description' => '图像的Base64编码字符串。文件的Base64编码处理操作，请参见[文件Base64处理](~~468191~~)。'."\n" - ."\n" - .'> **ImageURL**与**ImageData**二选一，当URL方式与Base64编码方式共存时，URL方式优先。', - 'type' => 'string', - 'required' => false, - 'example' => 'iVBORw0KGgoAAAANSUhEUgAAASUAA****', - ], + 'schema' => ['description' => '图像URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。', 'type' => 'string', 'required' => true, 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/RecognizeExpression/RecognizeExpression7.jpg', 'isFileTransferUrl' => true], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'D21978CC-C1E7-4A7A-A1B2-D5896BDC7ADF', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'E1C4C576-1799-4079-A934-15BC406A54EF'], 'Data' => [ 'description' => '返回的结果数据内容。', 'type' => 'object', 'properties' => [ - 'FingerPrint' => [ - 'description' => '指纹提取结果图像的Base64编码字符串。', - 'type' => 'string', - 'example' => '/9j/4AAQSkZJRgABAQAAAQABAAD****', + 'Elements' => [ + 'description' => '各个子元素的识别结果。', + 'type' => 'array', + 'items' => [ + 'description' => '各个子元素的识别结果。', + 'type' => 'object', + 'properties' => [ + 'FaceRectangle' => [ + 'description' => '人脸区域信息。', + 'type' => 'object', + 'properties' => [ + 'Top' => ['description' => '以图像左上角为坐标原点，人脸区域左上角的y坐标。', 'type' => 'integer', 'format' => 'int32', 'example' => '67'], + 'Width' => ['description' => '人脸区域的宽度。', 'type' => 'integer', 'format' => 'int32', 'example' => '113'], + 'Height' => ['description' => '人脸区域的高度。', 'type' => 'integer', 'format' => 'int32', 'example' => '154'], + 'Left' => ['description' => '以图像左上角为坐标原点，人脸区域左上角的x坐标。', 'type' => 'integer', 'format' => 'int32', 'example' => '370'], + ], + ], + 'Expression' => ['description' => '表情类别。取值如下：'."\n" + ."\n" + .'- neutral：中性'."\n" + .'- happiness：高兴'."\n" + .'- surprise：惊讶'."\n" + .'- sadness：伤心'."\n" + .'- anger：生气'."\n" + .'- disgust：厌恶'."\n" + .'- fear：害怕'."\n" + .'- pouty：嘟嘴'."\n" + .'- grimace：做鬼脸', 'type' => 'string', 'example' => 'happiness'], + 'FaceProbability' => ['description' => '人脸的概率，取值范围为0~1。', 'type' => 'number', 'format' => 'float', 'example' => '0.88330078125'], + ], + ], ], ], ], ], + 'description' => '', ], ], ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'ParameterError', - 'errorMessage' => 'The parameter is invalid. Please check again.', - ], + ['errorCode' => 'ParameterError', 'errorMessage' => 'The parameter is invalid. Please check again.', 'description' => '参数错误，请检查参数值'], ], 403 => [ - [ - 'errorCode' => 'AuthFailed', - 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', - ], + ['errorCode' => 'AuthFailed', 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', 'description' => '授权失败，请检查RAM权限配置'], ], 408 => [ - [ - 'errorCode' => 'Timeout', - 'errorMessage' => 'The request has timed out.', - ], + ['errorCode' => 'Timeout', 'errorMessage' => 'The request has timed out.', 'description' => '请求超时，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'The service is unavailable.', - ], + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'The service is unavailable.', 'description' => '服务不可用，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"D21978CC-C1E7-4A7A-A1B2-D5896BDC7ADF\\",\\n \\"Data\\": {\\n \\"FingerPrint\\": \\"/9j/4AAQSkZJRgABAQAAAQABAAD****\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n D21978CC-C1E7-4A7A-A1B2-D5896BDC7ADF\\n \\n /9j/4AAQSkZJRgABAQAAAQABAAD****\\n \\n","errorExample":""}]', - 'title' => '指纹提取', + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"E1C4C576-1799-4079-A934-15BC406A54EF\\",\\n \\"Data\\": {\\n \\"Elements\\": [\\n {\\n \\"FaceRectangle\\": {\\n \\"Top\\": 67,\\n \\"Width\\": 113,\\n \\"Height\\": 154,\\n \\"Left\\": 370\\n },\\n \\"Expression\\": \\"happiness\\",\\n \\"FaceProbability\\": 0.88330078125\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n E1C4C576-1799-4079-A934-15BC406A54EF\\n \\n \\n \\n 67\\n 113\\n 154\\n 370\\n \\n happiness\\n 0.8833008\\n \\n \\n","errorExample":""}]', + 'title' => '表情识别', + 'summary' => '本文为您介绍表情识别RecognizeExpression的语法及示例。', 'description' => '## 功能描述'."\n" - .'指纹提取能力可以对输入的一张手指拍照图像自动定位其手指区域，并生成二值化黑白按压式指纹图像。'."\n" + .'表情识别能力可以检测和识别图片中人脸的表情。表情种类为：neutral（中性）、happiness（高兴）、surprise（惊讶）、sadness（伤心）、anger（生气）、disgust（厌恶）、fear（害怕）、pouty（嘟嘴）、grimace（鬼脸）。'."\n" + .'关于该接口功能的示例图如下：'."\n" + ."\n" + .'- 输入原图'."\n" + .'![](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20231206/ggvw/RecognizeExpression.jpeg" width="500)'."\n" + .'- 检测返回结果示意图'."\n" + .'![](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20231206/iddo/RecognizeExpression1.png" width="500)'."\n" ."\n" .'> - 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" - .'- 当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击[立即试用](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=ExtractFingerPrint)对该能力进行更直观试用以及在线购买。'."\n" + .'- 当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击[立即试用](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=RecognizeExpression)对该能力进行更直观试用以及在线购买。'."\n" .'- 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。'."\n" ."\n" .'## 应用场景'."\n" - .'线上信息采集：在云上办案过程中，上传当事人利用手机拍摄的自己的拇指图像，可通过指纹提取能力，生成一张按压式指纹图像，以此作为当事人的信息进行备案，让远程办案成为可能。'."\n" + .'- 面部识别场景：通过识别用户人脸面部表情，对面部的真实表情进行检测和控制。'."\n" + .'- 表情识别场景：通过表情识别技术，来确定被识别对象的心理情绪理解。'."\n" + .'- 互动娱乐场景：获取表情、情绪等人脸属性信息，实现特效相机等互动娱乐功能。'."\n" ."\n" .'## 特色优势'."\n" ."\n" - .'- 智能定位：通过深度学习算法，实现手指区域的智能定位，降低手机拍摄采集的难度。'."\n" - .'- 支持多角度拍摄：支持处理任意角度的手指图片，降低指纹采集难度。'."\n" - .'- 精准还原：精准还原手指指纹，纹理视觉效果和真实按压指纹无差异。'."\n" + .'- 支持识别多种表情：中性、高兴、惊讶、伤心、生气、厌恶、害怕、嘟嘴、鬼脸等9种情绪。'."\n" + .'- 简单易用：可直接调用的API接口，服务简单易用，易被集成，兼容性强。'."\n" + .'- 尊重客户隐私，图片上传24小时内删除，服务不留存客户图像。'."\n" ."\n" .'## 接入指引'."\n" .'1. 注册阿里云账号：打开[阿里云官网](https://www.aliyun.com)，在阿里云官网右上角，单击**立即注册**，按照操作提示完成账号注册。'."\n" - .'2. 开通能力：请确保您已开通[人脸人体服务](https://vision.aliyun.com/facebody)，若未开通服务请[立即开通](https://common-buy.aliyun.com/?commodityCode=viapi_facebody_public_cn#/open)。开通服务后请[提交申请](https://vision.console.aliyun.com/cn-shanghai/applyopen/facebody/ExtractFingerPrint)，申请通过后[购买QPS](https://common-buy.aliyun.com/?commodityCode=viapi_facebodyqps_public_cn#/buy)方可使用。'."\n" - ."\n" - .'>'."\n" - .'本能力仅限企业认证用户开通。更多实名认证操作信息，请参见[实名认证](https://help.aliyun.com/knowledge_list/37170.html)。'."\n" - .'>'."\n" - ."\n" + .'2. 开通能力：请确保您已开通[人脸人体服务](https://vision.aliyun.com/facebody)，若未开通服务请[立即开通](https://common-buy.aliyun.com/?commodityCode=viapi_facebody_public_cn#/open)。'."\n" + .'> 本能力支持企业或个人认证用户开通。更多实名认证操作信息，请参见[实名认证](https://help.aliyun.com/knowledge_list/37170.html)。'."\n" .'3. 创建AccessKey：请确保您已[创建AccessKey](~~175144~~)，如果您使用的是子账号AccessKey，您需要给子账号赋予AliyunVIAPIFullAccess权限，具体操作，请参见[RAM授权](~~145025~~)。'."\n" - .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/facebody/2019-12-30/ExtractFingerPrint?lang=JAVA&sdkStyle=old)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" + .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/facebody/2019-12-30/RecognizeExpression?lang=JAVA&sdkStyle=dara¶ms=%7B%22ImageURL%22%3A%22http%3A%2F%2Fviapi-test.oss-cn-shanghai.aliyuncs.com%2Fviapi-3.0domepic%2Ffacebody%2FRecognizeExpression%2FRecognizeExpression1.jpg%22%7D&tab=DEMO)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" .'5. 开发接入步骤：'."\n" .'- 在[SDK总览](~~145033~~)中选择您要接入使用的SDK语言。'."\n" .'- 在对应语言的SDK文档中找到AI类目为人脸人体（facebody）的SDK包进行安装。'."\n" @@ -7935,103 +6207,273 @@ .'- [小程序场景下直接调用](~~467780~~)'."\n" .'- [Android端直接调用](~~467781~~)'."\n" .'- [iOS端直接调用](~~467782~~)'."\n" - ."\n" + ."\n\n" .'## 输入限制'."\n" + .'- 图像格式：JPEG、JPG、BMP、PNG、TIF、WEBP。'."\n" + .'- 图像大小：不超过3 MB。'."\n" + .'- 图片分辨率：大于5×5像素，小于2048×2048像素，人脸占比不低于64×64像素。'."\n" + .'- URL地址中不能包含中文字符。'."\n" ."\n" - .'- 图像格式：JPG、JPEG、PNG。'."\n" - ."\n" - .'- 图像大小：不超过10 MB。'."\n" + .'> 当图像分辨率超过最大限制时，请先将图片进行缩放，调整图片大小，具体请参见[图片缩放](~~44688~~)。'."\n" ."\n" - .'- 图像分辨率：大于640×360像素，小于2560×1440像素。'."\n" + .'## 计费说明'."\n" + .'关于表情识别的计费方式及报价，请参见[计费介绍](~~184049~~)。'."\n" ."\n" - .'- 拍摄镜头尽量靠近手指，对角拍摄。'."\n" + .'> 下方调试接口为付费接口，如需免费体验调试请前往[体验中心](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=RecognizeExpression)。'."\n", + 'requestParamsDescription' => ' ', + 'responseParamsDescription' => '## SDK参考'."\n" + .'阿里云视觉AI人脸人体类目下的表情识别能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。', + 'extraInfo' => '## 错误码'."\n" + .'关于表情识别的错误码，详情请参见[常见错误码](~~146756~~)。'."\n" ."\n" - .'- URL地址中不能包含中文字符。'."\n" + .'## 开源模型体验'."\n" + .'更多开源免费模型体验及下载，详见魔搭社区：[人脸属性识别模型FairFace](https://modelscope.cn/models/damo/cv_resnet34_face-attribute-recognition_fairface/summary)、[人脸表情识别模型FER](https://modelscope.cn/models/damo/cv_vgg19_facial-expression-recognition_fer/summary)、[人脸质量模型FQA](https://modelscope.cn/models/damo/cv_manual_face-quality-assessment_fqa/summary)。'."\n" ."\n" - .'## 计费说明'."\n" - .'关于指纹提取的计费方式及报价，请参见[计费介绍](~~184049~~)。'."\n", - 'responseParamsDescription' => '## SDK参考'."\n" - .'阿里云视觉AI人脸人体类目下的指纹提取能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。', - 'extraInfo' => '## 错误码'."\n" - .'关于指纹提取的错误码，详情请参见[常见错误码](~~146756~~)。'."\n" .'## 安全声明'."\n" - ."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" - .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。', - ], - 'LiquifyFace' => [ - 'summary' => '本文介绍智能瘦脸LiquifyFace的语法及示例。', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'http', - 'https', + .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。'."\n" + .'- 平台不存储用户在使用服务过程中涉及的原始人脸图片或文件信息。', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-facebody:RecognizeExpression', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + ], + 'RecognizeFace' => [ + 'methods' => ['post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], + 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [], 'parameters' => [ [ 'name' => 'ImageURL', 'in' => 'formData', - 'schema' => [ - 'description' => '图像URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。'."\n" - .'图片格式要求：'."\n" - ."\n" - .'- 图像格式：JPG、JPEG、PNG。'."\n" - .'- 图像大小：不超过6 MB。'."\n" - .'- 图像分辨率：大于等于128×128像素，小于等于5000×5000像素，最长边小于等于5000像素。'."\n" - .'- 图像内容：至少包含1个人脸，最多不超过3个人脸，且人脸占比超过64x64像素。'."\n" - .'- URL地址中不能包含中文字符。'."\n" - .'> 图像内容：当图像分辨率超过最大限制时，请先将图片进行缩放，调整图片大小，具体请参见[图片缩放](~~44688~~)。', - 'type' => 'string', - 'required' => true, - 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/LiquifyFace/LiquifyFace1.png', - 'isFileTransferUrl' => true, - ], + 'schema' => ['description' => '图像URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。'."\n" + ."\n" + .'> - 推荐新版本调用方式为只输入图片，当只传入ImageURL的时候所有接口数据都会返回，新版本支持返回最多10张人脸的数据。'."\n" + ."\n" + .'- 兼容老版本接口对布尔值入参和MaxFaceNumber的支持逻辑，当传入任意一个支持的布尔值入参或MaxFaceNumber以控制返回的数据时，只会返回设置了布尔值入参且为true的数据，这种调用方式不返回布尔值入参支持范围外的数据（Landmarks，LandmarkCount，PoseList，Pupils）。', 'type' => 'string', 'required' => true, 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/RecognizeFace/RecognizeFace1.png', 'isFileTransferUrl' => true], ], [ - 'name' => 'SlimDegree', + 'name' => 'Age', 'in' => 'formData', - 'schema' => [ - 'description' => '标准力度。取值范围为\\[0,2.0]，默认为1.0。数值越大，瘦脸效果越明显。', - 'type' => 'number', - 'format' => 'float', - 'required' => false, - 'maximum' => '2', - 'minimum' => '0', - 'example' => '1.0', - 'default' => '1', - ], + 'schema' => ['description' => '兼容老版本接口，用来控制是否需要返回人脸年龄结果，取值true或false，默认false。', 'type' => 'boolean', 'required' => false, 'example' => 'false'], + ], + [ + 'name' => 'Gender', + 'in' => 'formData', + 'schema' => ['description' => '兼容老版本接口，用来控制是否需要返回人脸性别结果，取值true或false，默认false。', 'type' => 'boolean', 'required' => false, 'example' => 'false'], + ], + [ + 'name' => 'Hat', + 'in' => 'formData', + 'schema' => ['description' => '兼容老版本接口，用来控制是否需要返回人脸帽子结果，取值true或false，默认false。', 'type' => 'boolean', 'required' => false, 'example' => 'false'], + ], + [ + 'name' => 'Glass', + 'in' => 'formData', + 'schema' => ['description' => '兼容老版本接口，用来控制是否需要返回人脸眼镜结果，取值true或false，默认false。', 'type' => 'boolean', 'required' => false, 'example' => 'false'], + ], + [ + 'name' => 'Beauty', + 'in' => 'formData', + 'schema' => ['description' => '兼容老版本接口，用来控制是否需要返回人脸颜值结果，取值true或false，默认false。', 'type' => 'boolean', 'required' => false, 'example' => 'false'], + ], + [ + 'name' => 'Expression', + 'in' => 'formData', + 'schema' => ['description' => '兼容老版本接口，用来控制是否需要返回人脸表情结果，取值true或false，默认false。', 'type' => 'boolean', 'required' => false, 'example' => 'false'], + ], + [ + 'name' => 'Mask', + 'in' => 'formData', + 'schema' => ['description' => '兼容老版本接口，用来控制是否需要返回人脸口罩结果，取值true或false，默认false。', 'type' => 'boolean', 'required' => false, 'example' => 'false'], + ], + [ + 'name' => 'Quality', + 'in' => 'formData', + 'schema' => ['description' => '兼容老版本接口，用来控制是否需要返回人脸质量，取值true或false，默认false。', 'type' => 'boolean', 'required' => false, 'example' => 'false'], + ], + [ + 'name' => 'MaxFaceNumber', + 'in' => 'formData', + 'schema' => ['description' => '兼容老版本接口，用来设置图片中人脸的最大返回数量，取值范围1~10，默认为1。若想返回多个人脸检测结果，请正确设置。默认按返回参数FaceProbabilityList进行降序排列。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '1'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response', + 'description' => '1', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'CA1C8937-B30C-15E6-B804-41C357BA413B', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '8251C88E-8273-4DBF-94FB-A6BCB268CEA2'], 'Data' => [ - 'description' => '返回的数据内容。', + 'description' => '返回的结果数据内容。', 'type' => 'object', 'properties' => [ - 'ImageURL' => [ - 'description' => '瘦脸后图像的URL地址。'."\n" - .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。', - 'type' => 'string', - 'example' => 'http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/face-liquify/CA1C8937-B30C-15E6-B804-41C357BA413B_5eca_20210923-093411.jpg?Expires=1632391451&OSSAccessKeyId=LTAI****************&Signature=46apJQVNBz%2FFzDLEYn2M1w9MKA****', + 'Pupils' => [ + 'description' => '1', + 'type' => 'array', + 'items' => ['description' => '左右两个瞳孔的中心点坐标和半径，每个人脸6个浮点数，顺序为`[left_iris_cenpt.x, left_iris_cenpt.y, left_iris_radius, right_iris_cenpt.x, right_iris_cenpt.y, right_iris_radis]`。', 'type' => 'number', 'format' => 'float', 'example' => '[397.06,183.99,7.87,487.49,173.85,7.87]'], + ], + 'GenderList' => [ + 'description' => '1', + 'type' => 'array', + 'items' => ['description' => '识别到的人脸性别。如有多个人脸，则依次返回。'."\n" + ."\n" + .'- 0：女性'."\n" + ."\n" + .'- 1：男性'."\n" + ."\n", 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + ], + 'Expressions' => [ + 'description' => '1', + 'type' => 'array', + 'items' => ['description' => '人脸识别的表情结果。包括：'."\n" + ."\n" + .'- 0：中性'."\n" + ."\n" + .'- 1：微笑', 'type' => 'integer', 'format' => 'int32', 'example' => '0'], + ], + 'DenseFeatures' => [ + 'description' => '1', + 'type' => 'array', + 'items' => ['description' => '人脸识别返回的特征。如有多个人脸，则依次返回。'."\n" + ."\n" + .'> 由于版本升级，该字段废弃，返回数据无实际意义。', 'type' => 'string', 'example' => '[-0.04283177852630615, 0.01496131718158722, 0.08304227143526077, -0.006072732154279947, -0.012721054255962372, -0.024241730570793152, -0.03138406202197075, 0.006191537249833345, 0.017898650839924812, -0.03185232728719711, -0.02717948891222477, 0.028409384191036224, -0.03557640686631203, -0.02255111373960972, -0.030578967183828354, 0.011586467735469341, -0.005520580802112818, -0.0061850580386817455, -0.023915085941553116, 0.014204374514520168]'], + ], + 'FaceCount' => ['description' => '检测出来的人脸个数。', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'Landmarks' => [ + 'description' => '1', + 'type' => 'array', + 'items' => ['description' => '人脸的特征点定位结果，每个人脸返回一组特征点位置，表示方式为`（x0, y0, x1, y1, ……）`。如有多个人脸，则依次返回，返回定位浮点数。', 'type' => 'number', 'format' => 'float', 'example' => '[371.31,170.54,421.14,162.72,395.33,156.36,396.06,167.71,377.92,164.47,386.19,158.26,404.89,156.61,413.89,157.87,378.82,171,387.24,168.73,404.84,167.34,413.57,167.26,458.27,159.5,521.24,165.59,490.58,......]'], + ], + 'LandmarkCount' => ['description' => '人脸检测的特征点数目，目前固定为105点。依次为：眉毛24点，眼睛32点，鼻子6点，嘴巴34点，外轮廓9点。', 'type' => 'integer', 'format' => 'int32', 'example' => '105'], + 'Qualities' => [ + 'description' => '人脸质量情况，分数越高表示越有利于识别。', + 'type' => 'object', + 'properties' => [ + 'ScoreList' => [ + 'description' => '1', + 'type' => 'array', + 'items' => ['description' => '质量综合分数，分数越高越有利于识别，取值范围\\(0,100]。如有多张人脸，则依次返回。在识别时，推荐设置阈值大于等于85（您可以按实际应用场景判断设置阈值与否及相应阈值大小），大于85代表图片综合质量越高，小于85代表图片综合质量越低。'."\n", 'type' => 'number', 'format' => 'float', 'example' => '87.47'], + ], + 'BlurList' => [ + 'description' => '1', + 'type' => 'array', + 'items' => ['description' => '人脸模糊度对识别的影响分数，分数越高越有利于识别，取值范围\\(0,100]。如有多个人脸，则依次顺延。在识别时，推荐设置阈值大于等于85（您可以按实际应用场景判断设置阈值与否及相应阈值大小），大于85代表图片模糊的概率越低，小于85代表图片模糊的概率越高。', 'type' => 'number', 'format' => 'float', 'example' => '99.99'], + ], + 'FnfList' => [ + 'description' => '1', + 'type' => 'array', + 'items' => ['description' => '目标是否为人脸及其对识别的影响分数，分数越高越有利于识别，取值范围\\(0,100]。如有多个人脸，则依次顺延。在识别时，推荐设置阈值大于等于85（您可以按实际应用场景判断设置阈值与否及相应阈值大小），大于85代表图片是人脸的概率越高，小于85代表图片不是人脸的概率越低。', 'type' => 'number', 'format' => 'float', 'example' => '100'], + ], + 'GlassList' => [ + 'description' => '1', + 'type' => 'array', + 'items' => ['description' => '眼镜等上半脸遮挡对识别的影响分数，分数越高越有利于识别，取值范围\\(0,100]。如有多个人脸，则依次顺延。在识别时，推荐设置阈值大于等于85（您可以按实际应用场景判断设置阈值与否及相应阈值大小），大于85代表戴眼镜的概率越低，小于85代表戴眼镜的概率越高。', 'type' => 'number', 'format' => 'float', 'example' => '97.59'], + ], + 'IlluList' => [ + 'description' => '1', + 'type' => 'array', + 'items' => ['description' => '光照对识别的影响分数，分数越高越有利于识别，取值范围\\(0,100]。如有多个人脸，则依次顺延。在识别时，推荐设置阈值大于等于85（您可以按实际应用场景判断设置阈值与否及相应阈值大小），大于85代表图片光照好的概率越高，小于85代表图片光照好的概率越低。', 'type' => 'number', 'format' => 'float', 'example' => '99.97'], + ], + 'MaskList' => [ + 'description' => '1', + 'type' => 'array', + 'items' => ['description' => '口罩等下半脸遮挡对识别的影响分数，分数越高越有利于识别，取值范围\\(0,100]。如有多个人脸，则依次顺延。在识别时，推荐设置阈值大于等于85（您可以按实际应用场景判断设置阈值与否及相应阈值大小），大于85代表戴口罩概率越低，小于85代表戴口罩概率越高。', 'type' => 'number', 'format' => 'float', 'example' => '93.33'], + ], + 'NoiseList' => [ + 'description' => '1', + 'type' => 'array', + 'items' => ['description' => '图片噪声对识别的影响分数，分数越高越有利于识别，取值范围\\(0,100]。如有多个人脸，则依次顺延。在识别时，推荐设置阈值大于等于85（您可以按实际应用场景判断设置阈值与否及相应阈值大小），大于85代表图片有噪声的概率越低，小于85代表图片有噪声的概率越高。', 'type' => 'number', 'format' => 'float', 'example' => '99.73'], + ], + 'PoseList' => [ + 'description' => '1', + 'type' => 'array', + 'items' => ['description' => '姿态对识别的影响分数，分数越高越有利于识别，取值范围\\(0,100]。如有多个人脸，则依次顺延。在识别时，推荐设置阈值大于等于85（您可以按实际应用场景判断设置阈值与否及相应阈值大小），大于85代表人脸姿态正面的概率越高，小于85代表人脸姿态正面的概率越低。', 'type' => 'number', 'format' => 'float', 'example' => '11.57'], + ], + ], + ], + 'BeautyList' => [ + 'description' => '1', + 'type' => 'array', + 'items' => ['description' => '颜值分数，分值越高颜值越高，取值范围\\(0-100]。', 'type' => 'number', 'format' => 'float', 'example' => '48'], + ], + 'HatList' => [ + 'description' => '1', + 'type' => 'array', + 'items' => ['description' => '人脸是否佩戴帽子。'."\n" + ."\n" + .'- 0：无帽子'."\n" + ."\n" + .'- 1：有帽子', 'type' => 'integer', 'format' => 'int32', 'example' => '0'], + ], + 'FaceProbabilityList' => [ + 'description' => '1', + 'type' => 'array', + 'items' => ['description' => '返回人脸检测的概率，取值范围0~1。如有多个人脸，则依次返回。例如有两个人脸则返回`[face_prob1, face_prob2]`。', 'type' => 'number', 'format' => 'float', 'example' => '0.95'], + ], + 'Glasses' => [ + 'description' => '1', + 'type' => 'array', + 'items' => ['description' => '人脸是否佩戴眼镜。'."\n" + ."\n" + .'- 0：不戴眼镜'."\n" + ."\n" + .'- 1：佩戴普通眼镜'."\n" + ."\n" + .'- 2：佩戴墨镜', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + ], + 'FaceRectangles' => [ + 'description' => '1', + 'type' => 'array', + 'items' => ['description' => '返回人脸矩形框，分别是`[left, top, width, height]`。如有多个人脸，则依次顺延，返回矩形框。例如有两个人脸则返回`[left1, top1, width1, height1, left2, top2, width2, height2]`。'."\n" + .'left-top: 表示以图片左上角为坐标原点，目标框所对应的左上角点位置（x,y），表示框的第一个点距离图片左边界x像素，距离上边界y个像素。'."\n" + .'width-height：表示目标框的宽和高。'."\n" + .'目标框面积为width*height，目标框右下角坐标为（left+width,top+height）。', 'type' => 'integer', 'format' => 'int32', 'example' => '[356,84,211,278]'], + ], + 'PoseList' => [ + 'description' => '1', + 'type' => 'array', + 'items' => ['description' => '返回人脸姿态，格式为`[yaw, pitch, roll]`。如有多个人脸，则依次返回。'."\n" + ."\n" + .'- yaw为左右角度，取值范围-90~90。'."\n" + ."\n" + .'- pitch为上下角度，取值范围-90~90。'."\n" + ."\n" + .'- roll为平面旋转角度，取值范围-180~180。'."\n" + ."\n", 'type' => 'number', 'format' => 'float', 'example' => '[-12.7,7.48,0.12]'], + ], + 'AgeList' => [ + 'description' => '1', + 'type' => 'array', + 'items' => ['description' => '图片中人脸年龄，取值范围0~100。如有多个人脸，依次返回多个人脸的年龄。', 'type' => 'integer', 'format' => 'int32', 'example' => '57'], + ], + 'DenseFeatureLength' => ['description' => '人脸识别返回的特征维度，目前固定为1024。', 'type' => 'integer', 'format' => 'int32', 'example' => '1024'], + 'Masks' => [ + 'description' => '1', + 'type' => 'array', + 'items' => ['description' => '人脸是否佩戴口罩。'."\n" + ."\n" + .'- 0：未佩戴口罩'."\n" + .'- 1：佩戴口罩'."\n" + .'- 2：未正确佩戴口罩', 'type' => 'integer', 'format' => 'int64', 'example' => '0'], ], ], ], @@ -8041,69 +6483,46 @@ ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'ParameterError', - 'errorMessage' => 'The parameter is invalid. Please check again.', - ], + ['errorCode' => 'ParameterError', 'errorMessage' => 'The parameter is invalid. Please check again.', 'description' => '参数错误，请检查参数值'], ], 403 => [ - [ - 'errorCode' => 'AuthFailed', - 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', - ], + ['errorCode' => 'AuthFailed', 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', 'description' => '授权失败，请检查RAM权限配置'], ], 408 => [ - [ - 'errorCode' => 'Timeout', - 'errorMessage' => 'The request has timed out.', - ], + ['errorCode' => 'Timeout', 'errorMessage' => 'The request has timed out.', 'description' => '请求超时，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'The service is unavailable.', - ], + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'The service is unavailable.', 'description' => '服务不可用，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"CA1C8937-B30C-15E6-B804-41C357BA413B\\",\\n \\"Data\\": {\\n \\"ImageURL\\": \\"http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/face-liquify/CA1C8937-B30C-15E6-B804-41C357BA413B_5eca_20210923-093411.jpg?Expires=1632391451&OSSAccessKeyId=LTAI****************&Signature=46apJQVNBz%2FFzDLEYn2M1w9MKA****\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n CA1C8937-B30C-15E6-B804-41C357BA413B\\n \\n http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/face-liquify/CA1C8937-B30C-15E6-B804-41C357BA413B_5eca_20210923-093411.jpg?Expires=1632391451&OSSAccessKeyId=LTAI****************&Signature=46apJQVNBz%2FFzDLEYn2M1w9MKA****\\n \\n","errorExample":""}]', - 'title' => '智能瘦脸', + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"8251C88E-8273-4DBF-94FB-A6BCB268CEA2\\",\\n \\"Data\\": {\\n \\"Pupils\\": [\\n 0\\n ],\\n \\"GenderList\\": [\\n 1\\n ],\\n \\"Expressions\\": [\\n 0\\n ],\\n \\"DenseFeatures\\": [\\n \\"[-0.04283177852630615, 0.01496131718158722, 0.08304227143526077, -0.006072732154279947, -0.012721054255962372, -0.024241730570793152, -0.03138406202197075, 0.006191537249833345, 0.017898650839924812, -0.03185232728719711, -0.02717948891222477, 0.028409384191036224, -0.03557640686631203, -0.02255111373960972, -0.030578967183828354, 0.011586467735469341, -0.005520580802112818, -0.0061850580386817455, -0.023915085941553116, 0.014204374514520168]\\"\\n ],\\n \\"FaceCount\\": 1,\\n \\"Landmarks\\": [\\n 0\\n ],\\n \\"LandmarkCount\\": 105,\\n \\"Qualities\\": {\\n \\"ScoreList\\": [\\n 87.47\\n ],\\n \\"BlurList\\": [\\n 99.99\\n ],\\n \\"FnfList\\": [\\n 100\\n ],\\n \\"GlassList\\": [\\n 97.59\\n ],\\n \\"IlluList\\": [\\n 99.97\\n ],\\n \\"MaskList\\": [\\n 93.33\\n ],\\n \\"NoiseList\\": [\\n 99.73\\n ],\\n \\"PoseList\\": [\\n 11.57\\n ]\\n },\\n \\"BeautyList\\": [\\n 48\\n ],\\n \\"HatList\\": [\\n 0\\n ],\\n \\"FaceProbabilityList\\": [\\n 0.95\\n ],\\n \\"Glasses\\": [\\n 1\\n ],\\n \\"FaceRectangles\\": [\\n 0\\n ],\\n \\"PoseList\\": [\\n 0\\n ],\\n \\"AgeList\\": [\\n 57\\n ],\\n \\"DenseFeatureLength\\": 1024,\\n \\"Masks\\": [\\n 0\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n 8251C88E-8273-4DBF-94FB-A6BCB268CEA2\\n \\n 397.06\\n 183.99\\n 7.87\\n 487.49\\n 173.85\\n 7.87\\n 1\\n 0\\n [-0.04283177852630615, 0.01496131718158722, 0.08304227143526077, -0.006072732154279947, -0.012721054255962372, -0.024241730570793152, -0.03138406202197075, 0.006191537249833345, 0.017898650839924812, -0.03185232728719711, -0.02717948891222477, 0.028409384191036224, -0.03557640686631203, -0.02255111373960972, -0.030578967183828354, 0.011586467735469341, -0.005520580802112818, -0.0061850580386817455, -0.023915085941553116, 0.014204374514520168]\\n 1\\n 371.31\\n 170.54\\n 421.14\\n 162.72\\n 395.33\\n 156.36\\n 396.06\\n 167.71\\n 377.92\\n 164.47\\n 386.19\\n 158.26\\n 404.89\\n 156.61\\n 413.89\\n 157.87\\n 378.82\\n 171\\n 387.24\\n 168.73\\n 404.84\\n 167.34\\n 413.57\\n 167.26\\n 458.27\\n 159.5\\n 521.24\\n 165.59\\n 490.58\\n 150.77\\n 490.23\\n 162.28\\n 467.51\\n 153.1\\n 479.01\\n 151.32\\n 502.02\\n 153.2\\n 513.06\\n 159.78\\n 468\\n 163.52\\n 478.98\\n 162.32\\n 501.41\\n 163.93\\n 512.07\\n 166.6\\n 381.98\\n 187.97\\n 419.4\\n 184.68\\n 386.29\\n 184.05\\n 389.33\\n 180.31\\n 394.56\\n 178.97\\n 398.93\\n 176.7\\n 404.67\\n 178.01\\n 410.16\\n 178.29\\n 414.64\\n 181.61\\n 386.62\\n 188.63\\n 390.22\\n 189.61\\n 395.06\\n 189.65\\n 399.35\\n 189.78\\n 404.47\\n 188.86\\n 409.6\\n 187.94\\n 414.35\\n 186.47\\n 467.88\\n 180.89\\n 509.45\\n 179.81\\n 472.7\\n 177.13\\n 476.94\\n 173.17\\n 483.16\\n 172.02\\n 488.5\\n 170.41\\n 494.14\\n 172.17\\n 499.85\\n 173.15\\n 504.05\\n 176.58\\n 473.23\\n 182.31\\n 478.06\\n 183.11\\n 483.77\\n 183.5\\n 488.64\\n 183.77\\n 493.94\\n 183.26\\n 499.41\\n 182.57\\n 503.69\\n 181.14\\n 437.26\\n 181.67\\n 430.77\\n 225.48\\n 434.38\\n 203.34\\n 435.09\\n 245.37\\n 414.99\\n 243.56\\n 463.03\\n 241.47\\n 402.97\\n 282.43\\n 487.32\\n 279.44\\n 404.76\\n 282.21\\n 484.51\\n 279.63\\n 436.81\\n 269.19\\n 428.83\\n 269.46\\n 444.9\\n 269.87\\n 414.07\\n 273.42\\n 466.73\\n 272.4\\n 407.94\\n 277.81\\n 421.38\\n 271.38\\n 455.7\\n 271\\n 477.47\\n 276.08\\n 437.71\\n 290.09\\n 417.1\\n 288.03\\n 464.19\\n 286.36\\n 409.84\\n 284.75\\n 427.92\\n 288.61\\n 450.74\\n 287.81\\n 475.9\\n 282.68\\n 437.36\\n 278.04\\n 437.64\\n 277.63\\n 420.34\\n 278.65\\n 420.04\\n 278.69\\n 460.92\\n 277.64\\n 461.01\\n 277.22\\n 412.68\\n 280.41\\n 412.5\\n 279.99\\n 429.06\\n 278.19\\n 429.05\\n 277.65\\n 448.83\\n 277.82\\n 449.13\\n 276.93\\n 472.58\\n 278.55\\n 472.59\\n 278.16\\n 365.8\\n 192\\n 566.18\\n 185.68\\n 440.54\\n 352.94\\n 372.84\\n 289.96\\n 548.44\\n 300.96\\n 364.88\\n 240.03\\n 565.1\\n 243.91\\n 397.45\\n 334.16\\n 501.07\\n 340.61\\n 105\\n \\n 87.47\\n 99.99\\n 100\\n 97.59\\n 99.97\\n 93.33\\n 99.73\\n 11.57\\n \\n 48\\n 0\\n 0.95\\n 1\\n 356\\n 84\\n 211\\n 278\\n -12.7\\n 7.48\\n 0.12\\n 57\\n 1024\\n 0\\n \\n","errorExample":""}]', + 'title' => '人脸属性识别', + 'summary' => '检测人脸的性别、年龄、表情、眼镜、帽子五种属性，返回人脸的1024维深度学习特征。', 'description' => '## 功能描述'."\n" - .'智能瘦脸功能可实现输入一张人物图像，输出脸部五官调整瘦脸后的图像。'."\n" - .'关于该接口功能的示例图如下：'."\n" - .'- 输入原图'."\n" - .'![原始图像](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20221108/smvg/LiquifyFace.png" width="250)'."\n" - ."\n" - .'- 输出结果图'."\n" - .'![瘦脸效果](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20221108/ssiz/LiquifyFaceshoulian.jpg" width="250)'."\n" + .'人脸属性识别能力可以识别检测人脸的性别、年龄、表情、眼镜、帽子五种属性，支持人脸遮挡、光照、模糊度、姿态、噪声综合质量评分，支持检测含有多张人脸的照片属性判断。'."\n" ."\n" .'> - 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" - .'- 当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击[立即试用](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=LiquifyFace)对该能力进行更直观试用以及在线购买。'."\n" + .'- 当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击[立即试用](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=RecognizeFace)对该能力进行更直观试用以及在线购买。'."\n" .'- 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。'."\n" ."\n" - .'## 应用场景'."\n" - ."\n" - .'- 移动App：输入一张自拍照，通过智能瘦脸算法能力，生成更具魅力的面庞。'."\n" - .'- 写真自拍：对大量修图需求进行批量智能瘦脸，助力婚纱影楼或图像直播场景，降本提效。'."\n" - ."\n" .'## 特色优势'."\n" ."\n" - .'- 精准刻画：通过深度学习算法，精准分析人脸五官特征，实现完美自然的面部美型效果。'."\n" - .'- 支持多角度：正面侧面等多种角度的人脸均能智能判别和处理。'."\n" - .'- 支持多人脸：支持单人脸或多人脸的精准美型。'."\n" + .'- 适应能力强：不同照片、人脸尺寸多场景下，覆盖多个年龄段识别。'."\n" + .'- 图片质量打分：支持人脸遮挡、光照、模糊度、姿态、噪声综合质量评分。'."\n" + .'- 平台服务稳定：提供在高并发，大流量下的毫秒级识别响应和保障。'."\n" ."\n" .'## 接入指引'."\n" .'1. 注册阿里云账号：打开[阿里云官网](https://www.aliyun.com)，在阿里云官网右上角，单击**立即注册**，按照操作提示完成账号注册。'."\n" .'2. 开通能力：请确保您已开通[人脸人体服务](https://vision.aliyun.com/facebody)，若未开通服务请[立即开通](https://common-buy.aliyun.com/?commodityCode=viapi_facebody_public_cn#/open)。'."\n" .'> 本能力支持企业或个人认证用户开通。更多实名认证操作信息，请参见[实名认证](https://help.aliyun.com/knowledge_list/37170.html)。'."\n" .'3. 创建AccessKey：请确保您已[创建AccessKey](~~175144~~)，如果您使用的是子账号AccessKey，您需要给子账号赋予AliyunVIAPIFullAccess权限，具体操作，请参见[RAM授权](~~145025~~)。'."\n" - .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/facebody/2019-12-30/LiquifyFace?lang=JAVA&sdkStyle=dara¶ms=%7B%22ImageURL%22%3A%22http%3A%2F%2Fviapi-test.oss-cn-shanghai.aliyuncs.com%2Fviapi-3.0domepic%2Ffacebody%2FLiquifyFace%2FLiquifyFace1.png%22%7D&tab=DEMO)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" + .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/facebody/2019-12-30/RecognizeFace?lang=JAVA&sdkStyle=dara¶ms=%7B%22ImageURL%22%3A%22http%3A%2F%2Fviapi-test.oss-cn-shanghai.aliyuncs.com%2Fviapi-3.0domepic%2Ffacebody%2FRecognizeFace%2FRecognizeFace1.png%22%7D&tab=DEMO)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" .'5. 开发接入步骤：'."\n" .'- 在[SDK总览](~~145033~~)中选择您要接入使用的SDK语言。'."\n" .'- 在对应语言的SDK文档中找到AI类目为人脸人体（facebody）的SDK包进行安装。'."\n" .'- 参考文档中提供的示例代码进行适当修改后调用。'."\n" ."\n" - .'6. 示例代码：该能力常用语言的示例代码，请参见[智能瘦脸示例代码](~~2253469~~)。'."\n" - ."\n" + .'6. 示例代码：该能力常用语言的示例代码，请参见[人脸属性识别示例代码](~~465558~~)。'."\n" .'7. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" .'- [Web前端直接调用](~~467779~~)'."\n" .'- [小程序场景下直接调用](~~467780~~)'."\n" @@ -8111,202 +6530,160 @@ .'- [iOS端直接调用](~~467782~~)'."\n" ."\n" .'## 输入限制'."\n" - .'- 图像格式：JPG、JPEG、PNG。'."\n" - .'- 图像大小：不超过6 MB。'."\n" - .'- 图像分辨率：大于等于128×128像素，小于等于5000×5000像素，最长边小于等于5000像素。'."\n" - .'- 图像内容：至少包含1个人脸，最多不超过3个人脸，且人脸占比超过64x64像素。'."\n" + ."\n" + .'- 图像格式：JPEG、JPG、PNG、BMP。'."\n" + .'- 图像大小：不超过20 MB。'."\n" + .'- 图像分辨率：大于32×32像素，小于4096×4096像素，人脸占比不低于64×64像素。'."\n" .'- URL地址中不能包含中文字符。'."\n" ."\n" - .'>当图像分辨率超过最大限制时，请先将图片进行缩放，调整图片大小，具体请参见[图片缩放](~~44688~~)。 '."\n" + .'> 当图像分辨率超过最大限制时，请先将图片进行缩放，调整图片大小，具体请参见[图片缩放](~~44688~~)。'."\n" ."\n" .'## 计费说明'."\n" - .'关于智能瘦脸的计费方式及报价，请参见[计费介绍](~~184049~~)。', + .'关于人脸属性识别的计费方式及报价，请参见[计费介绍](~~184049~~)。'."\n" + .'> 下方调试接口为付费接口，如需免费体验调试请前往[体验中心](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=RecognizeFace)。', + 'requestParamsDescription' => ' ', 'responseParamsDescription' => '## SDK参考'."\n" - .'阿里云视觉AI人脸人体类目下的智能瘦脸能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。'."\n" + .'阿里云视觉AI人脸人体类目下的人脸属性识别能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。'."\n" ."\n" .'## 示例代码'."\n" - .'该能力常用语言的示例代码，请参见[智能瘦脸示例代码](~~2253469~~)。', + .'该能力常用语言的示例代码，请参见[人脸属性识别示例代码](~~465558~~)。', 'extraInfo' => '## 错误码'."\n" - .'关于智能瘦脸的错误码，详情请参见[常见错误码](~~146756~~)。'."\n" + .'关于人脸属性识别的错误码，详情请参见[常见错误码](~~146756~~)。'."\n" ."\n" .'## 开源模型体验'."\n" - .'更多开源免费模型体验及下载，详见魔搭社区：[106点人脸关键点-通用领域-2D](https://www.modelscope.cn/models/damo/cv_mobilenet_face-2d-keypoints_alignment/summary)。'."\n" + .'更多开源免费模型体验及下载，详见魔搭社区：[人脸属性识别模型FairFace](https://modelscope.cn/models/damo/cv_resnet34_face-attribute-recognition_fairface/summary)、[人脸表情识别模型FER](https://modelscope.cn/models/damo/cv_vgg19_facial-expression-recognition_fer/summary)、[人脸质量模型FQA](https://modelscope.cn/models/damo/cv_manual_face-quality-assessment_fqa/summary)。'."\n" ."\n" .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" - .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。', - ], - 'MonitorExamination' => [ - 'summary' => '本文介绍线上监考MonitorExamination的语法及示例。', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'http', - 'https', + .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。'."\n" + .'- 平台不存储用户在使用服务过程中涉及的原始人脸图片或文件信息。', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-facebody:RecognizeFace', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + ], + 'RecognizePublicFace' => [ + 'summary' => '本文介绍公众人物识别RecognizePublicFace的语法及示例。', + 'methods' => ['post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], + 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [], 'parameters' => [ [ - 'name' => 'Type', - 'in' => 'formData', - 'schema' => [ - 'title' => 'A short description of struct', - 'description' => '检测类型。'."\n" - ."\n" - .'- 0：屏幕聊天工具检测'."\n" - .'- 1：考生状态检测', - 'type' => 'integer', - 'format' => 'int64', - 'required' => true, - 'maximum' => '1', - 'minimum' => '0', - 'example' => '1', - ], - ], - [ - 'name' => 'ImageURL', + 'name' => 'Task', 'in' => 'formData', + 'style' => 'repeatList', 'schema' => [ - 'description' => '图像URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。', - 'type' => 'string', - 'required' => true, - 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/MonitorExamination/1MonitorExamination1.jpg', - 'isFileTransferUrl' => true, + 'description' => '1', + 'type' => 'array', + 'items' => [ + 'description' => '1', + 'type' => 'object', + 'properties' => [ + 'ImageURL' => ['description' => '待检测的图像URL地址。JSON数组中的每个元素是一个图片检测任务结构体（image表）。最多支持10个元素，即最多同时对10张图片进行检测。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。'."\n" + ."\n" + .'> 对于该接口，系统会自动将OSS链接地址转成内网地址然后再下载文件，所以调用该接口并不会产生OSS流量计费。', 'type' => 'string', 'required' => false, 'example' => 'https://viapi-oss.oss-cn-shanghai.aliyuncs.com/doc/facebody/xxx.jpg', 'isFileTransferUrl' => true], + 'ImageData' => ['description' => '图像Base64编码字符串。当与URL方式共存时，URL方式优先。'."\n" + .'文件的Base64编码处理操作，请参见[文件Base64处理](~~468191~~)。', 'type' => 'string', 'required' => false, 'example' => '/9j/4AAQSkZJRgABAQAAAQABAAD/2****9j/4AAQSkZJRgABAQAAAQABAAD/2****'], + ], + 'required' => false, + ], + 'required' => false, + 'maxItems' => 10, + 'minItems' => 1, ], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response', + 'description' => '1', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'D0F6EB94-73B6-4CB8-B266-22D2F221C475', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'AC4D107C-29E3-4873-A719-0D2217EA28A8'], 'Data' => [ 'description' => '返回的结果数据内容。', 'type' => 'object', 'properties' => [ - 'FaceInfo' => [ - 'description' => '中心人物的人脸信息。当请求参数Type取值为1时显示该参数。', - 'type' => 'object', - 'properties' => [ - 'Completeness' => [ - 'description' => '人脸完整度分数，取值范围\\(0,1)。', - 'type' => 'number', - 'format' => 'float', - 'example' => '1', - ], - 'FaceNumber' => [ - 'description' => '检测到的人脸人数，0代表未检测到考生人脸。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], - 'Pose' => [ - 'description' => '正对摄像机时3个角度都为0， 取值范围正负90度之间。', - 'type' => 'object', - 'properties' => [ - 'Pitch' => [ - 'description' => '上下俯仰角角度，抬头为正值，低头为负值。', - 'type' => 'number', - 'format' => 'float', - 'example' => '-0.9185499548912048', - ], - 'Roll' => [ - 'description' => '人脸在画面中顺时针转动为正值，逆时针转动为负值。', - 'type' => 'number', - 'format' => 'float', - 'example' => '-0.18541647493839264', - ], - 'Yaw' => [ - 'description' => '向左看为正值，向右看为负值。', - 'type' => 'number', - 'format' => 'float', - 'example' => '8.095342636108398', - ], - ], - ], - ], - ], - 'PersonInfo' => [ - 'description' => '中心人物的属性行为信息。当请求参数Type取值为1时显示该参数。', - 'type' => 'object', - 'properties' => [ - 'CellPhone' => [ - 'description' => '打电话。', - 'type' => 'object', - 'properties' => [ - 'Score' => [ - 'description' => '打电话的概率分数，取值范围\\(0,1)。', - 'type' => 'number', - 'format' => 'float', - 'example' => '0.39076218008995056', - ], - 'Threshold' => [ - 'description' => '建议阈值。'."\n" - ."\n" - .'> 仅作为参考，实际应用中根据测试情况选取合适的Score阈值即可。', - 'type' => 'number', - 'format' => 'float', - 'example' => '0.6', - ], - ], - ], - 'EarPhone' => [ - 'description' => '戴耳机。', - 'type' => 'object', - 'properties' => [ - 'Score' => [ - 'description' => '戴耳机的概率分数，取值范围\\(0,1)。', - 'type' => 'number', - 'format' => 'float', - 'example' => '0.7980290651321411', - ], - 'Threshold' => [ - 'description' => '建议阈值。'."\n" - ."\n" - .'> 仅作为参考，实际应用中根据测试情况选取合适的Score阈值即可。', - 'type' => 'number', - 'format' => 'float', - 'example' => '0.6', + 'Elements' => [ + 'description' => '返回识别的元素。', + 'type' => 'array', + 'items' => [ + 'description' => '1', + 'type' => 'object', + 'properties' => [ + 'ImageURL' => ['description' => '对应请求中的图像URL地址。', 'type' => 'string', 'example' => 'https://viapi-oss.oss-cn-shanghai.aliyuncs.com/doc/facebody/xxx.jpg'], + 'TaskId' => ['description' => '该检测任务的ID。', 'type' => 'string', 'example' => 'img3dhYqt1e4wO77Wnf2y@t@E-1tYAEt'], + 'Results' => [ + 'description' => '返回结果。调用成功时返回结果中包含一个或多个元素。', + 'type' => 'array', + 'items' => [ + 'description' => '1', + 'type' => 'object', + 'properties' => [ + 'Suggestion' => ['description' => '建议您执行的操作，取值包括：'."\n" + ."\n" + .'- pass：图片正常，无需进行其余操作。'."\n" + ."\n" + .'- review：检测结果不确定，需要进行人工审核。'."\n" + ."\n" + .'- block：图片违规，建议执行进一步操作（如直接删除或做限制处理）。', 'type' => 'string', 'example' => 'review'], + 'Label' => ['description' => '检测结果的分类，取值包括：'."\n" + ."\n" + .'- normal：正常图片，不包含敏感人脸。'."\n" + ."\n" + .'- sface：图片中包含敏感人脸。', 'type' => 'string', 'example' => 'sface'], + 'SubResults' => [ + 'description' => '识别出来的人脸信息列表。'."\n" + .'> 当图片中有多张人脸，默认只返回置信度最高的人脸信息。', + 'type' => 'array', + 'items' => [ + 'description' => '1', + 'type' => 'object', + 'properties' => [ + 'W' => ['description' => '人脸区域宽度。', 'type' => 'number', 'format' => 'float', 'example' => '132'], + 'Faces' => [ + 'description' => '识别出的人脸信息。', + 'type' => 'array', + 'items' => [ + 'description' => '1', + 'type' => 'object', + 'properties' => [ + 'Name' => ['description' => '识别出的相似人物名称。', 'type' => 'string', 'example' => '张三'], + 'Id' => ['description' => '人脸ID。', 'type' => 'string', 'example' => 'AliFace_0006272'], + 'Rate' => ['description' => '相似概率。', 'type' => 'number', 'format' => 'float', 'example' => '98.35'], + ], + ], + ], + 'H' => ['description' => '人脸区域高度。', 'type' => 'number', 'format' => 'float', 'example' => '153'], + 'Y' => ['description' => '以图片左上角为坐标原点，人脸区域左上角到y轴距离。', 'type' => 'number', 'format' => 'float', 'example' => '153'], + 'X' => ['description' => '以图片左上角为坐标原点，人脸区域左上角到x轴距离。', 'type' => 'number', 'format' => 'float', 'example' => '182'], + ], + ], + ], + 'Rate' => ['description' => '检测结果的置信度，取值范围为`[0.00,100.00]`。值越高，表示属于该分类的概率越大。', 'type' => 'number', 'format' => 'float', 'example' => '98.35'], + ], ], ], ], - 'PersonNumber' => [ - 'description' => '检测到的总人数，0代表未检测到考生。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], ], ], - 'ChatScore' => [ - 'description' => '屏幕截图包含聊天工具的概率，取值范围\\(0,1)。'."\n" - .'当请求参数Type取值为0时显示该参数。', - 'type' => 'number', - 'format' => 'float', - 'example' => '0.28805577754974365', - ], - 'Threshold' => [ - 'description' => '建议阈值，取值范围\\(0,1)。当ChatScore大于阈值时，系统判定输入屏幕截图中包含聊天工具。'."\n" - .'当请求参数Type取值为0时显示该参数。', - 'type' => 'number', - 'format' => 'float', - 'example' => '0.5', - ], ], ], ], @@ -8315,68 +6692,54 @@ ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'ParameterError', - 'errorMessage' => 'The parameter is invalid. Please check again.', - ], + ['errorCode' => 'ParameterError', 'errorMessage' => 'The parameter is invalid. Please check again.', 'description' => '参数错误，请检查参数值'], ], 403 => [ - [ - 'errorCode' => 'AuthFailed', - 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', - ], + ['errorCode' => 'AuthFailed', 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', 'description' => '授权失败，请检查RAM权限配置'], ], 408 => [ - [ - 'errorCode' => 'Timeout', - 'errorMessage' => 'The request has timed out.', - ], + ['errorCode' => 'Timeout', 'errorMessage' => 'The request has timed out.', 'description' => '请求超时，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'The service is unavailable.', - ], + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'The service is unavailable.', 'description' => '服务不可用，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"D0F6EB94-73B6-4CB8-B266-22D2F221C475\\",\\n \\"Data\\": {\\n \\"FaceInfo\\": {\\n \\"Completeness\\": 1,\\n \\"FaceNumber\\": 1,\\n \\"Pose\\": {\\n \\"Pitch\\": -0.9185499548912048,\\n \\"Roll\\": -0.18541647493839264,\\n \\"Yaw\\": 8.095342636108398\\n }\\n },\\n \\"PersonInfo\\": {\\n \\"CellPhone\\": {\\n \\"Score\\": 0.39076218008995056,\\n \\"Threshold\\": 0.6\\n },\\n \\"EarPhone\\": {\\n \\"Score\\": 0.7980290651321411,\\n \\"Threshold\\": 0.6\\n },\\n \\"PersonNumber\\": 1\\n },\\n \\"ChatScore\\": 0.28805577754974365,\\n \\"Threshold\\": 0.5\\n }\\n}","errorExample":""},{"type":"xml","example":"D0F6EB94-73B6-4CB8-B266-22D2F221C475\\n\\n \\n 1\\n 1\\n \\n -0.91854995\\n -0.18541647\\n 8.095343\\n \\n \\n \\n \\n 0.39076218\\n 0.6\\n \\n \\n 0.79802907\\n 0.6\\n \\n 1\\n \\n 0.28805578\\n 0.5\\n","errorExample":""}]', - 'title' => '线上监考', + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"AC4D107C-29E3-4873-A719-0D2217EA28A8\\",\\n \\"Data\\": {\\n \\"Elements\\": [\\n {\\n \\"ImageURL\\": \\"https://viapi-oss.oss-cn-shanghai.aliyuncs.com/doc/facebody/xxx.jpg\\",\\n \\"TaskId\\": \\"img3dhYqt1e4wO77Wnf2y@t@E-1tYAEt\\",\\n \\"Results\\": [\\n {\\n \\"Suggestion\\": \\"review\\",\\n \\"Label\\": \\"sface\\",\\n \\"SubResults\\": [\\n {\\n \\"W\\": 132,\\n \\"Faces\\": [\\n {\\n \\"Name\\": \\"张三\\",\\n \\"Id\\": \\"AliFace_0006272\\",\\n \\"Rate\\": 98.35\\n }\\n ],\\n \\"H\\": 153,\\n \\"Y\\": 153,\\n \\"X\\": 182\\n }\\n ],\\n \\"Rate\\": 98.35\\n }\\n ]\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n AC4D107C-29E3-4873-A719-0D2217EA28A8\\n \\n \\n https://viapi-oss.oss-cn-shanghai.aliyuncs.com/doc/facebody/xxx.jpg\\n img3dhYqt1e4wO77Wnf2y@t@E-1tYAEt\\n \\n review\\n \\n \\n 132\\n \\n 张三\\n AliFace_0006272\\n 98.35\\n \\n 153\\n 153\\n 182\\n \\n 98.35\\n \\n \\n \\n","errorExample":""}]', + 'title' => '公众人脸识别', 'description' => '## 功能描述'."\n" - .'在线监考能力可以对线上考试的考生行为进行识别，支持屏幕聊天工具检测和考生状态检测。'."\n" - ."\n" - .'- 屏幕聊天工具检测：输入截屏图像，判断是否出现常见的聊天工具。'."\n" - .'- 考生状态检测：利用考生的前置摄像机获取图像，判断出现的人脸人体个数、人脸角度朝向、是否戴耳机，是否使用手机。'."\n" + .'公众人物识别能力可以识别图片中的公众人物信息。'."\n" + .'公众人物是指在一定范围内具有重要影响力、拥有一定的社会地位、被大众广泛关注、且能因此从社会中得到巨大利益、与社会公共利益密切相关的人物，如领导人、科学家、企业家或社会活动家等。'."\n" ."\n" - .'> - 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" - .'- 当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击[立即试用](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=MonitorExamination)对该能力进行更直观试用以及在线购买。'."\n" + .'> - 在同时检测多个Task的情况下，将按照Task的个数进行累计计费。'."\n" + .'- 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" + .'- 当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击[立即试用](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=RecognizePublicFace)对该能力进行更直观试用以及在线购买。'."\n" .'- 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。'."\n" ."\n" .'## 应用场景'."\n" - .'- 个人远程在线考试。'."\n" - .'- 个人线下固定机位考试。'."\n" + .'- 用户内容审核：检查识别用户提交的图片和视频中是否存在公众人物，识别是否存在法律风险。'."\n" + .'- 视频图片检索：对公众人物有关的视频图片内容进行识别并设置标签，用户可以通过公众人物姓名等检索查找出与其有关的视频和图片。'."\n" ."\n" .'## 特色优势'."\n" - ."\n" - .'- 功能集成度高，一个接口可输出对当前考生的所有行为监测。'."\n" - .'- 针对常见聊天工具有单独的页面检测，可杜绝考生远程聊天作弊。'."\n" - .'- 可支持单机位（如PC），也可根据需求支持双机位算法（如手机架设）。'."\n" + .'能够准确识别出图像中的公众人物信息。'."\n" ."\n" .'## 接入指引'."\n" .'1. 注册阿里云账号：打开[阿里云官网](https://www.aliyun.com)，在阿里云官网右上角，单击**立即注册**，按照操作提示完成账号注册。'."\n" - .'2. 开通能力：请确保您已开通[人脸人体服务](https://vision.aliyun.com/facebody)，若未开通服务请[立即开通](https://common-buy.aliyun.com/?commodityCode=viapi_facebody_public_cn#/open)。'."\n" + .'2. 开通能力：'."\n" + .'- 请确保您已开通[人脸人体服务](https://vision.aliyun.com/facebody)，若未开通服务请[立即开通](https://common-buy.aliyun.com/?commodityCode=viapi_facebody_public_cn#/open)。'."\n" + .'- 开通服务后请[提交申请](https://vision.console.aliyun.com/cn-shanghai/applyopen/facebody/RecognizePublicFace)，申请通过后方可使用。'."\n" ."\n" .'>'."\n" - .'本能力支持企业或个人认证用户开通。更多实名认证操作信息，请参见[实名认证](https://help.aliyun.com/knowledge_list/37170.html)。'."\n" + .'本能力仅限企业认证用户开通。更多实名认证操作信息，请参见[实名认证](https://help.aliyun.com/knowledge_list/37170.html)。'."\n" .'>'."\n" ."\n" .'3. 创建AccessKey：请确保您已[创建AccessKey](~~175144~~)，如果您使用的是子账号AccessKey，您需要给子账号赋予AliyunVIAPIFullAccess权限，具体操作，请参见[RAM授权](~~145025~~)。'."\n" - .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/facebody/2019-12-30/MonitorExamination?lang=JAVA&sdkStyle=old¶ms=%7B%22ImageURL%22%3A%22http%3A%2F%2Fviapi-test.oss-cn-shanghai.aliyuncs.com%2Fviapi-3.0domepic%2Ffacebody%2FMonitorExamination%2F1MonitorExamination1.jpg%22%2C%22Type%22%3A1%7D&tab=DEMO)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" + .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/facebody/2019-12-30/RecognizePublicFace?lang=JAVA&sdkStyle=dara¶ms=%7B%22Task%22%3A%5B%7B%22ImageURL%22%3A%22%22%7D%5D%7D&tab=DEMO)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" .'5. 开发接入步骤：'."\n" .'- 在[SDK总览](~~145033~~)中选择您要接入使用的SDK语言。'."\n" .'- 在对应语言的SDK文档中找到AI类目为人脸人体（facebody）的SDK包进行安装。'."\n" .'- 参考文档中提供的示例代码进行适当修改后调用。'."\n" ."\n" - .'6. 示例代码：该能力常用语言的示例代码，请参见[线上监考示例代码](~~2249024~~)。'."\n" + .'6. 示例代码：该能力常用语言的示例代码，请参见[公众人物识别示例代码](~~478122~~)。'."\n" ."\n" .'7. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" .'- [Web前端直接调用](~~467779~~)'."\n" @@ -8385,38 +6748,59 @@ .'- [iOS端直接调用](~~467782~~)'."\n" ."\n" .'## 输入限制'."\n" - ."\n" - .'- 图像格式：JPG、PNG。'."\n" - .'- 图像大小：小于5 MB。'."\n" - .'- 图像分辨率：建议大于480×640像素，小于720×1280像素。'."\n" + .'- 图像格式：PNG、JPG、JPEG、BMP、GIF、WEBP。'."\n" + .'- 图像大小：不超过10 MB。'."\n" + .'- 图像分辨率：建议不低于256×256像素，像素过低可能会影响识别效果。'."\n" .'- URL地址中不能包含中文字符。'."\n" ."\n" .'> 当图像分辨率超过最大限制时，请先将图片进行缩放，调整图片大小，具体请参见[图片缩放](~~44688~~)。'."\n" ."\n" + .'## 检测说明'."\n" + .'- 最长检测时间是6秒，如果在该时间限制内没有完成检测，系统会返回超时错误码。'."\n" + .'- 图像下载时间限制为3秒，如果下载时间超过3秒，系统返回下载超时。'."\n" + .'- 图像检测接口响应时间依赖图片的下载时间。请保证被检测图像所在的存储服务稳定可靠，建议您使用阿里云OSS存储或者CDN缓存。'."\n" + .'- 最多可检测10张图像。'."\n" + ."\n" .'## 计费说明'."\n" - .'关于线上监考的计费方式及报价，请参见[计费介绍](~~184049~~)。'."\n" - .'> 下方调试接口为付费接口，如需免费体验调试请前往[体验中心](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=MonitorExamination)。', + .'关于公众人物识别的计费方式及报价，请参见[计费介绍](~~184049~~)。'."\n" + ."\n" + .'> 下方调试接口为付费接口，如需免费体验调试请前往[体验中心](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=RecognizePublicFace)。'."\n" + ."\n", + 'requestParamsDescription' => ' ', 'responseParamsDescription' => '## SDK参考'."\n" - .'阿里云视觉AI人脸人体类目下的线上监考能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。'."\n" + .'阿里云视觉AI人脸人体类目下的公众人物识别能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。'."\n" ."\n" .'## 示例代码'."\n" - .'该能力常用语言的示例代码，请参见[线上监考示例代码](~~2249024~~)。', + .'该能力常用语言的示例代码，请参见[公众人物识别示例代码](~~478122~~)。', 'extraInfo' => '## 错误码'."\n" - .'关于在线监考的错误码，详情请参见[常见错误码](~~146756~~)。'."\n" - .'## 安全声明'."\n" + .'关于公众人物识别的错误码，详情请参见[常见错误码](~~146756~~)。'."\n" ."\n" + .'## 开源模型体验'."\n" + .'更多开源免费模型体验及下载，详见魔搭社区：[人脸识别OOD模型](https://modelscope.cn/models/damo/cv_ir_face-recognition-ood_rts/summary)、[ArcFace人脸识别模型](https://modelscope.cn/models/damo/cv_ir50_face-recognition_arcface/summary)、[IR人脸识别模型FRIR](https://modelscope.cn/models/damo/cv_manual_face-recognition_frir/summary)、[口罩人脸识别模型FRFM-large](https://modelscope.cn/models/damo/cv_manual_face-recognition_frfm/summary)、[口罩人脸识别模型FaceMask](https://modelscope.cn/models/damo/cv_resnet_face-recognition_facemask/summary)。'."\n" + ."\n\n" + .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" - .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。', + .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。'."\n" + .'- 平台不存储用户在使用服务过程中涉及的原始人脸图片或文件信息。', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-facebody:RecognizePublicFace', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + ], ], 'RetouchSkin' => [ 'summary' => '本文介绍智能美肤RetouchSkin的语法及示例。', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'methods' => ['post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -8428,44 +6812,26 @@ [ 'name' => 'ImageURL', 'in' => 'formData', - 'schema' => [ - 'description' => '图像URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。'."\n" - .'图片格式要求：'."\n" - ."\n" - .'- 图像格式：JPEG、JPG、PNG。'."\n" - .'- 图像大小：不超过6 MB。'."\n" - .'- 图像分辨率：大于128×128像素，小于等于5000×5000像素，最长边小于等于5000像素。'."\n" - .'- 图像内容：包含1～10个人像，且皮肤占比明显的照片。'."\n" - .'- URL地址中不能包含中文字符。'."\n" - ."\n" - .'> 图像内容：当图像分辨率超过最大限制时，请先将图片进行缩放，调整图片大小，具体请参见[图片缩放](~~44688~~)。', - 'type' => 'string', - 'required' => true, - 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/RetouchSkin/RetouchSkin3.png', - 'isFileTransferUrl' => true, - ], + 'schema' => ['description' => '图像URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。'."\n" + .'图片格式要求：'."\n" + ."\n" + .'- 图像格式：JPEG、JPG、PNG。'."\n" + .'- 图像大小：不超过6 MB。'."\n" + .'- 图像分辨率：大于128×128像素，小于等于5000×5000像素，最长边小于等于5000像素。'."\n" + .'- 图像内容：包含1～10个人像，且皮肤占比明显的照片。'."\n" + .'- URL地址中不能包含中文字符。'."\n" + ."\n" + .'> 图像内容：当图像分辨率超过最大限制时，请先将图片进行缩放，调整图片大小，具体请参见[图片缩放](~~44688~~)。', 'type' => 'string', 'required' => true, 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/RetouchSkin/RetouchSkin3.png', 'isFileTransferUrl' => true], ], [ 'name' => 'RetouchDegree', 'in' => 'formData', - 'schema' => [ - 'description' => '磨皮力度。取值范围为\\[0,1.5]，默认为1.0。数值越大皮肤纹理越不明显。', - 'type' => 'number', - 'format' => 'float', - 'required' => false, - 'example' => '1.0', - ], + 'schema' => ['description' => '磨皮力度。取值范围为\\[0,1.5]，默认为1.0。数值越大皮肤纹理越不明显。', 'type' => 'number', 'format' => 'float', 'required' => false, 'example' => '1.0'], ], [ 'name' => 'WhiteningDegree', 'in' => 'formData', - 'schema' => [ - 'description' => '美白力度。取值范围为\\[0,1.5]，默认为1.0。数值越大皮肤越白。', - 'type' => 'number', - 'format' => 'float', - 'required' => false, - 'example' => '1.0', - ], + 'schema' => ['description' => '美白力度。取值范围为\\[0,1.5]，默认为1.0。数值越大皮肤越白。', 'type' => 'number', 'format' => 'float', 'required' => false, 'example' => '1.0'], ], ], 'responses' => [ @@ -8475,22 +6841,13 @@ 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'FD2BF3DF-3D98-1D5D-85BB-C8EC3A9FE347', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => 'FD2BF3DF-3D98-1D5D-85BB-C8EC3A9FE347'], 'Data' => [ 'description' => '返回的数据内容。', 'type' => 'object', 'properties' => [ - 'ImageURL' => [ - 'description' => '美肤后图像的URL地址。'."\n" - .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。', - 'type' => 'string', - 'example' => 'http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/skin-retouch/FD2BF3DF-3D98-1D5D-85BB-C8EC3A9FE347_3467_20210923-094238.jpg?Expires=1632391959&OSSAccessKeyId=LTAI****************&Signature=jXJcFTv3no7Gx%2BLuPvANhRSnc2****', - ], + 'ImageURL' => ['description' => '美肤后图像的URL地址。'."\n" + .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。', 'type' => 'string', 'example' => 'http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/skin-retouch/FD2BF3DF-3D98-1D5D-85BB-C8EC3A9FE347_3467_20210923-094238.jpg?Expires=1632391959&OSSAccessKeyId=LTAI****************&Signature=jXJcFTv3no7Gx%2BLuPvANhRSnc2****'], ], ], ], @@ -8499,28 +6856,16 @@ ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'ParameterError', - 'errorMessage' => 'The parameter is invalid. Please check again.', - ], + ['errorCode' => 'ParameterError', 'errorMessage' => 'The parameter is invalid. Please check again.', 'description' => '参数错误，请检查参数值'], ], 403 => [ - [ - 'errorCode' => 'AuthFailed', - 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', - ], + ['errorCode' => 'AuthFailed', 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', 'description' => '授权失败，请检查RAM权限配置'], ], 408 => [ - [ - 'errorCode' => 'Timeout', - 'errorMessage' => 'The request has timed out.', - ], + ['errorCode' => 'Timeout', 'errorMessage' => 'The request has timed out.', 'description' => '请求超时，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'The service is unavailable.', - ], + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'The service is unavailable.', 'description' => '服务不可用，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"FD2BF3DF-3D98-1D5D-85BB-C8EC3A9FE347\\",\\n \\"Data\\": {\\n \\"ImageURL\\": \\"http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/skin-retouch/FD2BF3DF-3D98-1D5D-85BB-C8EC3A9FE347_3467_20210923-094238.jpg?Expires=1632391959&OSSAccessKeyId=LTAI****************&Signature=jXJcFTv3no7Gx%2BLuPvANhRSnc2****\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n FD2BF3DF-3D98-1D5D-85BB-C8EC3A9FE347\\n \\n http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/skin-retouch/FD2BF3DF-3D98-1D5D-85BB-C8EC3A9FE347_3467_20210923-094238.jpg?Expires=1632391959&OSSAccessKeyId=LTAI****************&Signature=jXJcFTv3no7Gx%2BLuPvANhRSnc2****\\n \\n","errorExample":""}]', @@ -8594,175 +6939,116 @@ .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。', - ], - 'CompareFaceWithMask' => [ - 'summary' => '本文介绍口罩人脸比对1:1CompareFaceWithMask的语法及示例。', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'http', - 'https', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-facebody:RetouchSkin', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + ], + 'SearchFace' => [ + 'summary' => '本文介绍人脸搜索SearchFace的语法及示例。', + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], + 'operationType' => 'read', 'deprecated' => false, - 'systemTags' => [], + 'systemTags' => ['operationType' => 'get'], 'parameters' => [ [ - 'name' => 'ImageURLA', + 'name' => 'DbName', 'in' => 'formData', - 'schema' => [ - 'description' => '图像A的URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。', - 'type' => 'string', - 'required' => true, - 'example' => 'https://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/CompareFaceWithMask/CompareFaceWithMask-left1.jpeg', - 'isFileTransferUrl' => true, - ], + 'schema' => ['description' => '数据库名称。'."\n" + ."\n" + .'> **DbName**与**DbNames**二选一，如果同时配置了两个参数，**DbNames**优先级高于**DbName**。', 'type' => 'string', 'required' => false, 'example' => 'default'], ], [ - 'name' => 'ImageURLB', + 'name' => 'ImageUrl', 'in' => 'formData', - 'schema' => [ - 'description' => '图像B的URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。', - 'type' => 'string', - 'required' => true, - 'example' => 'https://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/CompareFaceWithMask/CompareFaceWithMask-right1.jpeg', - 'isFileTransferUrl' => true, - ], + 'schema' => ['description' => '图像URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。URL长度不超过1024个字符。', 'type' => 'string', 'required' => true, 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/SearchFace/SearchFace1.png', 'isFileTransferUrl' => true], + ], + [ + 'name' => 'Limit', + 'in' => 'formData', + 'schema' => ['description' => '单个人脸列表中搜索人脸结果数量限制，取值范围1~100。', 'type' => 'integer', 'format' => 'int32', 'required' => true, 'maximum' => '1000', 'minimum' => '0', 'example' => '2', 'pattern' => '^\\d+$'], + ], + [ + 'name' => 'DbNames', + 'in' => 'formData', + 'schema' => ['description' => '数据库名称列表，以英文逗号（,）分割，可以实现跨库查询，最大支持10个数据库。'."\n" + .'> **DbName**与**DbNames**二选一，如果同时配置了两个参数，**DbNames**优先级高于**DbName**。', 'type' => 'string', 'required' => false, 'example' => 'test1,test2,test3', 'maxLength' => 4096], ], [ 'name' => 'QualityScoreThreshold', 'in' => 'formData', - 'schema' => [ - 'description' => '质量分阈值，对人脸图片进行质量分析判断，若某张人脸质量分小于该阈值，则会在返回结果上增加MessageTips说明。', - 'type' => 'number', - 'format' => 'float', - 'required' => false, - 'example' => '97.0', - ], + 'schema' => ['description' => '质量分阈值。对人脸图片进行质量分析判断，得到的质量分小于该阈值则表示人脸图片质量不符合要求，比对失败。取值范围\\[0.0,100.0]。0.0或空则表示不做质量分判断逻辑。', 'type' => 'number', 'format' => 'float', 'required' => false, 'example' => '50.0'], + ], + [ + 'name' => 'MaxFaceNum', + 'in' => 'formData', + 'schema' => ['description' => '对输入图像中多少个人脸进行检索比对，控制人脸样本列表个数，取值范围1~10，默认为5。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '5'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response', + 'description' => '1', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'C6499918-E932-41B3-96F5-A18F50D262DD', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '4159e64a-0fe8-436c-a8de-ee531555db3c'], 'Data' => [ 'description' => '返回的结果数据内容。', 'type' => 'object', 'properties' => [ - 'Confidence' => [ - 'description' => '两张图片中的最大人脸属于同一个人的置信度，取值范围0~100。供参考的三个阈值是61，69，75分别对应千分之一，万分之一和十万分之一误识率。阈值设置越高，误识率越低，通过率也越低，对安全性要求越高的场合，可以设置更高的阈值。如果某张图片中没有人脸则报错误信息。', - 'type' => 'number', - 'format' => 'float', - 'example' => '88.025604248046875', - ], - 'IsMaskA' => [ - 'description' => '图片A中的人脸是否戴口罩。'."\n" - ."\n" - .'- 0：不戴口罩'."\n" - .'- 1：戴口罩', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], - 'IsMaskB' => [ - 'description' => '图片B中的人脸是否戴口罩。'."\n" - ."\n" - .'- 0：不戴口罩'."\n" - .'- 1：戴口罩', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '0', - ], - 'LandmarksAList' => [ - 'description' => '图片A人脸框所对应的人脸关键点坐标数组。', - 'type' => 'array', - 'items' => [ - 'description' => '图片A人脸框所对应的人脸关键点坐标，顺序分别为左眼水平坐标，左眼垂直坐标，右眼水平坐标，右眼垂直坐标，鼻尖水平坐标，鼻尖垂直坐标，左嘴角水平坐标，左嘴角垂直坐标，右嘴角水平坐标，右嘴角垂直坐标。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '[348,490,523,478,446,577,386,677,514,668]', - ], - ], - 'LandmarksBList' => [ - 'description' => '图片B人脸框所对应的人脸关键点坐标数组。', - 'type' => 'array', - 'items' => [ - 'description' => '图片B人脸框所对应的人脸关键点坐标，顺序分别为左眼水平坐标，左眼垂直坐标，右眼水平坐标，右眼垂直坐标，鼻尖水平坐标，鼻尖垂直坐标，左嘴角水平坐标，左嘴角垂直坐标，右嘴角水平坐标，右嘴角垂直坐标。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '[356,590,487,589,410,676,368,754,476,753]', - ], - ], - 'QualityScoreA' => [ - 'description' => '输入图像A的质量分。', - 'type' => 'number', - 'format' => 'float', - 'example' => '75.891258239746094', - ], - 'QualityScoreB' => [ - 'description' => '输入图像B的质量分。', - 'type' => 'number', - 'format' => 'float', - 'example' => '98.716880798339844', - ], - 'RectAList' => [ - 'description' => '图片A中最大人脸矩形框。', - 'type' => 'array', - 'items' => [ - 'description' => '图片A中最大人脸矩形框\\[left, top, width, height]，例如\\[238,310,388,492]。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '[238,310,388,492]', - ], - ], - 'RectBList' => [ - 'description' => '图片B中最大人脸矩形框。', - 'type' => 'array', - 'items' => [ - 'description' => '图片B中最大人脸矩形框\\[left, top, width, height]，例如\\[284,467,293,373]。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '[284,467,293,373]', - ], - ], - 'Thresholds' => [ - 'description' => '不同误识率下置信度结果数组。', + 'MatchList' => [ + 'description' => '匹配的结果列表，如果输入图像中多个人脸，则这里会返回多个数据。', 'type' => 'array', 'items' => [ - 'description' => '误识率在1/1000，1/10000，1/100000的情况下分别对应的置信度阈值。例如`[61.0,69.0,75.0]`，表示误识率为1/1000的情况下，置信度（Confidence）超过61%就可以认为是同一个人。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '[61, 69, 75]', + 'description' => '1', + 'type' => 'object', + 'properties' => [ + 'FaceItems' => [ + 'description' => '匹配的人脸数据列表。', + 'type' => 'array', + 'items' => [ + 'description' => '1', + 'type' => 'object', + 'properties' => [ + 'EntityId' => ['description' => '实体ID，用来标识用户的唯一性，如用户ID、员工ID等。每个实体可包含多张人脸图片。支持大小写字母、数字、下划线的组合，长度为1~64。', 'type' => 'string', 'example' => 'U1'], + 'FaceId' => ['description' => '人脸图片数据ID，需要全局唯一，不可重复。支持小写字母、数字和下划线的组合。长度为1~64。', 'type' => 'string', 'example' => '001'], + 'Score' => ['description' => '人脸的相似度，取值范围-1.0~1.0，取小数点后6位，数值越大相似度越高。建议的三个参考阈值为0.35，0.45和0.6，分别对应千分之一，万分之一和十万分之一的误识率。阈值设置越高，误识率越低，通过率也越低，对安全性要求越高的场合，可以设置越高的阈值。', 'type' => 'number', 'format' => 'float', 'example' => '0.892133'], + 'ExtraData' => ['description' => '自定义信息（字符串）。支持字母、数字、标点符号和汉字。不超过512个字符。', 'type' => 'string', 'example' => '王小二'], + 'DbName' => ['description' => '数据库名称。', 'type' => 'string', 'example' => 'default'], + 'Confidence' => ['description' => '转换后的置信度 ，取值范围0.0~100.0，数值越大相似度越高，建议的三个参考阈值为60.48，67.87和72.62，分别对应千分之一，万分之一和十万分之一的误识率，阈值设置越高，误识率越低，通过率也越低，对安全性要求越高的场合，可以设置越高的阈值。', 'type' => 'number', 'format' => 'float', 'example' => '36.820168'], + ], + ], + ], + 'Location' => [ + 'description' => '输入图像中的人脸坐标信息。', + 'type' => 'object', + 'properties' => [ + 'Width' => ['description' => '宽度，单位像素。', 'type' => 'integer', 'format' => 'int32', 'example' => '200'], + 'Height' => ['description' => '高度，单位像素。', 'type' => 'integer', 'format' => 'int32', 'example' => '200'], + 'Y' => ['description' => '左上角y坐标。', 'type' => 'integer', 'format' => 'int32', 'example' => '6'], + 'X' => ['description' => '左上角x坐标。', 'type' => 'integer', 'format' => 'int32', 'example' => '5'], + ], + ], + 'QualitieScore' => ['description' => '输入图像中的人脸质量分。', 'type' => 'number', 'format' => 'float', 'example' => '71.7349'], + ], ], ], - 'MessageTips' => [ - 'description' => '提示信息，纯文字描述，以下提示信息单独出现或是几条提示信息的组合。'."\n" - .'质量相关提示（某张人脸质量分小于请求参数质量分阈值时会出现）：'."\n" - ."\n" - .'- `imageA quality score less threshold`：图像A的质量分小于输入参数设置的阈值。'."\n" - .'- `imageB quality score less threshold`：图像B的质量分小于输入参数设置的阈值。'."\n" - ."\n" - .'人脸尺寸相关提示（检测到人脸且人脸宽或高小于50像素时会有该提示信息。出现该提示信息时，请尽可能输入像素数大于64x64的人脸，并请酌情参考返回的对比置信度Confidence值）：'."\n" - ."\n" - .'- `face in imageA is too small`：图像A中的人脸太小。'."\n" - .'- `face in imageB is too small`：图像B中的人脸太小。', - 'type' => 'string', - 'example' => 'imageB quality score less threshold', - ], ], ], ], @@ -8771,102 +7057,81 @@ ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'ParameterError', - 'errorMessage' => 'The parameter is invalid. Please check again.', - ], + ['errorCode' => 'ParameterError', 'errorMessage' => 'The parameter is invalid. Please check again.', 'description' => '参数错误，请检查参数值'], ], 403 => [ - [ - 'errorCode' => 'AuthFailed', - 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', - ], + ['errorCode' => 'AuthFailed', 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', 'description' => '授权失败，请检查RAM权限配置'], ], 408 => [ - [ - 'errorCode' => 'Timeout', - 'errorMessage' => 'The request has timed out.', - ], + ['errorCode' => 'Timeout', 'errorMessage' => 'The request has timed out.', 'description' => '请求超时，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'The service is unavailable.', - ], + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'The service is unavailable.', 'description' => '服务不可用，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"C6499918-E932-41B3-96F5-A18F50D262DD\\",\\n \\"Data\\": {\\n \\"Confidence\\": 88.02560424804688,\\n \\"IsMaskA\\": 1,\\n \\"IsMaskB\\": 0,\\n \\"LandmarksAList\\": [\\n 0\\n ],\\n \\"LandmarksBList\\": [\\n 0\\n ],\\n \\"QualityScoreA\\": 75.8912582397461,\\n \\"QualityScoreB\\": 98.71688079833984,\\n \\"RectAList\\": [\\n 0\\n ],\\n \\"RectBList\\": [\\n 0\\n ],\\n \\"Thresholds\\": [\\n 0\\n ],\\n \\"MessageTips\\": \\"imageB quality score less threshold\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n C6499918-E932-41B3-96F5-A18F50D262DD\\n \\n 88.025604\\n 1\\n 0\\n 348\\n 490\\n 523\\n 478\\n 446\\n 577\\n 386\\n 677\\n 514\\n 668\\n 356\\n 590\\n 487\\n 589\\n 410\\n 676\\n 368\\n 754\\n 476\\n 753\\n 75.89126\\n 98.71688\\n 238\\n 310\\n 388\\n 492\\n 284\\n 467\\n 293\\n 373\\n 61\\n 69\\n 75\\n imageB quality score less threshold\\n \\n","errorExample":""}]', - 'title' => '口罩人脸比对1:1', + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"4159e64a-0fe8-436c-a8de-ee531555db3c\\",\\n \\"Data\\": {\\n \\"MatchList\\": [\\n {\\n \\"FaceItems\\": [\\n {\\n \\"EntityId\\": \\"U1\\",\\n \\"FaceId\\": \\"001\\",\\n \\"Score\\": 0.892133,\\n \\"ExtraData\\": \\"王小二\\",\\n \\"DbName\\": \\"default\\",\\n \\"Confidence\\": 36.820168\\n }\\n ],\\n \\"Location\\": {\\n \\"Width\\": 200,\\n \\"Height\\": 200,\\n \\"Y\\": 6,\\n \\"X\\": 5\\n },\\n \\"QualitieScore\\": 71.7349\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n 4159e64a-0fe8-436c-a8de-ee531555db3c\\n \\n \\n \\n U1\\n 001\\n 0.892133\\n 王小二\\n default\\n 36.820168\\n \\n \\n 200\\n 200\\n 6\\n 5\\n \\n 71.7349\\n \\n \\n","errorExample":""}]', + 'title' => '搜索人脸', 'description' => '## 功能描述'."\n" - .'口罩人脸比对1:1能力基于您输入的两张图片，分别挑选两张图片中的最大人脸进行比较，判断是否为同一人。融合戴口罩生成、抗遮挡关键点定位、抗遮挡特征注意力三大技术优化，实现戴口罩时的极速人脸识别。'."\n" - ."\n" - .'- 两张人脸图片对比：比对两张图片中人脸的相似度，返回这两个人脸的矩形框坐标、人脸五点关键点坐标、比对的置信度，以及不同误识率的置信度阈值。'."\n" - .'- 支持多种图片类型：支持生活照、证件照等类型的人脸对比。'."\n" - .'- 支持佩戴口罩场景：针对佩戴口罩场景对带口罩的人脸进行对比识别。'."\n" - ."\n" - .'关于该接口功能的示意图如下：'."\n" - .' ![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20230206/cenz/CompareFaceWithMask.png" width="500)'."\n" + .'人脸搜索能力可以根据输入图片，在数据库中搜索并返回相似的人脸图片数据。单次搜索最多可支持10个人脸数据库的同时搜索（跨库搜索）。该能力根据人脸特征来进行识别，通过把人脸图像特征化，然后比较人脸特征的相似程度。'."\n" ."\n" .'> - 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" - .'- 当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击[立即试用](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=CompareFaceWithMask)对该能力进行更直观试用以及在线购买。'."\n" + .'- 当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击[立即试用](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=SearchFace)对该能力进行更直观试用以及在线购买。'."\n" .'- 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。'."\n" ."\n" - .'## 应用场景'."\n" - ."\n" - .'- 员工考勤：无接触式刷脸考勤，疫情防控场景下企业考勤首选，且能有效防止代打卡等作弊行为。'."\n" - .'- 公共服务：佩戴口罩客户直接刷脸办理业务，通过人脸比对识别身份信息，减少身份证查验、复印存档等环节，提高公共服务窗口办理业务的效率。'."\n" - .'- 外卖骑手人脸核验：戴口罩外卖骑手送餐业务人脸打卡和定期本身人脸核验，现场授权采集的戴口罩人脸照片，与本人认证照片进行1:1比对，确保外卖骑手身份真实性，提供不摘口罩人脸识别便捷体验。'."\n" - ."\n" .'## 特色优势'."\n" - .'- 平台服务稳定：提供在高并发，大流量下的毫秒级识别响应和保障。'."\n" - .'- 抗遮挡五官定位：支持戴口罩、大部分遮挡情况下，实现准确度自评估的鲁棒性关键点定位。'."\n" - .'- 抗遮挡特征建模：支持戴口罩、大部分遮挡情况下，实现基于注意力机制的鲁棒性特征建模。'."\n" - .'- 简单易用：可直接调用的 API 接口，服务简单易用，易被集成，兼容性强。'."\n" - .'- 佩戴口罩场景优化：针对佩戴口罩场景，优化戴口罩遮挡情境下的人脸比对。'."\n" + .'- 识别精度高：人脸检测识别等算法精度处于业内领先水平。'."\n" + .'- 识别效率高：毫秒级响应，支持实时识别。'."\n" ."\n" .'## 接入指引'."\n" .'1. 注册阿里云账号：打开[阿里云官网](https://www.aliyun.com)，在阿里云官网右上角，单击**立即注册**，按照操作提示完成账号注册。'."\n" .'2. 开通能力：请确保您已开通[人脸人体服务](https://vision.aliyun.com/facebody)，若未开通服务请[立即开通](https://common-buy.aliyun.com/?commodityCode=viapi_facebody_public_cn#/open)。'."\n" + ."\n" .'>'."\n" - .'本能力仅限企业认证用户开通。更多实名认证操作信息，请参见[实名认证](https://help.aliyun.com/knowledge_list/37170.html)。'."\n" + ."\n" + .'- 本能力支持企业或个人认证用户开通。更多实名认证操作信息，请参见[实名认证](https://help.aliyun.com/knowledge_list/37170.html)。'."\n" + .'- 如果您是已经在使用的老客户，需要使用海量人脸建库和搜索的能力，请通过钉钉群（23109592）联系我们。'."\n" + ."\n" .'>'."\n" ."\n" .'3. 创建AccessKey：请确保您已[创建AccessKey](~~175144~~)，如果您使用的是子账号AccessKey，您需要给子账号赋予AliyunVIAPIFullAccess权限，具体操作，请参见[RAM授权](~~145025~~)。'."\n" - .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/facebody/2019-12-30/CompareFaceWithMask?lang=JAVA)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" - .'5. 开发接入步骤：'."\n" + .'4. 前提条件：'."\n" + .'- 已通过[创建人脸数据库](~~159141~~)（CreateFaceDb）接口创建了数据库名称（DbName）。'."\n" + .'- 已通过[添加人脸样本](~~161144~~)（AddFaceEntity）接口创建了实体ID（EntityId）。'."\n" + .'- 已通过[添加人脸数据](~~159216~~)（AddFace）接口给数据库（DbName）下的实体ID（EntityId）添加了人脸图片。'."\n" + ."\n" + .'5. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/facebody/2019-12-30/SearchFace?lang=JAVA&sdkStyle=dara¶ms=%7B%7D&tab=DEMO)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" + .'6. 开发接入步骤：'."\n" .'- 在[SDK总览](~~145033~~)中选择您要接入使用的SDK语言。'."\n" .'- 在对应语言的SDK文档中找到AI类目为人脸人体（facebody）的SDK包进行安装。'."\n" .'- 参考文档中提供的示例代码进行适当修改后调用。'."\n" ."\n" - .'6. 示例代码：该能力常用语言的示例代码，请参见[口罩人脸比对1:1示例代码](~~601387~~)。'."\n" + .'7. 示例代码：该能力常用语言的示例代码，请参见[人脸搜索示例代码](~~478011~~)。'."\n" ."\n" - .'7. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" + .'8. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" .'- [Web前端直接调用](~~467779~~)'."\n" .'- [小程序场景下直接调用](~~467780~~)'."\n" .'- [Android端直接调用](~~467781~~)'."\n" .'- [iOS端直接调用](~~467782~~)'."\n" ."\n" .'## 输入限制'."\n" - .'- 图像格式：JPEG、JPG、PNG、BMP、WEBP。'."\n" - .'- 图像大小：不超过3 MB。'."\n" - .'- 图像分辨率：大于32×32像素，小于4096×4096像素，人脸占比不低于64×64像素。'."\n" + .'- 图像格式：JPG、JPEG、PNG。'."\n" + .'- 图像大小：不超过5 MB。'."\n" + .'- 图像分辨率：大于32×32像素，小于4096×4096像素。人脸占比不低于64×64像素。'."\n" .'- URL地址中不能包含中文字符。'."\n" - .'> 当图像分辨率超过最大限制时，请先将图片进行缩放，调整图片大小，具体请参见[图片缩放](~~44688~~)。'."\n" + .'- 支持图片中包含最多10个人脸，超过部分会被忽略。'."\n" + .'>当图像分辨率超过最大限制时，请先将图片进行缩放，调整图片大小，具体请参见[图片缩放](~~44688~~)。 '."\n" ."\n" .'## 计费说明'."\n" - .'关于口罩人脸比对1:1的计费方式及报价，请参见[计费介绍](~~184049~~)。'."\n" - .'> 下方调试接口为付费接口，如需免费体验调试请前往[体验中心](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=CompareFaceWithMask)。'."\n" - ."\n", + .'关于人脸搜索1:N的计费方式及报价，请参见[计费介绍](~~184049~~)。人脸搜索1:N能力中仅本接口（SearchFace）收费，其他接口可免费调用。'."\n" + .'> 下方调试接口为付费接口，如需免费体验调试请前往[体验中心](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=SearchFace)。', + 'requestParamsDescription' => ' ', 'responseParamsDescription' => '## SDK参考'."\n" - .'阿里云视觉AI人脸人体类目下的口罩人脸比对1:1能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。'."\n" + .'阿里云视觉AI人脸人体类目下的人脸搜索能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。'."\n" ."\n" .'## 示例代码'."\n" - .'该能力常用语言的示例代码，请参见[口罩人脸比对1:1示例代码](~~601387~~)。', + .'该能力常用语言的示例代码，请参见[人脸搜索示例代码](~~478011~~)。', 'extraInfo' => '## 错误码'."\n" - .'关于口罩人脸比对1:1的错误码，详情请参见[常见错误码](~~146756~~)。'."\n" + .'关于人脸搜索的错误码，详情请参见[常见错误码](~~146756~~)。'."\n" ."\n" .'## 开源模型体验'."\n" .'更多开源免费模型体验及下载，详见魔搭社区：[人脸识别OOD模型](https://modelscope.cn/models/damo/cv_ir_face-recognition-ood_rts/summary)、[ArcFace人脸识别模型](https://modelscope.cn/models/damo/cv_ir50_face-recognition_arcface/summary)、[IR人脸识别模型FRIR](https://modelscope.cn/models/damo/cv_manual_face-recognition_frir/summary)、[口罩人脸识别模型FRFM-large](https://modelscope.cn/models/damo/cv_manual_face-recognition_frfm/summary)、[口罩人脸识别模型FaceMask](https://modelscope.cn/models/damo/cv_resnet_face-recognition_facemask/summary)。'."\n" @@ -8874,593 +7139,794 @@ .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。'."\n" - .'- 平台不存储用户在使用服务过程中涉及的原始人脸图片或文件信息。', - ], - 'DetectInfraredLivingFace' => [ - 'summary' => '本文为您介绍红外人脸活体检测DetectInfraredLivingFace的语法及示例。', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'http', - 'https', + .'- 平台不存储用户在使用服务过程中涉及的原始人脸图片或文件信息。'."\n" + .'- 平台针对超过6个月及以上没有API服务调用的用户的人脸特征向量数据进行冻结，确保无服务调用的客户信息安全。如需解冻，请通过钉钉群（23109592）联系我们。', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'viapi-facebody:SearchFace', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + ], + 'UpdateFaceEntity' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], + 'operationType' => 'read', 'deprecated' => false, - 'systemTags' => [], + 'systemTags' => ['operationType' => 'update'], 'parameters' => [ [ - 'name' => 'Tasks', + 'name' => 'DbName', 'in' => 'formData', - 'style' => 'repeatList', - 'schema' => [ - 'description' => '待检测的图像URL地址数组。', - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'ImageURL' => [ - 'description' => '待检测的图像URL地址。JSON数组中的每个元素是一个图片检测任务结构体（image表）。最多支持10个元素，即同时最多对10张图片进行检测。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。'."\n" - ."\n" - .'> 对于该接口，系统会自动将OSS链接地址转成内网地址然后再下载文件，所以调用该接口并不会产生OSS流量计费。'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'https://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/DetectInfraredLivingFace/DetectInfraredLivingFace.jpeg', - 'isFileTransferUrl' => true, - ], - ], - 'required' => false, - ], - 'required' => true, - 'maxItems' => 10, - ], + 'schema' => ['description' => '数据库名称。', 'type' => 'string', 'required' => true, 'example' => 'default'], + ], + [ + 'name' => 'EntityId', + 'in' => 'formData', + 'schema' => ['description' => '实体ID，如用户ID、员工ID等。', 'type' => 'string', 'required' => true, 'example' => 'mm2'], + ], + [ + 'name' => 'Labels', + 'in' => 'formData', + 'schema' => ['description' => '自定义标签，最多可以添加10个标签。', 'type' => 'string', 'required' => false, 'example' => '视觉智能'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '68DF6EC7-3B1D-11EE-9FA7-1122F1AE92DD', - ], - 'Data' => [ - 'description' => '返回的结果数据内容。', - 'type' => 'object', - 'properties' => [ - 'Elements' => [ - 'description' => '返回的结果数据内容。', - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'FaceNumber' => [ - 'description' => '单张图片检测到的人脸数量。如果没有检测到人脸，FaceNumber返回为0。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], - 'ImageURL' => [ - 'description' => '对应请求中的图像URL地址。', - 'type' => 'string', - 'example' => 'http://viapi-demo.oss-cn-shanghai.aliyuncs.com/viapi-demo/images/SegmentCommonImage/segmentimage-src-hu.jpeg', - ], - 'Results' => [ - 'description' => '返回人脸坐标和活体结果。', - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'Label' => [ - 'description' => '检测结果的分类，取值包括：'."\n" - .'- normal：活体照片'."\n" - .'- liveness：翻拍照片'."\n" - ."\n" - .'如果没有检测到人脸，则Label返回为liveness。', - 'type' => 'string', - 'example' => 'liveness', - ], - 'Rate' => [ - 'description' => '结果为该分类的概率，取值范围为\\[0.00-100.00]。取值越大表示属于该分类的概率越大。'."\n" - .'如果未检测到人脸，则Rate返回为100。', - 'type' => 'number', - 'format' => 'float', - 'example' => '83.3848', - ], - 'Rect' => [ - 'description' => '人脸检测框信息。如果未检测到人脸，则Rect人脸检测坐标返回全为0。', - 'type' => 'object', - 'properties' => [ - 'Height' => [ - 'description' => '检测框高度。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '20', - ], - 'Width' => [ - 'description' => '检测框宽度。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '30', - ], - 'Top' => [ - 'description' => '检测框左上角的点y坐标。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '50', - ], - 'Left' => [ - 'description' => '检测框左上角的点x坐标。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '60', - ], - ], - ], - 'Suggestion' => [ - 'description' => '建议您执行的操作，取值范围如下：'."\n" - ."\n" - .'- pass：图片中的活体对象来自直接拍摄，无需进行其余操作。'."\n" - .'- review：图片中的活体对象可能为攻击样本，建议您确认后再进行操作。'."\n" - .'- block：图片中的活体对象大概率为攻击样本，建议您执行后续操作。'."\n" - ."\n" - .'如果未检测到人脸，则Suggestion返回为block。', - 'type' => 'string', - 'example' => 'review', - ], - 'MessageTips' => [ - 'description' => '提示信息，纯文字描述。'."\n" - ."\n" - .'- `blurred, occluded or large angle face, please check.`：如输入模糊、遮挡或大角度等的人脸。'."\n" - .'- `no face detected, try again please.`：如没有检测到人脸。', - 'type' => 'string', - 'example' => 'blurred, occluded or large angle face, please check.', - ], - ], - ], - ], - ], - ], - ], - ], - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'DA7CAFEB-0A37-4496-9CDF-E3DBB6309CB2'], ], + 'description' => '', ], ], ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'ParameterError', - 'errorMessage' => 'The parameter is invalid. Please check again.', - ], + ['errorCode' => 'ParameterError', 'errorMessage' => 'The parameter is invalid. Please check again.', 'description' => '参数错误，请检查参数值'], ], 403 => [ - [ - 'errorCode' => 'AuthFailed', - 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', - ], + ['errorCode' => 'AuthFailed', 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', 'description' => '授权失败，请检查RAM权限配置'], ], 408 => [ - [ - 'errorCode' => 'Timeout', - 'errorMessage' => 'The request has timed out.', - ], + ['errorCode' => 'Timeout', 'errorMessage' => 'The request has timed out.', 'description' => '请求超时，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'The service is unavailable.', - ], + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'The service is unavailable.', 'description' => '服务不可用，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"68DF6EC7-3B1D-11EE-9FA7-1122F1AE92DD\\",\\n \\"Data\\": {\\n \\"Elements\\": [\\n {\\n \\"FaceNumber\\": 1,\\n \\"ImageURL\\": \\"http://viapi-demo.oss-cn-shanghai.aliyuncs.com/viapi-demo/images/SegmentCommonImage/segmentimage-src-hu.jpeg\\",\\n \\"Results\\": [\\n {\\n \\"Label\\": \\"liveness\\",\\n \\"Rate\\": 83.3848,\\n \\"Rect\\": {\\n \\"Height\\": 20,\\n \\"Width\\": 30,\\n \\"Top\\": 50,\\n \\"Left\\": 60\\n },\\n \\"Suggestion\\": \\"review\\",\\n \\"MessageTips\\": \\"blurred, occluded or large angle face, please check.\\"\\n }\\n ]\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n 68DF6EC7-3B1D-11EE-9FA7-1122F1AE92DD\\n \\n \\n 1\\n http://viapi-demo.oss-cn-shanghai.aliyuncs.com/viapi-demo/images/SegmentCommonImage/segmentimage-src-hu.jpeg\\n \\n \\n 83.3848\\n \\n 20\\n 30\\n 50\\n 60\\n \\n review\\n blurred, occluded or large angle face, please check.\\n \\n \\n \\n","errorExample":""}]', - 'title' => '红外人脸活体检测', + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"DA7CAFEB-0A37-4496-9CDF-E3DBB6309CB2\\"\\n}","errorExample":""},{"type":"xml","example":"DA7CAFEB-0A37-4496-9CDF-E3DBB6309CB2","errorExample":""}]', + 'title' => '更新人脸样本', + 'summary' => '更更新人脸样本。', 'description' => '## 功能描述'."\n" - .'红外人脸活体检测能力可以检测红外图片中的人脸是否为来自认证设备端的近距离裸拍活体人脸对象，可广泛应用在红外设备人脸实时采集场景，满足红外人脸注册认证的真实性和安全性要求，判断的前置条件是红外图像中有人脸。'."\n" - .'从能力范围来看：'."\n" - .'1. 认证设备端是指借助近距离裸拍活体正面人脸用于认证、通行等服务场景的含红外摄像头的硬件设备，常见的认证设备端有门禁机、考勤机、PC等智能终端认证设备。'."\n" - .'2. 裸拍活体正面人脸是指真人未经重度PS、风格化、人工合成等后处理的含正面人脸（非模糊、遮挡、大角度的正面人脸）的裸红外照片。常见的非真人有纸张人脸、3D模型人脸等。'."\n" - ."\n" - .'关于该接口功能的示例图如下：'."\n" - .'- 真人'."\n" - .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20230202/dsjz/DetectInfraredLivingFacezhenren.png" width="400)'."\n" - .'- 纸张人脸'."\n" - .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20230202/gfgt/DetectInfraredLivingFacezhizhang.png" width="400)'."\n" + .'更新人脸样本能力用于更新人脸数据库中的人脸样本数据。'."\n" ."\n" .'> - 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" - .'- 当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击[立即试用](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=DetectInfraredLivingFace)对该能力进行更直观试用以及在线购买。'."\n" .'- 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。'."\n" ."\n" - .'## 应用场景'."\n" - .'- 系统人脸登录防攻击：通过检测上传的红外图像是否是真人实拍，而非攻击及PS等后处理照片，以防止攻击者登录系统带来安全风险。'."\n" - .'- 门禁门锁闸机刷脸通行：面向人脸注册和认证环节设备端实时的红外活体检测，实现注册与认证过程中的真人校验，防止非法分子盗用、伪造他人身份打卡通行。'."\n" - .'- 智慧酒店自助入住：在酒店前台自助办理入住场景中，运用红外活体检测技术实现无人监管场景下，住客非活体攻击（纸张人脸、电子屏人脸）的高效率拦截。'."\n" - ."\n" - .'## 特色优势'."\n" - .'- 高精度防伪：基于图片中人像目标的高维度特征（风格化、摩尔纹、成像畸形等），判断目标对象是否为活体，有效防止屏幕二次翻拍等作弊攻击，支持单张或多张判断逻辑。'."\n" - .'- 高灵敏拦截：支持红外摄像头设备的实时活体检测，可有效防止翻拍、头模、打印图片等样本攻击。'."\n" - .'- 使用范围广：对于门锁等可见光照不理想的场景，具有更佳的适用性。'."\n" - .'- 简单易用：可直接调用的 API 接口，服务简单易用，易被集成，兼容性强。'."\n" - ."\n" .'## 接入指引'."\n" .'1. 注册阿里云账号：打开[阿里云官网](https://www.aliyun.com)，在阿里云官网右上角，单击**立即注册**，按照操作提示完成账号注册。'."\n" .'2. 开通能力：请确保您已开通[人脸人体服务](https://vision.aliyun.com/facebody)，若未开通服务请[立即开通](https://common-buy.aliyun.com/?commodityCode=viapi_facebody_public_cn#/open)。'."\n" + ."\n" .'>'."\n" - .'本能力仅限企业认证用户开通。更多实名认证操作信息，请参见[实名认证](https://help.aliyun.com/knowledge_list/37170.html)。'."\n" + .'本能力支持企业或个人认证用户开通。更多实名认证操作信息，请参见[实名认证](https://help.aliyun.com/knowledge_list/37170.html)。'."\n" .'>'."\n" ."\n" .'3. 创建AccessKey：请确保您已[创建AccessKey](~~175144~~)，如果您使用的是子账号AccessKey，您需要给子账号赋予AliyunVIAPIFullAccess权限，具体操作，请参见[RAM授权](~~145025~~)。'."\n" - .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/facebody/2019-12-30/DetectInfraredLivingFace?lang=JAVA)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" + .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/facebody/2019-12-30/UpdateFaceEntity?lang=JAVA)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" .'5. 开发接入步骤：'."\n" .'- 在[SDK总览](~~145033~~)中选择您要接入使用的SDK语言。'."\n" .'- 在对应语言的SDK文档中找到AI类目为人脸人体（facebody）的SDK包进行安装。'."\n" .'- 参考文档中提供的示例代码进行适当修改后调用。'."\n" ."\n" - .'6. 示例代码：该能力常用语言的示例代码，请参见[红外人脸活体检测示例代码](~~601305~~)。'."\n" - ."\n" - .'7. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" + .'6. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" .'- [Web前端直接调用](~~467779~~)'."\n" .'- [小程序场景下直接调用](~~467780~~)'."\n" .'- [Android端直接调用](~~467781~~)'."\n" .'- [iOS端直接调用](~~467782~~)'."\n" ."\n" - .'## 输入限制'."\n" - .'- 图像格式：PNG、JPG、JPEG、BMP、GIF、WEBP。'."\n" - .'- 图像大小：不超过10 MB。'."\n" - .'- 图像分辨率：建议大于256×256，像素过低可能会影响识别效果。'."\n" - .'- URL地址中不能包含中文字符。'."\n" - .'> 当图像分辨率超过最大限制时，请先将图片进行缩放，调整图片大小，具体请参见[图片缩放](~~44688~~)。'."\n" - ."\n" - .'## 检测说明'."\n" - .'- 最长检测时间是5秒，如果在该时间内没有完成检测，系统会强制返回超时错误码。'."\n" - .'- 图像下载时间限制为3秒，如果下载时间超过3秒，系统会返回下载超时。'."\n" - .'- 图像检测接口响应时间依赖图像的下载时间。请保证被检测图像所在的存储服务稳定可靠，建议您使用阿里云OSS存储或者CDN缓存。'."\n" - .'- 最多可检测10张图像。'."\n" - .'- 目前平台提供的活体检测为静默活体，即基于图片进行检测，暂不支持摇头，张嘴、眨眼等动作的活体检测。'."\n" + .'## 限制说明'."\n" + .'更新人脸样本接口提交任务并发默认为2QPS。'."\n" ."\n" .'## 计费说明'."\n" - .'关于红外人脸活体检测的计费方式及报价，请参见[计费介绍](~~184049~~)。'."\n" - .'> 下方调试接口为付费接口，如需免费体验调试请前往[体验中心](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=DetectInfraredLivingFace)。'."\n", + .'更新人脸样本能力可免费调用。', + 'requestParamsDescription' => ' ', 'responseParamsDescription' => '## SDK参考'."\n" - .'阿里云视觉AI人脸人体类目下的红外人脸活体检测能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。'."\n" - ."\n" - .'## 示例代码'."\n" - .'该能力常用语言的示例代码，请参见[红外人脸活体检测示例代码](~~601305~~)。', - 'extraInfo' => '## 活体阈值参考'."\n" - .'关于图片活体检测的判断阈值选择，可参考以下列表数值信息：'."\n" - .'| Label | Rate阈值 | 攻击拦截率 | 活体通过率 | '."\n" - .'| ---- | ------------ | ---- | ------------ |'."\n" - .'|liveness |0.39 |98.18% |90.21% |'."\n" - .'|liveness |0.55 |98.54% |89.29% |'."\n" - .'|liveness |0.7 |98.94% |88.36% |'."\n" - .'|normal（推荐） |0.8（推荐） |99.11% |87.00% |'."\n" - .'|normal |0.95 |99.60% |80.03% |'."\n" - ."\n" - .'当Label是normal时，表示的是活体，Rate表示活体置信度，Rate取值范围是\\[80,100]。'."\n" - .'当Label是liveness时，表示的是非活体，Rate表示非活体置信度，Rate取值范围是\\[20,100]。'."\n" - .'关于以上数值的概念定义：'."\n" - .'- 攻击拦截率：如98%，代表100次作弊假体攻击，会有98次被API识破拒绝。'."\n" - .'- 活体通过率：如98%，代表100次真人请求，会有98次顺利通过活体验证。'."\n" - ."\n" - .'> 内部实验数据测算，仅供参考。'."\n" - ."\n" - .'## 错误码'."\n" - .'关于红外人脸活体检测的错误码，详情请参见[常见错误码](~~146756~~)。'."\n" - ."\n" - .'## 开源模型体验'."\n" - .'更多开源免费模型体验及下载，详见魔搭社区：[人脸活体检测模型-RGB](https://modelscope.cn/models/damo/cv_manual_face-liveness_flrgb/summary)、[人脸活体检测模型-IR](https://modelscope.cn/models/damo/cv_manual_face-liveness_flir/summary)、[静默人脸活体检测模型-炫彩](https://modelscope.cn/models/damo/cv_manual_face-liveness_flxc/summary)。'."\n" + .'阿里云视觉AI人脸人体类目下的更新人脸样本能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。', + 'extraInfo' => '## 错误码'."\n" + .'关于更新人脸样本的错误码。详情请参见[常见错误码](~~146756~~)。'."\n" ."\n" .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。'."\n" - .'- 平台不存储用户在使用服务过程中涉及的原始人脸图片或文件信息。', + .'- 平台不存储用户在使用服务过程中涉及的原始人脸图片或文件信息。'."\n" + .'- 平台针对超过6个月及以上没有API服务调用的用户的人脸特征向量数据进行冻结，确保无服务调用的客户信息安全。如需解冻，请通过钉钉群（23109592）联系我们。', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'viapi-facebody:UpdateFaceEntity', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + ], ], - 'DeepfakeFace' => [ - 'summary' => '本文介绍人脸人体（facebody）类目下的换脸鉴别DeepfakeFace的语法及示例。', - 'methods' => [ - 'post', + ], + 'endpoints' => [ + ['regionId' => 'cn-shanghai', 'regionName' => '华东2（上海）', 'areaId' => 'asiaPacific', 'areaName' => '亚太', 'public' => 'facebody.cn-shanghai.aliyuncs.com', 'endpoint' => 'facebody.cn-shanghai.aliyuncs.com', 'vpc' => 'facebody-vpc.cn-shanghai.aliyuncs.com'], + ], + 'errorCodes' => [ + ['code' => 'AuthFailed', 'message' => 'An error occurred while performing authorization. Please check your RAM configuration.', 'http_code' => 403, 'description' => '授权失败，请检查RAM权限配置'], + ['code' => 'ClientError.IllegalArgument', 'message' => 'The request parameter has an error.', 'http_code' => 400, 'description' => '请求参数错误，详情查看message信息'], + ['code' => 'Data.Exist', 'message' => 'The data already exists.', 'http_code' => 409, 'description' => '数据已经存在'], + ['code' => 'EntityNotExist.Role', 'message' => '没有Ram权限，请联系主账号给你添加AliyunVIAPIFullAccess权限，操作流程可参考https://help.aliyun.com/document_detail/145025.htm', 'http_code' => 403, 'description' => '没有Ram权限，请联系主账号给你添加AliyunVIAPIFullAccess权限，操作流程可参考https://help.aliyun.com/document_detail/145025.htm'], + ['code' => 'IllegalUrlParameter', 'message' => 'Url不合法，请检查url能否正常打开', 'http_code' => 400, 'description' => 'Url不合法，请检查url能否正常打开 - 非上海OSS图片链接请参考：https://help.aliyun.com/document\\_detail/155645.html '], + ['code' => 'InternalError', 'message' => 'An error occurred to the algorithm service.', 'http_code' => 500, 'description' => '算法服务报错，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。 '], + ['code' => 'InternalError.Algo', 'message' => 'An algorithm error occurred.', 'http_code' => 500, 'description' => '算法服务报错，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。 '], + ['code' => 'InternalError.Busy', 'message' => 'Server busy.', 'http_code' => 500, 'description' => '后台服务忙，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], + ['code' => 'InternalError.Decode', 'message' => 'Failed to decode the image.', 'http_code' => 500, 'description' => '图像解码失败，请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], + ['code' => 'InternalError.Env', 'message' => 'Failed to initilize the environment.', 'http_code' => 500, 'description' => '初始化环境失败，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], + ['code' => 'InternalError.Mapping', 'message' => 'An algorithm error occurred.', 'http_code' => 500, 'description' => '内部算法处理错误'], + ['code' => 'InternalError.Model', 'message' => 'Failed to load the model.', 'http_code' => 500, 'description' => '模型加载错误，请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], + ['code' => 'InternalError.Process', 'message' => 'An error occurred during inference.', 'http_code' => 500, 'description' => '推理过程异常，请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], + ['code' => 'InternalError.Remote', 'message' => 'The request processing has failed due to some unknown error.', 'http_code' => 500, 'description' => '远程服务不可用，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], + ['code' => 'InternalError.Server', 'message' => 'The request processing has failed due to some unknown error.', 'http_code' => 500, 'description' => '系统内部错误，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], + ['code' => 'InternalError.Timeout', 'message' => 'The request has timed out.', 'http_code' => 500, 'description' => '算法服务报错，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。 '], + ['code' => 'InternalServerError', 'message' => 'A server error occurred while processing your request.', 'http_code' => 500, 'description' => '系统内部错误，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], + ['code' => 'InvalidAccessKeyId.Inactive', 'message' => 'AccessKeyId非法，请检查AccessKeyId是否被禁用，或者AccessKeyId和AccessKeySecret是否填写正确。', 'http_code' => 400, 'description' => 'AccessKeyId非法，请检查AccessKeyId是否被禁用，或者AccessKeyId和AccessKeySecret是否填写正确。请参考文档：https://help.aliyun.com/document\\_detail/175144.html，进入控制台，将对应的AccessKey启用。 '], + ['code' => 'InvalidAccessKeyId.NotFound', 'message' => 'access key not found', 'http_code' => 404, 'description' => 'AccessKeyId未找到，请检查AccessKeyId和AccessKeySecret是否填写正确。请参考文档：https://help.aliyun.com/document\\_detail/175144.html，进入控制台，找到对应的AccessKeyId和AccessKeySecret。如果AccessKeySecret未保存，主账号可以通过查看Secret找回，子账号无法找回，可以新建一个AccessKey。 '], + ['code' => 'InvalidAccessKeySecret', 'message' => 'AccessKeyId或AccessKeySecret填写错误，请检查AccessKeyId和AccessKeySecret是否填写正确。', 'http_code' => 400, 'description' => 'AccessKeyId或AccessKeySecret填写错误，请检查AccessKeyId和AccessKeySecret是否填写正确。请参考文档：https://help.aliyun.com/document\\_detail/175144.html，进入控制台，找到对应的AccessKeyId和AccessKeySecret。如果AccessKeySecret未保存，主账号可以通过查看Secret找回，子账号无法找回，可以新建一个AccessKey。 '], + ['code' => 'InvalidAction.NotFound', 'message' => '能力未找到，请检查类目与能力是否匹配，检查访问域名与能力是否匹配，关于访问域名可参考：https://help.aliyun.com/document_detail/143103.htm。SDK接入请参考：https://help.aliyun.com/document_detail/145033.html，选择合适编程语言根据实例代码作相关修改进行接入。', 'http_code' => 400, 'description' => '能力未找到，请检查类目与能力是否匹配，检查访问域名与能力是否匹配，关于访问域名可参考：https://help.aliyun.com/document_detail/143103.htm。SDK接入请参考：https://help.aliyun.com/document_detail/145033.html，选择合适编程语言根据实例代码作相关修改进行接入。'], + ['code' => 'InvalidApi.ForbiddenInvoke', 'message' => '调用受限，请检查您调用的能力是否为受限能力，受限能力需要在控制台https://vision.console.aliyun.com/找到相应能力申请经过审批之后才能调用。如非上述情况，请检查账号是否欠费', 'http_code' => 400, 'description' => '调用受限，请检查您调用的能力是否为受限能力，受限能力需要在控制台https://vision.console.aliyun.com/找到相应能力申请经过审批之后才能调用。如非上述情况，请检查账号是否欠费'], + ['code' => 'InvalidApi.NotPurchase', 'message' => 'specified api is not purchase', 'http_code' => 403, 'description' => '产品未开通，请开通产品：https://common-buy.aliyun.com/?commodityCode=viapi\\_facebody\\_public\\_cn#/open '], + ['code' => 'InvalidApi.OutOfService', 'message' => '产品未开通，请开通产品：https://common-buy.aliyun.com/?commodityCode=viapi_facebody_public_cn#/open', 'http_code' => 400, 'description' => '产品未开通，请开通产品：https://common-buy.aliyun.com/?commodityCode=viapi_facebody_public_cn#/open'], + ['code' => 'InvalidDB.Status', 'message' => 'DB instance current status not support the operation.', 'http_code' => 400, 'description' => '数据库状态无效，已被冻结，如需解冻，请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], + ['code' => 'InvalidFile.Content', 'message' => 'The content format of the image or video is invalid.', 'http_code' => 400, 'description' => '请参考算法文档检查文件内容，更换包含符合算法要求的 '], + ['code' => 'InvalidFile.Decode', 'message' => 'Failed to decode the file.', 'http_code' => 400, 'description' => '请检查文件是否能够正常打开 '], + ['code' => 'InvalidFile.Download', 'message' => 'Failed to download the file.', 'http_code' => 400, 'description' => '文件无法下载，请检查链接是否可访问和本地网络情况 - 非上海OSS图片链接请参考：https://help.aliyun.com/document\\_detail/155645.html。请检查OSS链接是否过期等。 '], + ['code' => 'InvalidFile.Region', 'message' => 'The URL format of the file is invalid.', 'http_code' => 400, 'description' => '文件链接地域不对，非上海OSS图片链接请参考：https://help.aliyun.com/document\\_detail/155645.html '], + ['code' => 'InvalidFile.Resolution', 'message' => 'The resolution of the image or video is invalid.', 'http_code' => 400, 'description' => '文件分辨率超出限制，请检查文件分辨率和内容，修改文件分辨率后重试 '], + ['code' => 'InvalidFile.Type', 'message' => 'The file type of the image or video is invalid.', 'http_code' => 400, 'description' => '文件类型错误，请检查文件类型 - 请参考算法API文档，使用算法支持的文件类型。阿里云视觉智能开放平台能够读取文件并获取真实的文件类型，不是通过文件后缀名进行类型判断，只看文件后缀名是无效的，关于更多文件类型判断和处理信息可参考：https://help.aliyun.com/document_detail/470250.html'], + ['code' => 'InvalidFile.Unsafe', 'message' => 'Risky file URL.', 'http_code' => 400, 'description' => '不安全的文件链接，请确保上传的图片或文件来源符合相应的法律法规。'], + ['code' => 'InvalidFile.URL', 'message' => 'The URL format of the file is invalid.', 'http_code' => 400, 'description' => '文件无法下载，请检查链接是否可访问和本地网络情况 - 非上海OSS图片链接请参考：https://help.aliyun.com/document\\_detail/155645.html。请检查OSS链接是否过期等。 '], + ['code' => 'InvalidImage.Content', 'message' => '请参考算法文档检查图片内容，更换包含符合算法要求的', 'http_code' => 400, 'description' => '请参考算法文档检查图片内容，更换包含符合算法要求的'], + ['code' => 'InvalidImage.Decode', 'message' => 'The content format of the image or video is invalid.', 'http_code' => 400, 'description' => '请检查图片是否能够正常打开 '], + ['code' => 'InvalidImage.Download', 'message' => 'Failed to download the file.', 'http_code' => 400, 'description' => '图片无法下载，请检查链接是否可访问和本地网络情况 - 非上海OSS图片链接请参考：https://help.aliyun.com/document\\_detail/155645.html。URL中不支持空格和中文字符，如包含请通过urlEncode编码之后再传入。请检查OSS链接是否过期等。 '], + ['code' => 'InvalidImage.NotFound', 'message' => 'The image file is not found in the parameter.', 'http_code' => 404, 'description' => '参数中的图片文件不存在'], + ['code' => 'InvalidImage.NotFoundFace', 'message' => 'No face is detected in the specified image.', 'http_code' => 404, 'description' => '图像中没找到人脸，请检查您的图像中是否包含人脸或人脸太小 '], + ['code' => 'InvalidImage.Region', 'message' => 'The URL format of the file is invalid.', 'http_code' => 400, 'description' => '图片链接地域不对，非上海OSS图片链接请参考：https://help.aliyun.com/document\\_detail/155645.html '], + ['code' => 'InvalidImage.Resolution', 'message' => 'The resolution of the image or video is invalid.', 'http_code' => 400, 'description' => '文件分辨率超出限制，请检查文件分辨率和内容，修改文件分辨率后重试 '], + ['code' => 'InvalidImage.Timeout', 'message' => 'Failed to download the file due to timeout.', 'http_code' => 400, 'description' => '图片下载超时，请检查链接是否可访问和本地网络情况 - 非上海OSS图片链接请参考：https://help.aliyun.com/document\\_detail/155645.html。请检查OSS链接是否过期等。 '], + ['code' => 'InvalidImage.Type', 'message' => '图片类型错误，请检查图片类型 - 请参考算法API文档，使用算法支持的图片类型', 'http_code' => 400, 'description' => '图片类型错误，请检查图片类型 - 请参考算法API文档，使用算法支持的图片类型'], + ['code' => 'InvalidImage.Unsafe', 'message' => 'Risky file URL.', 'http_code' => 400, 'description' => 'URL不安全，请确保上传的图片或文件来源符合相应的法律法规。'], + ['code' => 'InvalidImage.UnsupportedMediaType', 'message' => 'Failed to decode the image.', 'http_code' => 415, 'description' => '输入的image解码失败，请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系'], + ['code' => 'InvalidImage.URL', 'message' => 'The URL format of the file is invalid.', 'http_code' => 400, 'description' => '图片链接非法，请检查图片链接是否可访问 - 非上海OSS图片链接请参考：https://help.aliyun.com/document\\_detail/155645.html。对于上海oss链接请使用标准的oss域名，目前暂不支持绑定cdn域名和自定义域名。 '], + ['code' => 'InvalidImage.URL', 'message' => 'The URL format of the file is invalid or URL access has failed.', 'http_code' => 400, 'description' => '图片链接非法，请检查图片链接是否可访问 - 非上海OSS图片链接请参考：https://help.aliyun.com/document\\_detail/155645.html。对于上海oss链接请使用标准的oss域名，目前暂不支持绑定cdn域名和自定义域名。 '], + ['code' => 'InvalidImageType', 'message' => 'Invalid image type.', 'http_code' => 400, 'description' => '无效的图片类型，请参考调用能力的文档输入文档中支持的图片类型。'], + ['code' => 'InvalidParameter', 'message' => 'The request parameter is invalid.', 'http_code' => 400, 'description' => '参数错误，请根据算法API文档和报错Message检查参数值。是否参数值前后多了空格或者其他特殊字符等。 '], + ['code' => 'InvalidParameter.BadRequest', 'message' => 'The request parameter or the data has an error.', 'http_code' => 400, 'description' => '参数错误，请根据算法API文档和报错Message检查参数值。是否参数值前后多了空格或者其他特殊字符等。 '], + ['code' => 'InvalidParameter.NotFound', 'message' => 'The requested data is not found.', 'http_code' => 400, 'description' => '参数错误，请根据算法API文档和报错Message检查参数值。是否参数值前后多了空格或者其他特殊字符等。 '], + ['code' => 'InvalidParameter.TooLarge', 'message' => 'The file size exceeds the limit.', 'http_code' => 400, 'description' => '参数错误，文件大小超出限制，请参考算法API文档调整文件大小 '], + ['code' => 'InvalidParameter.Type', 'message' => 'The data format of the request parameter is invalid.', 'http_code' => 400, 'description' => '参数错误，请根据算法API文档和报错Message检查参数值。是否参数值前后多了空格或者其他特殊字符等。 '], + ['code' => 'InvalidParamter.Type', 'message' => 'The data format of the request parameter is invalid.', 'http_code' => 400, 'description' => '请求参数的数据格式错误'], + ['code' => 'InvalidRamRole', 'message' => '没有Ram权限，请联系主账号给你添加AliyunVIAPIFullAccess权限，操作流程可参考https://help.aliyun.com/document_detail/145025.htm', 'http_code' => 400, 'description' => '没有Ram权限，请联系主账号给你添加AliyunVIAPIFullAccess权限，操作流程可参考https://help.aliyun.com/document_detail/145025.htm'], + ['code' => 'InvalidResult', 'message' => '参数错误，请参考文档检查参数值，检查文件内容。请检查是否图片内容不完整或者太模糊等。', 'http_code' => 400, 'description' => '参数错误，请参考文档检查参数值，检查文件内容。请检查是否图片内容不完整或者太模糊等。'], + ['code' => 'InvalidSide', 'message' => 'Specified parameter Side is not valid. 请参考文档填写正确的Side参数', 'http_code' => 400, 'description' => 'Specified parameter Side is not valid. 请参考文档填写正确的Side参数'], + ['code' => 'InvalidTimeStamp.Expired', 'message' => '时间戳过期，请更新时间戳', 'http_code' => 400, 'description' => '时间戳过期，请更新时间戳。可以参考https://help.aliyun.com/document\\_detail/144904.html文档计算请求签名。如果您的语言比较常用，推荐使用SDK进行调用，详情可参考：https://help.aliyun.com/document\\_detail/145033.html '], + ['code' => 'InvalidVersion', 'message' => 'Specified parameter Version is not valid', 'http_code' => 400, 'description' => '版本未找到，请检查SDK版本是否匹配，检查版本与类目和能力是否匹配，关于SDK版本可参考：https://help.aliyun.com/document_detail/145033.html'], + ['code' => 'MissingAccessKeyId', 'message' => 'AccessKeyId未填写，请检查AccessKeyId和AccessKeySecret是否填写正确。', 'http_code' => 400, 'description' => 'AccessKeyId未填写，请检查AccessKeyId和AccessKeySecret是否填写正确。请参考文档：https://help.aliyun.com/document\\_detail/175144.html，进入控制台，找到对应的AccessKeyId和AccessKeySecret。如果AccessKeySecret未保存，主账号可以通过查看Secret找回，子账号无法找回，可以新建一个AccessKey。 '], + ['code' => 'MissingFileURL', 'message' => 'FileURL is required for this operation.', 'http_code' => 400, 'description' => '缺少文件参数FileURL，该参数为文件URL地址，文件输入推荐使用华东2（上海）区域的OSS链接-非上海OSS文件链接请参考：'."\n" + .'https://help.aliyun.com/document_detail/155645.html'], + ['code' => 'MissingImageURL', 'message' => 'ImageURL is required for this operation.', 'http_code' => 400, 'description' => '缺少图像参数ImageURL，该参数为图片URL地址，文件输入推荐使用华东2（上海）区域的OSS链接-非上海OSS文件链接请参考：'."\n" + .'https://help.aliyun.com/document_detail/155645.html'], + ['code' => 'MissingLimit', 'message' => 'Limit is required for this operation', 'http_code' => 400, 'description' => '缺少Limit参数，该参数是接口必填参数。推荐使用对应类目的SDK进行调用：https://help.aliyun.com/document_detail/145033.html'], + ['code' => 'MissingParameter', 'message' => 'A required parameter is not specified.', 'http_code' => 400, 'description' => '参数缺失，请参考文档检查参数值'], + ['code' => 'MissingTasks', 'message' => 'Tasks is required for this operation.', 'http_code' => 400, 'description' => '缺少Tasks参数，该参数是接口必填参数。推荐使用对应类目的SDK进行调用：https://help.aliyun.com/document_detail/145033.html'], + ['code' => 'ParameterError', 'message' => 'The parameter is invalid. Please check again.', 'http_code' => 400, 'description' => '参数错误，请检查参数值'], + ['code' => 'QualityScoreNotMatched', 'message' => 'image quality score not matched with given score', 'http_code' => 400, 'description' => '质量分不符合要求。比如QualityScoreThreshold参数设置了50，但是图片的质量分不足50。'], + ['code' => 'QuotaExceeded.DbCount', 'message' => 'The number of database exceeds the limit.', 'http_code' => 400, 'description' => '数据库数量超出限制'], + ['code' => 'QuotaExceeded.FaceGroupCount', 'message' => 'The number of database exceeds the limit.', 'http_code' => 400, 'description' => '数据库数量超出限制'], + ['code' => 'QuotaExceeded.FaceImageCount', 'message' => 'The number of image or trace exceeds the limit.', 'http_code' => 400, 'description' => '人脸、Trace数量超出限制。请根据文档中的限制检查，每个人脸样本最多可以添加5张人脸照片不支持扩容。'], + ['code' => 'QuotaExceeded.ImageCount', 'message' => 'The number of image or trace exceeds the limit.', 'http_code' => 400, 'description' => '人脸、Trace数量超出限制。请根据文档中的限制检查，每个人脸样本最多可以添加5张人脸照片不支持扩容。'], + ['code' => 'Retry', 'message' => 'An error occurred due to jitter. Please try again.', 'http_code' => 449, 'description' => '由于网络抖动等偶发原因导致失败，需要重试'], + ['code' => 'SDK.ServerUnreachable', 'message' => 'An SDK client error occurred.', 'http_code' => 400, 'description' => 'SDK端错误'], + ['code' => 'ServiceUnavailable', 'message' => 'The service is unavailable.', 'http_code' => 503, 'description' => '服务不可用，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], + ['code' => 'ServiceUnavailable', 'message' => 'A network error occurred.', 'http_code' => 500, 'description' => '算法服务报错，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。 '], + ['code' => 'SignatureDoesNotMatch', 'message' => '签名不正确，请重新计算签名。关于签名可参考文档：https://help.aliyun.com/document_detail/144904.html', 'http_code' => 400, 'description' => '签名不正确，请重新计算签名。可以参考https://help.aliyun.com/document\\_detail/144904.html文档计算请求签名。如果您的语言比较常用，推荐使用SDK进行调用，详情可参考：https://help.aliyun.com/document\\_detail/145033.html '], + ['code' => 'SignatureNonceUsed', 'message' => '签名已经被使用过，请重新计算签名。关于签名可参考文档：https://help.aliyun.com/document_detail/144904.html', 'http_code' => 400, 'description' => '签名已经被使用过，请重新计算签名。可以参考https://help.aliyun.com/document\\_detail/144904.html文档计算请求签名。如果您的语言比较常用，推荐使用SDK进行调用，详情可参考：https://help.aliyun.com/document\\_detail/145033.html '], + ['code' => 'Throttling', 'message' => 'The request was denied due to QPS limits.', 'http_code' => 400, 'description' => '调用被限流，请稍后再调用，或者购买QPS提升调用限制。关于QPS限制提升流程和处理请参考：https://help.aliyun.com/document_detail/604963.html。如果因业务需求需要更多QPS可通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群与平台取得联系。'], + ['code' => 'Throttling.User', 'message' => 'The request was denied due to QPS limits.', 'http_code' => 400, 'description' => '调用被限流，请稍后再调用，或者购买QPS提升调用限制。关于QPS限制提升流程和处理请参考：https://help.aliyun.com/document_detail/604963.html。如果因业务需求需要更多QPS可通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群与平台取得联系。'], + ['code' => 'Timeout', 'message' => 'The request has timed out.', 'http_code' => 408, 'description' => '请求超时，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], + ['code' => 'Unauthorized', 'message' => 'RAM authentication failed.', 'http_code' => 403, 'description' => '没有Ram权限，请联系主账号给你添加AliyunVIAPIFullAccess权限，操作流程可参考https://help.aliyun.com/document\\_detail/145025.htm '], + ['code' => 'UnsupportedHTTPMethod', 'message' => 'The HTTP request method is not supported.', 'http_code' => 403, 'description' => 'HTTP请求方法不支持，建议查看各个产品的API调用方式文档。'], + ], + 'changeSet' => [], + 'ram' => [ + 'productCode' => 'VisualIntelligenceAPI', + 'productName' => '视觉智能开放平台', + 'ramCodes' => ['viapi-imageseg', 'viapi-imageaudit', 'viapi-ocr', 'viapi-objectdet', 'viapi-imageenhan', 'viapi-videorecog', 'viapi-imageprocess', 'viapi', 'viapi-ekyc', 'viapi-imgsearch', 'viapi-goodstech', 'viapi-facebody', 'viapi-threedvision', 'viapi-videoenhan', 'viapi-imagerecog', 'viapi-videoseg', 'viapi-regen', 'viapi-aigen'], + 'ramLevel' => '服务级', + 'ramConditions' => [], + 'ramActions' => [ + [ + 'apiName' => 'DeleteFace', + 'description' => '删除人脸', + 'operationType' => 'delete', + 'ramAction' => [ + 'action' => 'viapi-facebody:DeleteFace', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], ], - 'schemes' => [ - 'https', + [ + 'apiName' => 'DeepfakeFace', + 'description' => '换脸鉴别', + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'viapi-facebody:DeepfakeFace', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], ], - 'security' => [ - [ - 'AK' => [], + [ + 'apiName' => 'BatchAddFaces', + 'description' => '批量添加人脸数据', + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'viapi-facebody:BatchAddFaces', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], ], ], - 'operationType' => 'read', - 'deprecated' => false, - 'systemTags' => [ + [ + 'apiName' => 'DetectCelebrity', + 'description' => '明星识别', + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-facebody:DetectCelebrity', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'RecognizeFace', + 'description' => '人脸属性识别', + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-facebody:RecognizeFace', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'DeleteFaceDb', + 'description' => '删除数据库', + 'operationType' => 'delete', + 'ramAction' => [ + 'action' => 'viapi-facebody:DeleteFaceDb', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'DetectLivingFace', + 'description' => '人脸活体检测', + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-facebody:DetectLivingFace', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'ListFaceEntities', + 'description' => '查询人脸样本列表', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'viapi-facebody:ListFaceEntities', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'MonitorExamination', + 'description' => '线上监考', + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-facebody:MonitorExamination', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'DetectFace', + 'description' => '人脸检测与五官定位', 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'viapi-facebody:DetectFace', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], ], - 'parameters' => [ - [ - 'name' => 'Tasks', - 'in' => 'formData', - 'style' => 'repeatList', - 'schema' => [ - 'description' => '输入人脸数据。', - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'ImageURL' => [ - 'description' => '待检测的图像URL地址。JSON数组中的每个元素是一个图片检测任务结构体（image表）。最多支持10个元素，即同时最多对10张图片进行检测。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。'."\n" - ."\n" - .'> 对于该接口，系统会自动将OSS链接地址转成内网地址然后再下载文件，所以调用该接口并不会产生OSS流量计费。', - 'type' => 'string', - 'required' => false, - 'example' => 'https://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/DeepfakeFace/DeepfakeFace1.jpg', - 'isFileTransferUrl' => true, - ], - 'ImageData' => [ - 'description' => '图像Base64编码字符串。当与URL方式共存时，URL方式优先。'."\n" - .'文件的Base64编码处理操作，请参见[文件Base64处理](~~468191~~)。', - 'type' => 'string', - 'required' => false, - 'example' => '/9j/4AAQSkZJRgABAQAAAQABAAD/2****', - ], - ], - 'required' => false, - ], - 'required' => true, - 'maxItems' => 10, + [ + 'apiName' => 'GetFaceEntity', + 'description' => '查询人脸样本', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'viapi-facebody:GetFaceEntity', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], ], ], ], - 'responses' => [ - 200 => [ - 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response', - 'type' => 'object', - 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '8E6F65D5-62A1-1E5B-BC0B-00508034AC92', - ], - 'Data' => [ - 'description' => '返回的结果数据内容。', - 'type' => 'object', - 'properties' => [ - 'Elements' => [ - 'description' => '返回识别的元素。', - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'ImageURL' => [ - 'description' => '对应请求中的图像URL地址。', - 'type' => 'string', - 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/DeepfakeFace/DeepfakeFace1.jpg', - ], - 'TaskId' => [ - 'description' => '该检测任务的ID。', - 'type' => 'string', - 'example' => '8E6F65D5-62A1-1E5B-BC0B-00508034AC92', - ], - 'Results' => [ - 'description' => '返回结果。调用成功时返回结果中包含一个或多个元素。', - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'Label' => [ - 'description' => '检测结果的分类，取值包括：'."\n" - ."\n" - .'- normalface：真脸照片'."\n" - .'- deepfakeface：换脸照片'."\n" - ."\n" - .'如果未检测到人脸，则Label返回为`deepfake`。', - 'type' => 'string', - 'example' => 'normalface', - ], - 'Confidence' => [ - 'description' => '取值范围为\\[0.00,100.00]。数值越低表示属于真脸的概率越大。', - 'type' => 'number', - 'format' => 'float', - 'example' => '36.6455', - ], - 'Rect' => [ - 'description' => '人脸检测框信息。', - 'type' => 'object', - 'properties' => [ - 'Left' => [ - 'description' => '检测框左上角的点x坐标。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '373', - ], - 'Top' => [ - 'description' => '检测框左上角的点y坐标。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '111', - ], - 'Width' => [ - 'description' => '检测框宽度。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '207', - ], - 'Height' => [ - 'description' => '检测框高度。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '284', - ], - ], - ], - 'MessageTips' => [ - 'description' => '提示信息。'."\n" - .'- 如输入模糊、遮挡或大角度等的人脸，则返回提示信息：`blurred, occluded or large angle face, please check.` '."\n" - .'- 如未检测到人脸，则返回提示信息：`no face detected, try again please.`', - 'type' => 'string', - 'example' => 'blurred, occluded or large angle face, please check.', - ], - ], - ], - ], - 'FaceNumber' => [ - 'description' => '单张图片检测到的人脸数量。'."\n" - .'如果未检测到人脸，FaceNumber返回为0。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], - ], - ], - ], - ], - ], - ], + [ + 'apiName' => 'ListFaceDbs', + 'description' => '查询人脸数据库列表', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'viapi-facebody:ListFaceDbs', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], ], ], ], - 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'ParameterError', - 'errorMessage' => 'The parameter is invalid. Please check again.', + [ + 'apiName' => 'DetectVideoLivingFace', + 'description' => '视频活体检测', + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-facebody:DetectVideoLivingFace', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], ], ], - 403 => [ - [ - 'errorCode' => 'AuthFailed', - 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', + ], + [ + 'apiName' => 'BodyPosture', + 'description' => '人体姿态关键点', + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-facebody:BodyPosture', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], ], ], - 408 => [ - [ - 'errorCode' => 'Timeout', - 'errorMessage' => 'The request has timed out.', + ], + [ + 'apiName' => 'GenRealPersonVerificationToken', + 'description' => '核身认证移动端请求', + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-facebody:GenRealPersonVerificationToken', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], ], ], - 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'The service is unavailable.', + ], + [ + 'apiName' => 'UpdateFaceEntity', + 'description' => '更新人脸样本', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'viapi-facebody:UpdateFaceEntity', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + [ + 'apiName' => 'MergeImageFace', + 'description' => '图像人脸融合', + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'viapi-facebody:MergeImageFace', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'CreateFaceDb', + 'description' => '创建人脸数据库', + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'viapi-facebody:CreateFaceDb', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'DetectPedestrian', + 'description' => '人体检测', + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-facebody:DetectPedestrian', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'ExtractFingerPrint', + 'description' => '指纹提取', + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-facebody:ExtractFingerPrint', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'DetectInfraredLivingFace', + 'description' => '红外人脸活体检测', + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-facebody:DetectInfraredLivingFace', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'GenerateHumanAnimeStyle', + 'description' => '人物动漫化', + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-facebody:GenerateHumanAnimeStyle', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'RecognizeExpression', + 'description' => '表情识别', + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-facebody:RecognizeExpression', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'DetectBodyCount', + 'description' => '人体计数', + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-facebody:DetectBodyCount', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'GenerateHumanSketchStyle', + 'description' => '人像素描风格化', + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-facebody:GenerateHumanSketchStyle', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'CompareFaceWithMask', + 'description' => '口罩人脸比对1:1', + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-facebody:CompareFaceWithMask', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'PedestrianDetectAttribute', + 'description' => '人体结构化属性', + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-facebody:PedestrianDetectAttribute', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'RecognizeAction', + 'description' => '动作行为识别', + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-facebody:RecognizeAction', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'EnhanceFace', + 'description' => '人脸修复增强', + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-facebody:EnhanceFace', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'BlurFace', + 'description' => '人脸信息脱敏', + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-facebody:BlurFace', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'LiquifyFace', + 'description' => '智能瘦脸', + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-facebody:LiquifyFace', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'FaceBeauty', + 'description' => '人脸美颜', + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-facebody:FaceBeauty', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'QueryFaceImageTemplate', + 'description' => '图像人脸融合模板查询', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'viapi-facebody:QueryFaceImageTemplate', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'AddFaceImageTemplate', + 'description' => '图像人脸融合模板增加', + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'viapi-facebody:AddFaceImageTemplate', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'RecognizePublicFace', + 'description' => '公众人物识别', + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-facebody:RecognizePublicFace', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'DeleteFaceEntity', + 'description' => '删除人脸样本', + 'operationType' => 'delete', + 'ramAction' => [ + 'action' => 'viapi-facebody:DeleteFaceEntity', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'AddFaceEntity', + 'description' => '添加人脸样本', + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'viapi-facebody:AddFaceEntity', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'AddFace', + 'description' => '添加人脸数据', + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'viapi-facebody:AddFace', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'CompareFace', + 'description' => '人脸比对1:1', + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-facebody:CompareFace', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'SearchFace', + 'description' => '人脸搜索', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'viapi-facebody:SearchFace', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'RetouchSkin', + 'description' => '智能美肤', + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-facebody:RetouchSkin', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'DeleteFaceImageTemplate', + 'description' => '图像人脸融合模板删除', + 'operationType' => 'delete', + 'ramAction' => [ + 'action' => 'viapi-facebody:DeleteFaceImageTemplate', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'GetRealPersonVerificationResult', + 'description' => '核身认证移动端查询', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'viapi-facebody:GetRealPersonVerificationResult', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"8E6F65D5-62A1-1E5B-BC0B-00508034AC92\\",\\n \\"Data\\": {\\n \\"Elements\\": [\\n {\\n \\"ImageURL\\": \\"http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/DeepfakeFace/DeepfakeFace1.jpg\\",\\n \\"TaskId\\": \\"8E6F65D5-62A1-1E5B-BC0B-00508034AC92\\",\\n \\"Results\\": [\\n {\\n \\"Label\\": \\"normalface\\",\\n \\"Confidence\\": 36.6455,\\n \\"Rect\\": {\\n \\"Left\\": 373,\\n \\"Top\\": 111,\\n \\"Width\\": 207,\\n \\"Height\\": 284\\n },\\n \\"MessageTips\\": \\"blurred, occluded or large angle face, please check.\\"\\n }\\n ],\\n \\"FaceNumber\\": 1\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n 8E6F65D5-62A1-1E5B-BC0B-00508034AC92\\n \\n \\n http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/DeepfakeFace/DeepfakeFace1.jpg\\n 8E6F65D5-62A1-1E5B-BC0B-00508034AC92\\n \\n \\n 36.6455\\n \\n 373\\n 111\\n 207\\n 284\\n \\n blurred, occluded or large angle face, please check.\\n \\n 1\\n \\n \\n","errorExample":""}]', - 'title' => '换脸鉴别', - 'description' => '## 功能描述'."\n" - .'换脸鉴别基于图像算法AI技术，实现对图片人脸的真伪进行灵敏检测和深度分析。能力范围支持：'."\n" - ."\n" - .'1. 鉴别图片中的人脸是否为AI换脸算法所深度合成的假脸。'."\n" - .'2. 鉴别图片中的人脸是否为AI人脸属性编辑生成类算法所深度合成的假脸。深度伪造技术是指利用深度学习实现图片或视频换脸、人脸编辑生成的技术。'."\n" - ."\n" - .'关于该接口功能的示例图如下：'."\n" - ."\n" - .'- 未经算法合成：'."\n" - .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20231109/kpoj/real2.png)'."\n" - .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20231109/rvyz/real1.jpg)'."\n" - ."\n" - .'- 经过算法合成：'."\n" - .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20231109/vcgh/fake1.png)'."\n" - .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20231109/xgjj/fake2.png)'."\n" - ."\n" - .'> - 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" - .'- 当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击[立即试用](https://vision.aliyun.com/experience/detail?&tagName=facebody&children=DeepfakeFace)对该能力进行更直观试用以及在线购买。'."\n" - .'- 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。'."\n" - ."\n" - .'## 应用场景'."\n" - .'- 打击换脸视频网络传播：互联网娱乐性质换脸小程序、APP应用爆火，换脸鉴别技术可以识别出网络短视频中的伪造视频人脸，杜绝视频换脸造假。'."\n" - .'- 打击互联网ID换脸诈骗：深度伪造技术高频使用，假视频与社交网络结合深深影响舆论走向和诱导诈骗。换脸鉴别可识别网上业务办理中的人脸伪造视频，减少网络诈骗。'."\n" - .'- 打击色情娱乐等黑灰产业：互联网的深度伪造合成的色情视频数量巨大，换脸鉴别可以识别此类伪造视频，减少伪造视频人脸色情内容传播，切断色情传播链路。'."\n" - .'- 人脸特征编辑鉴别：真人ID版权核验，通过换脸鉴别可以识别出版权素材库中人脸属性编辑生成算法所深度合成的假脸图片素材，杜绝换脸造假，杜绝人脸版权侵权行为。'."\n" - ."\n" - .'## 特色优势'."\n" - .'- 反制AI技术滥用：换脸鉴别基于达摩院人脸图像算法和Deepfake鉴别技术，提供对图像中的人脸特征进行全方位分析，利用AI技术反制换脸、合成脸、人脸特征编辑生成这类AI技术的滥用，保护用户合法权益、维护社会公共安全。'."\n" - .'- 领先鉴别技术：基于图片中人像目标的高维度全量特征，换脸鉴别服务涵盖依据视频图像的像素、纹理级别的低阶特征，到具有全局语义的高阶特征，对图像进行全方位、高语义、多层次组合分析，攻防一体式的训练，极大提升合成人脸图片检出率。'."\n" - .'- 准确率高：换脸鉴别结合阿里云多年人脸识别技术能力和大数据安全技术能力，能对视频图像中 AI 换脸、AI人脸生成等技术进行准确识别判断，对AI换脸攻击识别准确率高。'."\n" - .'- 支持单个或多个人脸判断逻辑，可直接调用的API接口，服务简单易用，易被集成，兼容性强。'."\n" - ."\n" - .'## 接入指引'."\n" - .'1. 注册阿里云账号：打开[阿里云官网](https://www.aliyun.com)，在阿里云官网右上角，单击**立即注册**，按照操作提示完成账号注册。'."\n" - .'2. 开通能力：请确保您已开通[人脸人体服务](https://vision.aliyun.com/facebody)，若未开通服务请[立即开通](https://common-buy.aliyun.com/?commodityCode=viapi_facebody_public_cn#/open)。'."\n" - .'> 本能力支持企业或个人认证用户开通。更多实名认证操作信息，请参见[实名认证](https://help.aliyun.com/knowledge_list/37170.html)。'."\n" - .'3. 创建AccessKey：请确保您已[创建AccessKey](~~175144~~)，如果您使用的是子账号AccessKey，您需要给子账号赋予AliyunVIAPIFullAccess权限，具体操作，请参见[RAM授权](~~145025~~)。'."\n" - .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/facebody/2019-12-30/DeepfakeFace)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" - .'5. 开发接入步骤：'."\n" - .'- 在[SDK总览](~~145033~~)中选择您要接入使用的SDK语言。'."\n" - .'- 在对应语言的SDK文档中找到AI类目为人脸人体（facebody）的SDK包进行安装。'."\n" - .'- 参考文档中提供的示例代码进行适当修改后调用。'."\n" - ."\n" - .'6. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" - .'- [Web前端直接调用](~~467779~~)'."\n" - .'- [小程序场景下直接调用](~~467780~~)'."\n" - .'- [Android端直接调用](~~467781~~)'."\n" - .'- [iOS端直接调用](~~467782~~)'."\n" - ."\n" - .'## 输入限制'."\n" - ."\n" - .'- 图像格式：PNG、JPG、JPEG、BMP、GIF、WEBP。'."\n" - .'- 图像大小：不超过10 MB。'."\n" - .'- 图像分辨率：建议大于256×256像素，人脸区域大于128*128，像素过低可能会影响识别效果。'."\n" - .'- URL地址中不能包含中文字符。'."\n" - ."\n" - .'> 当图像分辨率超过最大限制时，请先将图片进行缩放，调整图片大小，具体请参见[图片缩放](~~44688~~)。'."\n" - ."\n" - .'## 检测说明'."\n" - ."\n" - .'- 最长检测时间是5秒，如果在该时间内没有完成检测，系统会强制返回超时错误码。'."\n" - .'- 图像下载时间限制为3秒，如果下载时间超过3秒，系统会返回下载超时。'."\n" - .'- 图像检测接口响应时间依赖图像的下载时间。请保证被检测图像所在的存储服务稳定可靠，建议您使用阿里云OSS存储或者CDN缓存。'."\n" - .'- 最多可检测10张图像。'."\n" - ."\n" - .'## 计费说明'."\n" - .'换脸鉴别能力目前处于公测期，可免费调用。', - 'responseParamsDescription' => '## SDK参考'."\n" - .'阿里云视觉AI人脸人体类目下的换脸鉴别能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。', - 'extraInfo' => '## 换脸鉴别阈值参考'."\n" - .'接口返回Label默认按照Confidence的阈值为50，当Confidence小于50，**Label**为`normalface`；当Confidence大于50，**Label**为`deepfakeface`。'."\n" - .'Confidence为模型置信度，取值范围是\\[0,100]，越低表示属于真脸的概率越大。您也可以通过卡Confidence阈值的方法匹配不同使用场景更灵活使用，内部实验参考数据如下。'."\n" - ."\n" - .'| Confidence阈值 | 伪造人脸拦截率 | 真实人脸通过率 |'."\n" - .'| ---- | ------------ | ---- |'."\n" - .'|15 |98.21% |80.27% |'."\n" - .'|30 |97.56% |87.59% |'."\n" - .'|40 |97.04% |90.67% |'."\n" - .'|50（默认） |95.09% |96.61% |'."\n" - .'|60 |92.50% |98.13% |'."\n" - .'|70 |90.59% |98.77% |'."\n" - ."\n" - .'关于以上数值的概念定义：'."\n" - .'- 伪造人脸拦截率：如98%，代表100次作弊伪造人脸攻击，会有98次被API识破拒绝。'."\n" - .'- 真实人脸通过率：如98%，代表100次真实人脸请求，会有98次顺利通过活体验证。'."\n" - ."\n" - .'> 内部实验数据测算，仅供参考。'."\n" - ."\n" - .'## 错误码'."\n" - .'关于换脸鉴别的错误码，详情请参见[常见错误码](~~146756~~)。'."\n" - ."\n" - .'## 安全声明'."\n" - .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" - .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。'."\n" - .'- 平台不存储用户在使用服务过程中涉及的原始人脸图片或文件信息。', - ], - ], - 'endpoints' => [ - [ - 'regionId' => 'cn-shanghai', - 'endpoint' => 'facebody.cn-shanghai.aliyuncs.com', ], + 'resourceTypes' => [], ], ]; diff --git a/data/zh_cn/facebody/2020-09-10/api-docs.php b/data/zh_cn/facebody/2020-09-10/api-docs.php index 0a826ad..6845d3b 100644 --- a/data/zh_cn/facebody/2020-09-10/api-docs.php +++ b/data/zh_cn/facebody/2020-09-10/api-docs.php @@ -1,18 +1,12 @@ '1.0', - 'info' => [ - 'style' => 'ROA', - 'product' => 'facebody', - 'version' => '2020-09-10', - ], + 'info' => ['style' => 'ROA', 'product' => 'facebody', 'version' => '2020-09-10'], 'directories' => [ [ 'id' => 0, 'title' => '其它', 'type' => 'directory', - 'children' => [ - 'ExecuteServerSideVerification', - ], + 'children' => ['ExecuteServerSideVerification'], ], ], 'components' => [ @@ -22,24 +16,15 @@ 'ExecuteServerSideVerification' => [ 'summary' => '本文介绍人脸核身服务端ExecuteServerSideVerification的语法及示例。', 'path' => '/viapi/thirdparty/realperson/execServerSideVerification', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'methods' => ['post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'consumes' => [ - 'application/x-www-form-urlencoded', - ], - 'produces' => [ - 'application/json', - ], + 'consumes' => ['application/x-www-form-urlencoded'], + 'produces' => ['application/json'], 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [], @@ -47,54 +32,29 @@ [ 'name' => 'certificateName', 'in' => 'formData', - 'schema' => [ - 'description' => '真实姓名。', - 'type' => 'string', - 'required' => false, - 'example' => '张三', - ], + 'schema' => ['description' => '真实姓名。', 'type' => 'string', 'required' => false, 'example' => '张三'], ], [ 'name' => 'certificateNumber', 'in' => 'formData', - 'schema' => [ - 'description' => '身份证号。', - 'type' => 'string', - 'required' => false, - 'example' => '1281739873298172981', - ], + 'schema' => ['description' => '身份证号。', 'type' => 'string', 'required' => false, 'example' => '1281739873298172981'], ], [ 'name' => 'facialPictureData', 'in' => 'formData', - 'schema' => [ - 'description' => '与**facialPictureUrl**二选一。'."\n" - .'待比对的图像，Base64格式，只支持JPG格式图片。必须是"/9j/"开头，如非"/9j/"开头请检查是否为JPG格式图片。文件的Base64编码处理操作，请参见[文件Base64处理](~~468191~~)。', - 'type' => 'string', - 'required' => false, - 'example' => '/9j/wwew...', - ], + 'schema' => ['description' => '与**facialPictureUrl**二选一。'."\n" + .'待比对的图像，Base64格式，只支持JPG格式图片。必须是"/9j/"开头，如非"/9j/"开头请检查是否为JPG格式图片。文件的Base64编码处理操作，请参见[文件Base64处理](~~468191~~)。', 'type' => 'string', 'required' => false, 'example' => '/9j/wwew...'], ], [ 'name' => 'facialPictureUrl', 'in' => 'formData', - 'schema' => [ - 'description' => '与**facialPictureData**二选一。'."\n" - .'待比对的图像URL地址，只支持JPG格式图片。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。', - 'type' => 'string', - 'required' => false, - 'example' => 'http://xxx.xxx.com/xxx.jpg', - ], + 'schema' => ['description' => '与**facialPictureData**二选一。'."\n" + .'待比对的图像URL地址，只支持JPG格式图片。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。', 'type' => 'string', 'required' => false, 'example' => 'http://xxx.xxx.com/xxx.jpg'], ], [ 'name' => 'sceneType', 'in' => 'formData', - 'schema' => [ - 'description' => '场景类型，默认为`server`。目前只支持`server`。', - 'type' => 'string', - 'required' => false, - 'example' => 'server', - ], + 'schema' => ['description' => '场景类型，默认为`server`。目前只支持`server`。', 'type' => 'string', 'required' => false, 'example' => 'server'], ], ], 'responses' => [ @@ -104,37 +64,20 @@ 'description' => '返回结构体。', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'CE2FFC8A-6669-4F02-B4DA-95888087FBDC', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => 'CE2FFC8A-6669-4F02-B4DA-95888087FBDC'], 'Data' => [ 'description' => '返回的结果数据内容。', 'type' => 'object', 'properties' => [ - 'Pass' => [ - 'description' => '验证是否成功。'."\n" - ."\n" - .'- true：验证成功。'."\n" - .'- false：验证失败。', - 'type' => 'boolean', - 'example' => 'true', - ], - 'VerificationToken' => [ - 'description' => '验证Token，主要用于排查问题。', - 'type' => 'string', - 'example' => '6f1f730e732b232ccbdd85abc751****', - ], - 'Reason' => [ - 'description' => '认证结果原因。'."\n" - ."\n" - .'- 认证通过(Z8120)。'."\n" - .'- 抱歉，没有认出您(Z1146)。', - 'type' => 'string', - 'example' => '认证通过(Z8120)', - ], + 'Pass' => ['description' => '验证是否成功。'."\n" + ."\n" + .'- true：验证成功。'."\n" + .'- false：验证失败。', 'type' => 'boolean', 'example' => 'true'], + 'VerificationToken' => ['description' => '验证Token，主要用于排查问题。', 'type' => 'string', 'example' => '6f1f730e732b232ccbdd85abc751****'], + 'Reason' => ['description' => '认证结果原因。'."\n" + ."\n" + .'- 认证通过(Z8120)。'."\n" + .'- 抱歉，没有认出您(Z1146)。', 'type' => 'string', 'example' => '认证通过(Z8120)'], ], ], ], @@ -230,9 +173,6 @@ ], ], 'endpoints' => [ - [ - 'regionId' => 'cn-shanghai', - 'endpoint' => 'facebody.cn-shanghai.aliyuncs.com', - ], + ['regionId' => 'cn-shanghai', 'endpoint' => 'facebody.cn-shanghai.aliyuncs.com'], ], ]; -- cgit v1.2.3