SearchMediaByAILabel - 智能标签文本搜索_智能媒体服务(IMS)-阿里云帮助中心

可以根据人名、字幕、AI分类进行多模搜索。

接口说明

可以根据人名、字幕、AI 分类进行多模搜索，粗搜支持媒资粒度返回，精搜支持媒资内命中片段信息返回。

调试

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

调试

授权信息

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

请求参数

名称	类型	必填	描述	示例值
SearchLibName	string	否	搜索库名称	test-1
MediaType	string	否	媒资类型。取值： image：图片 video：视频 audio：音频	video
SortBy	string	否	查询结果排序。取值： CreationTime:Desc（默认值）：按创建时间倒序。 CreationTime:Asc：按创建时间升序。	CreationTime:Desc
PageNo	integer	否	当前页码。默认值为 1。	1
PageSize	integer	否	每页返回的数据条数。默认值为 10，最大值为 50。	20
Text	string	否	搜索内容。	风筝
MultimodalSearchType	string	否	多模搜索类型。默认为全文搜索。取值： PersonName：人名搜 Ocr：字幕搜 AiCategory ：AI 分类 FullSearch：全文搜	Ocr
SpecificSearch	boolean	否	是否精搜。取值： true：精搜 false：粗搜	true
MediaId	string	否	媒资 ID。精搜时必须携带。	**c469e944b5a856828dc2**

返回参数

名称	类型	描述	示例值
	object	Schema of Response
RequestId	string	请求 ID。	****11-DB8D-4A9A-875B-275798****
Success	string	是否成功。	true
Code	string	返回码。	200
MediaList	object []	符合要求的媒资集合
AiData	object	AI 详细信息。
AiLabelInfo	object []	AI 标签信息列表。
FaceId	string	人脸 ID。	5FE19530C7A422197535FE74F5DB****
LabelType	string	标签类型。	物体
Source	string	来源。	vision
Category	string	分类。	交通工具
LabelName	string	实体名称。	车
LabelId	string	实体 ID。	103102503**
Occurrences	object []	片段信息。
Score	double	打分。	0.75287705
Image	string	最有人脸图片。	https://service-**-public.oss-cn-hangzhou.aliyuncs.com/1563457438522/service-image/f788974f-9595-43b2-a478-7c7a1afb**.jpg
TableBatchSeqId	string	向量表序列 ID。	85010D1**
ClipId	string	片段 ID。	158730355E4B82257D8AA1583A58****
From	double	片段起始时间。	1.4
To	double	片段结束时间。	2.5
FinegrainName	string	实体的细粒度名称。	车
FinegrainId	string	实体的细粒度 ID。	103102503**
Content	string	文本内容。	智能标签测试
Tracks	object []	track 序列。
Size	double	人脸 bbox 框的面积。	50
Position	string	bbox 框位置坐标。	468.0;67.0;615.0;267.0
Timestamp	double	track 的时间戳。	1.4
AsrInfo	object []	语音信息列表。
From	double	片段起始时间。	1.4
To	double	片段结束时间。	2.5
ClipId	string	片段 ID。	5FE19530C7A422197535FE74F5DB****
Content	string	文本内容。	智能标签测试
Timestamp	double	片段时间戳。	1.4
OcrInfo	object []	字幕信息列表。
From	double	片段起始时间。	1.4
To	double	片段结束时间。	2.5
ClipId	string	片段 ID。	5FE19530C7A422197535FE74F5DB****
Content	string	文本内容。	皮皮
Timestamp	double	片段时间戳。	1.4
StorageLocation	string	存储地址。	out-****.oss-cn-shanghai.aliyuncs.com
Status	string	视频状态。枚举值： PrepareFail：PrepareFail。 UploadFail：UploadFail。 Init：Init。 UploadSucc：UploadSucc。 Transcoding：Transcoding。 TranscodeFail：TranscodeFail。 Deleted：Deleted。 Normal：Normal。 Uploading：Uploading。 Preparing：Preparing。 Blocked：Blocked。 Checking：Checking。	Normal
CreationTime	string	创建时间。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC 时间）。	2017-11-14T09:15:50Z
ModificationTime	string	更新时间。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC 时间）。	2017-11-14T09:15:50Z
MediaId	string	媒资 ID。	1c6ce34007d571ed94667630a6bc****
Tags	string	标签列表。	标签1, 标签2
Description	string	描述。	阿里云VOD视频描述
AppId	string	应用 ID。默认取值：app-1000000。	app-1000000
Size	long	源文件大小。单位：字节。	10897890
CoverUrl	string	封面 URL。	http://example.aliyundoc.com/snapshot/**.jpg?auth_key=1498476426-0-0-f00b9455c49a423ce69cf4e27333**
Duration	float	时长（单位：秒）。	12.2
Title	string	标题。	史上最牛音乐播放器
Snapshots	array	视频截图 URL 数组。
	string	视频截图 URL。	http://example.aliyundoc.com/snapshot/**.jpg?auth_key=1498476426-0-0-f00b9455c49a423ce69cf4e27333**
