文档

SearchMediaByFace - 人脸图片搜媒资

更新时间:

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

接口说明

阿里云智能媒体服务智能媒资搜索功能使用或问题咨询等,请搜索钉钉群(30415005038)加入智能媒体服务多模检索客户答疑群联系我们。

调试

您可以在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
SearchLibNamestring

搜索库名称。

test1
MediaTypestring

媒资类型。取值:

  • image:图片
  • video:视频
video

返回参数

名称类型描述示例值
object

Schema of Response

RequestIdstring

请求 ID。

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

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

true
Codestring

返回码。

200
MediaInfoListobject []

符合要求的媒资集合。

MediaIdstring

媒资 ID。

3b187b3620c8490886cfc2a9578c****
Totallong

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

163

示例

正常返回示例

JSON格式

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

错误码

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

变更历史

变更时间变更内容概要操作
2023-10-12OpenAPI 入参发生变更看变更集
变更项变更内容
入参OpenAPI 入参发生变更
    新增入参:SearchLibName
    新增入参:MediaType
  • 本页导读 (1)
文档反馈