人脸图片搜媒资片段接口（精搜），基于粗搜结果返回该人脸所在媒资的相关人物片段信息。
接口说明阿里云智能媒体服务智能媒资搜索功能使用或问题咨询等，请搜索钉钉群（30415005038）加入智能媒体服务多模检索客户答疑群联系我们。
调试您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试授权信息下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：
操作：是指具体的权限点。访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。资源类型：是指操作中支持授权的资源类型。具体说明如下：对于必选的资源类型，用前面加 * 表示。对于不支持资源级授权的操作，用全部资源表示。条件关键字：是指云产品自身定义的条件关键字。关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。操作访问级别资源类型条件关键字关联操作ice:SearchMediaClipByFaceget*全部资源*无无请求参数名称类型必填描述示例值SearchLibNamestring否搜索库名称。
test1PageNointeger否当前页码。默认值为 1。
1PageSizeinteger否每页返回的数据条数。默认值为 10，最大值为 50。
10EntityIdstring否实体 ID。
2d3bf1e35a1e42b5ab338d701efa****FaceSearchTokenstring是与粗搜接口里的 FaceSearchToken 的值保持一致，通过该参数判断是同一个搜索条件下的分页返回。
zxtest-huangxuan-2023-3-7-V1MediaIdstring是媒资 ID。
3b187b3620c8490886cfc2a9578c****返回参数名称类型描述示例值objectSchema of Response
RequestIdstring请求 ID。
E44FFACD-9E90-555A-A09A-6FD3B7335E39Successstring操作是否成功。true 表示成功，false 表示失败。
trueCodestring返回码。
200MediaClipListarray符合要求的媒资片段集合。
MediaClipobjectScorefloat匹配片段得分，Float 类型，范围为[0，1]。
0.99041677EntityIdstring实体 ID，对应标签分析结果里的实体 ID。
1031025****LabelNamestring实体名称。
张三OccurrencesInfosarray人物片段聚类信息
OccurrencesInfoobjectStartTimefloat匹配片段的起始时间，单位为秒，Float 类型。
61.066353EndTimefloat匹配片段的结束时间，单位为秒，Float 类型。
69.06635TrackDataarray人脸在片段中的具体信息。
TrackDataobjectTimestampfloat人脸在媒资中出现的时间戳，单位为秒，Float 类型。
62.03302BoxPositionobject人脸坐标信息。
Xinteger左上顶点 x 轴坐标，单位为像素。
517Yinteger左上顶点 y 轴坐标，单位为像素。
409Winteger矩形框宽度，单位为像素。
128Hinteger矩形框高度，单位为像素。
168Expressionstring表情。
平静Categorystring人物类型。 取值： celebrity——名人 sensitive——敏感人物 politician——政治人物 custom——自定义人物 unknown——未知人物
celebrityTotallong符合条件的媒资片段总数。
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 } } ], "Expression": "平静" } ], "Category": "celebrity" } ], "Total": 5 }错误码访问错误中心查看更多错误码。
变更历史变更时间变更内容概要操作2023-10-12OpenAPI 入参发生变更查看变更详情