首页 智能媒体服务 API参考指南 API目录 媒资管理 SearchMediaByFace - 人脸图片搜媒资

SearchMediaByFace - 人脸图片搜媒资

人脸图片搜媒资接口(粗搜),输入一张人脸图片,搜索该人物所在媒资的相关信息。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
PageNointeger

当前页码。默认值为1。

1
PageSizeinteger

每页返回的数据条数。默认值为10,最大值为50。

10
EntityIdstring

实体ID。

2d3bf1e35a1e42b5ab338d701efa****
PersonImageUrlstring

人脸图片URL。

https://****.oss-cn-shanghai.aliyuncs.com/input/huangxuan****.jpg
FaceSearchTokenstring

通过该参数判断是同一个搜索条件下的分页返回,与精搜接口里的FaceSearchToken配合使用。

zxtest-huangxuan-2023-3-7-V1

返回参数

名称类型描述示例值
object

Schema of Response

RequestIdstring

请求ID。

7CA7D615-CFB1-5437-9A12-2D185C3EE6CB
Successstring

操作是否成功。取值:true:成功。false:失败。

true
Codestring

返回码。

200
MediaInfoListarray

符合要求的媒资集合。

object

媒资信息列表。

MediaIdstring

媒资ID。

3b187b3620c8490886cfc2a9578c****
Totallong

满足搜索条件的媒资信息总条数。

163

示例

正常返回示例

JSON格式

{
  "RequestId": "7CA7D615-CFB1-5437-9A12-2D185C3EE6CB",
  "Success": "true",
  "Code": "200",
  "MediaInfoList": [
    {
      "MediaId": "3b187b3620c8490886cfc2a9578c****"
    }
  ],
  "Total": 163
}

错误码

访问错误中心查看更多错误码。

阿里云首页 智能媒体服务 相关技术圈