使用SearchMediaClipByFace精确搜索人脸媒资片段-智能媒体服务-阿里云-智能媒体服务(IMS)-阿里云帮助中心

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

接口说明

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

调试

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

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

ice:SearchMediaClipByFace

get

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
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	array<object>	符合要求的媒资片段集合。
	array<object>
Score	number	匹配片段得分，Float 类型，范围为[0，1]。	0.99041677
EntityId	string	实体 ID，对应标签分析结果里的实体 ID。	1031025****
LabelName	string	实体名称。	John Doe
OccurrencesInfos	array<object>	人物片段聚类信息
	array<object>
StartTime	number	匹配片段的起始时间，单位为秒，Float 类型。	61.066353
EndTime	number	匹配片段的结束时间，单位为秒，Float 类型。	69.06635
TrackData	array<object>	人脸在片段中的具体信息。
	array<object>
Timestamp	number	人脸在媒资中出现的时间戳，单位为秒，Float 类型。	62.03302
BoxPosition	object	人脸坐标信息。
X	integer	左上顶点 x 轴坐标，单位为像素。	517
Y	integer	左上顶点 y 轴坐标，单位为像素。	409
W	integer	矩形框宽度，单位为像素。	128
H	integer	矩形框高度，单位为像素。	168
Expression	string	表情。	平静
Category	string	人物类型。取值： celebrity——名人 sensitive——敏感人物 politician——政治人物 custom——自定义人物 unknown——未知人物	celebrity
Total	integer	符合条件的媒资片段总数。	5

示例

正常返回示例

JSON格式

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

错误码

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

变更历史

更多信息，参考变更详情。