开发者社区 问答 正文

云相册的API人脸接口ListMoments怎么使用



描述


批量删除人脸,该操作会解除人脸和照片的关系,照片不会被删除。

请求参数

参数名类型是否必须说明
ActionStringDeleteFaces
FaceId.1Long待删除人脸的ID列表,如果有多张人脸,请按照规则增加一个参数,比如2张人脸,另外一个参数为FaceId.2
StoreNameStringPhotoStore的名称
LibraryIdString照片库标识。采用AK认证时必选,采用STS认证时可选。了解不同认证方式的区别。


请求示例https://cloudphoto.cn-shanghai.aliyuncs.com/?Action=DeleteFaces
&FaceId.1=822522376041283584
&StoreName=cloudphoto-demo
&LibraryId=alice-001
&<公共请求参数>





返回参数

参数名类型说明
RequestIdString唯一标识本次请求的ID
CodeString响应状态码,Success表示成功的响应
MessageString响应状态详细描述
ActionStringDeleteFaces
Results数组详见结果信息


Result

参数名类型说明
CodeString状态码
IdLong对应对象的唯一标识
MessageString详细信息


返回示例


JSON格式 {
    "Results":[
        {
            "Message":"success",
            "Id":822522376041283584,
            "Code":"Success"
        }
    ],
    "Action":"DeleteFaces",
    "Message":"success",
    "RequestId":"83A6E1E0-F40A-4BC7-93F5-2DA81CB6328C",
    "Code":"Success"
}


XML格式 <?xml version="1.0" encoding="UTF-8"?>
<DeleteFacesResponse>
  <Results>
    <Result>
      <Message>success</Message>
      <Id>822522376041283584</Id>
      <Code>Success</Code>
    </Result>
  </Results>
  <Action>DeleteFaces</Action>
  <Message>success</Message>
  <RequestId>756E6D12-324E-4D0C-93A7-D10D3B71E2D3</RequestId>
  <Code>Success</Code>
</DeleteFacesResponse>

展开
收起
云栖大讲堂 2017-10-27 10:50:15 1713 分享 版权
阿里云 AI 助理回答

您提到的操作是使用阿里云的Cloud Photo服务来批量删除人脸数据。Cloud Photo是阿里云提供的一种照片管理和分析服务,它允许用户上传、存储、管理和分析大量照片资源。在您的描述中,DeleteFaces操作是用来解除特定人脸ID与照片之间的关联,并从人脸库中移除这些人脸信息,但请注意,这个过程并不会删除实际的照片文件,仅解除人脸识别的数据绑定。

请求参数说明:

  • Action: 操作类型,这里必须设置为DeleteFaces,表示执行删除人脸的操作。

  • FaceId.1, FaceId.2,...: 这些参数代表了待删除的人脸ID列表。每个要删除的人脸都需要通过这样的参数形式指定,比如FaceId.1指第一个人脸的ID,如果有多个,就依次增加,如FaceId.2等。这是必填项,且需要根据实际删除的人脸数量进行相应的参数添加。

  • StoreName: 必须填写,表示Photo Store的名称,即存储和管理照片的存储空间名称。

  • LibraryId: 照片库标识,用于指定操作的具体照片库。当使用Access Key(AK)认证方式时,此参数是必需的;如果采用Security Token Service (STS)认证,则可选。STS是一种临时授权机制,允许用户给予第三方应用有限的访问权限,而无需暴露长期的Access Key和Secret Key。

请求示例:

提供的请求示例是一个HTTP GET请求的URL格式,展示了如何构造一个请求来调用DeleteFaces接口。其中,具体的请求URL包含了必要的操作指令及部分参数,但请注意,实际调用时还需将具体的人脸ID、存储名称等参数填充完整。例如:

https://cloudphoto.cn-shanghai.aliyuncs.com/?Action=DeleteFaces&FaceId.1=123456789&FaceId.2=987654321&StoreName=my_photo_store

在这个例子中,123456789987654321是假设的人脸ID,my_photo_store是存储名称。请根据实际情况替换这些值。

进行此类API调用前,请确保已阅读并理解阿里云Cloud Photo服务的文档,包括认证方式、请求限制以及如何处理响应等,以确保操作成功执行。

有帮助
无帮助
AI 助理回答生成答案可能存在不准确,仅供参考
0 条回答
写回答
取消 提交回答