开发者社区 问答 正文

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



描述


将照片从人脸A移动到人脸B。

请求参数

参数名类型是否必须说明
ActionStringMoveFacePhotos
SourceFaceIdLong移出的人脸ID
PhotoId.1Long需要移动的PhotoId,如果有多张照片,请按照规则增加一个参数,比如2张照片,另外一个参数为PhotoId.2
StoreNameStringPhotoStore的名称
TargetFaceIdLong目标人脸ID
LibraryIdString照片库标识。采用AK认证时必选,采用STS认证时可选。了解不同认证方式的区别。


请求示例https://cloudphoto.cn-shanghai.aliyuncs.com/?Action=MoveFacePhotos
&SourceFaceId=822522376041283584
&PhotoId.1=822522474720665600
&StoreName=cloudphoto-demo
&TargetFaceId=822522511903170560
&LibraryId=alice-001
&<公共请求参数>





返回参数

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


Results

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


返回示例


JSON格式 {
    "Results":[
        {
            "Message":"success",
            "Id":822522474720665600,
            "Code":"Success"
        }
    ],
    "Action":"MoveFacePhotos",
    "Message":"success",
    "RequestId":"8B82E060-44FF-47D4-B2E1-0D84C320E923",
    "Code":"Success"
}


XML格式 <?xml version="1.0" encoding="UTF-8"?>
<MoveFacePhotosResponse>
  <Results>
    <Result>
      <Message>success</Message>
      <Id>822522474720665600</Id>
      <Code>Success</Code>
    </Result>
  </Results>
  <Action>MoveFacePhotos</Action>
  <Message>success</Message>
  <RequestId>4334B606-CE8D-4ACC-AE25-BCABA8D4C6F0</RequestId>
  <Code>Success</Code>
</MoveFacePhotosResponse>

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

您提到的操作是使用阿里云的Cloud Photo服务中的"MoveFacePhotos"功能,该功能允许用户将一张或多张与特定人脸(源人脸A)关联的照片移动到另一个不同的人脸(目标人脸B)下。这个过程涉及几个关键参数,下面是对这些参数的简要说明:

  1. Action: 必填参数,表示要执行的操作类型。在这个场景中,值应为MoveFacePhotos,意味着请求是为了移动照片到另一个人脸ID下。

  2. SourceFaceId: 必填参数,指定了需要从其下移出照片的原始人脸ID。

  3. PhotoId.x: 必填参数,其中x是一个数字序号(如1, 2等),用于指定需要移动的具体照片ID。如果有多张照片需要移动,需要按照规则增加相应的参数,例如PhotoId.1, PhotoId.2等。

  4. StoreName: 必填参数,表示存储照片的PhotoStore的名称。每个用户在Cloud Photo服务中可能有多个存储空间,这个参数用来指定操作发生在哪个存储空间内。

  5. TargetFaceId: 必填参数,目标人脸ID,即照片将被移动到的那个人脸记录。

  6. LibraryId: 可选参数,仅当使用Access Key(AK)认证方式时为必选。这是照片库的标识符,用于区分不同的照片库资源。如果您使用的是STS(Security Token Service)临时授权认证,则此参数可选。STS认证通常用于给予应用程序有限时间内的访问权限,而不需要直接暴露长期的Access Key和Secret Key。

请求示例中给出的URL展示了如何构造一个HTTP请求来调用此API。请注意,实际调用时还需要包含其他HTTP请求必备的部分,比如设置正确的HTTP方法(通常是POST)、添加必要的请求头(如Authorization头携带签名信息)以及可能的其他参数或内容体,具体取决于Cloud Photo API的详细要求和认证方式。

请确保在进行此类操作前,已经阅读并理解了阿里云Cloud Photo服务的文档,包括认证、请求结构、响应格式及错误处理等方面,以保证操作的成功执行。

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