Total	long	符合条件的媒资总数。	30

示例

正常返回示例

JSON格式

{
  "RequestId": "******11-DB8D-4A9A-875B-275798******",
  "Success": "true",
  "Code": "200",
  "MediaList": [
    {
      "AiData": {
        "AiLabelInfo": [
          {
            "FaceId": "5FE19530C7A422197535FE74F5DB****\n",
            "LabelType": "物体",
            "Source": "vision",
            "Category": "交通工具",
            "LabelName": "车",
            "LabelId": "103102503**",
            "Occurrences": [
              {
                "Score": 0.75287705,
                "Image": "https://service-****-public.oss-cn-hangzhou.aliyuncs.com/1563457****438522/service-image/f788974f-9595-43b2-a478-7c7a1afb****.jpg",
                "TableBatchSeqId": "85010D1**",
                "ClipId": "158730355E4B82257D8AA1583A58****",
                "From": 1.4,
                "To": 2.5,
                "FinegrainName": "车",
                "FinegrainId": "103102503**",
                "Content": "智能标签测试\n",
                "Tracks": [
                  {
                    "Size": 50,
                    "Position": "468.0;67.0;615.0;267.0",
                    "Timestamp": 1.4
                  }
                ]
              }
            ]
          }
        ],
        "AsrInfo": [
          {
            "From": 1.4,
            "To": 2.5,
            "ClipId": "5FE19530C7A422197535FE74F5DB****",
            "Content": "智能标签测试",
            "Timestamp": 1.4
          }
        ],
        "OcrInfo": [
          {
            "From": 1.4,
            "To": 2.5,
            "ClipId": "5FE19530C7A422197535FE74F5DB****\n",
            "Content": "皮皮",
            "Timestamp": 1.4
          }
        ]
      },
      "StorageLocation": "out-****.oss-cn-shanghai.aliyuncs.com\n",
      "Status": "Normal",
      "CreationTime": "2017-11-14T09:15:50Z\n",
      "ModificationTime": "2017-11-14T09:15:50Z\n",
      "MediaId": "1c6ce34007d571ed94667630a6bc****\n",
      "Tags": "标签1, 标签2\n",
      "Description": "阿里云VOD视频描述\n",
      "AppId": "app-1000000",
      "Size": 10897890,
      "CoverUrl": "http://example.aliyundoc.com/snapshot/****.jpg?auth_key=1498476426-0-0-f00b9455c49a423ce69cf4e27333****",
      "Duration": 12.2,
      "Title": "史上最牛音乐播放器\n",
      "Snapshots": [
        "http://example.aliyundoc.com/snapshot/****.jpg?auth_key=1498476426-0-0-f00b9455c49a423ce69cf4e27333****"
      ]
    }
  ],
  "Total": 30
}

错误码

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

变更历史

变更时间

变更内容概要

操作

2023-10-12

OpenAPI 入参发生变更

看变更集

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