调用SearchMediaClipByFace人脸图片搜媒资片段_智能媒体服务(IMS)-阿里云帮助中心

人脸图片搜媒资片段接口（精搜），基于粗搜结果返回该人脸所在媒资的相关人物片段信息。

接口说明

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

调试

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

调试

授权信息

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

请求参数

名称	类型	必填	描述	示例值
SearchLibName	string	否	搜索库名称。	test1
PageNo	integer	否	当前页码。默认值为 1。	1
PageSize	integer	否	每页返回的数据条数。默认值为 10，最大值为 50。	10
EntityId	string	否	实体 ID。	2d3bf1e35a1e42b5ab338d701efa****
FaceSearchToken	string	是	与粗搜接口里的 FaceSearchToken 的值保持一致，通过该参数判断是同一个搜索条件下的分页返回。	zxtest-huangxuan-2023-3-7-V1
MediaId	string	是	媒资 ID。	3b187b3620c8490886cfc2a9578c****

返回参数

名称	类型	描述	示例值
	object	Schema of Response
RequestId	string	请求 ID。	E44FFACD-9E90-555A-A09A-6FD3B7335E39
Success	string	操作是否成功。true 表示成功，false 表示失败。	true
Code	string	返回码。	200
MediaClipList	object []	符合要求的媒资片段集合。
Score	float	匹配片段得分，Float 类型，范围为[0，1]。	0.99041677
EntityId	string	实体 ID，对应标签分析结果里的实体 ID。	1031025****
LabelName	string	实体名称。	张三
OccurrencesInfos	object []	人物片段聚类信息
StartTime	float	匹配片段的起始时间，单位为秒，Float 类型。	61.066353
EndTime	float	匹配片段的结束时间，单位为秒，Float 类型。	69.06635
TrackData	object []	人脸在片段中的具体信息。
Timestamp	float	人脸在媒资中出现的时间戳，单位为秒，Float 类型。	62.03302
BoxPosition	object	人脸坐标信息。
X	integer	左上顶点 x 轴坐标，单位为像素。	517
Y	integer	左上顶点 y 轴坐标，单位为像素。	409
W	integer	矩形框宽度，单位为像素。	128
H	integer	矩形框高度，单位为像素。	168
Category	string	人物类型。取值： celebrity——名人 sensitive——敏感人物 politician——政治人物 custom——自定义人物 unknown——未知人物	celebrity
Total	long	符合条件的媒资片段总数。	5

示例

正常返回示例

JSON格式

{
  "RequestId": "E44FFACD-9E90-555A-A09A-6FD3B7335E39",
  "Success": "true",
  "Code": "200",
  "MediaClipList": [
    {
      "Score": 0.99041677,
      "EntityId": "1031025****",
      "LabelName": "张三",
      "OccurrencesInfos": [
        {
          "StartTime": 61.066353,
          "EndTime": 69.06635,
          "TrackData": [
            {
              "Timestamp": 62.03302,
              "BoxPosition": {
                "X": 517,
                "Y": 409,
                "W": 128,
                "H": 168
              }
            }
          ]
        }
      ],
      "Category": "celebrity"
    }
  ],
  "Total": 5
}

错误码

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

变更历史

变更时间

变更内容概要

操作

2023-10-12

OpenAPI 入参发生变更

看变更集

变更项	变更内容
入参	OpenAPI 入参发生变更。
	新增入参：SearchLibName