文档

SearchMediaByAILabel - 智能标签文本搜索

更新时间:

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

接口说明

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

调试

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

授权信息

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

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
ice:SearchMediaByAILabelget
  • 全部资源
    *

请求参数

名称类型必填描述示例值
SearchLibNamestring

搜索库名称

test-1
MediaTypestring

媒资类型。取值:

  • image:图片
  • video:视频
  • audio:音频
video
SortBystring

查询结果排序。取值:

  • CreationTime:Desc(默认值):按创建时间倒序。
  • CreationTime:Asc:按创建时间升序。
CreationTime:Desc
PageNointeger

当前页码。默认值为 1。

1
PageSizeinteger

每页返回的数据条数。默认值为 10,最大值为 50。

20
Textstring

搜索内容。

风筝
MultimodalSearchTypestring

多模搜索类型。默认为全文搜索。取值:

  • PersonName:人名搜
  • Ocr:字幕搜
  • AiCategory :AI 分类
  • FullSearch:全文搜
Ocr
SpecificSearchboolean

是否精搜。取值:

  • true: 精搜
  • false:粗搜
true
MediaIdstring

媒资 ID。精搜时必须携带。

****c469e944b5a856828dc2****

返回参数

名称类型描述示例值
object

Schema of Response

RequestIdstring

请求 ID。

******11-DB8D-4A9A-875B-275798******
Successstring

是否成功。

true
Codestring

返回码。

200
MediaListarray<object>

符合要求的媒资集合

MediaListobject

媒资信息详情。

AiDataobject

AI 详细信息。

AiLabelInfoarray<object>

AI 标签信息列表。

AiLabelInfoobject

AI 标签信息。

FaceIdstring

人脸 ID。

5FE19530C7A422197535FE74F5DB****
LabelTypestring

标签类型。

物体
Sourcestring

来源。

vision
Categorystring

分类。

交通工具
LabelNamestring

实体名称。

LabelIdstring

实体 ID。

103102503**
Occurrencesarray<object>

片段信息。

Occurrencesobject

片段。

Scoredouble

打分。

0.75287705
Imagestring

最有人脸图片。

https://service-****-public.oss-cn-hangzhou.aliyuncs.com/1563457****438522/service-image/f788974f-9595-43b2-a478-7c7a1afb****.jpg
TableBatchSeqIdstring

向量表序列 ID。

85010D1**
ClipIdstring

片段 ID。

158730355E4B82257D8AA1583A58****
Fromdouble

片段起始时间。

1.4
Todouble

片段结束时间。

2.5
FinegrainNamestring

实体的细粒度名称。

FinegrainIdstring

实体的细粒度 ID。

103102503**
Contentstring

文本内容。

智能标签测试
Tracksarray<object>

track 序列。

Tracksobject

序列。

Sizedouble

人脸 bbox 框的面积。

50
Positionstring

bbox 框位置坐标。

468.0;67.0;615.0;267.0
Timestampdouble

track 的时间戳。

1.4
AsrInfoarray<object>

语音信息列表。

AsrInfoobject

语音信息。

Fromdouble

片段起始时间。

1.4
Todouble

片段结束时间。

2.5
ClipIdstring

片段 ID。

5FE19530C7A422197535FE74F5DB****
Contentstring

文本内容。

智能标签测试
Timestampdouble

片段时间戳。

1.4
OcrInfoarray<object>

字幕信息列表。

OcrInfoobject

字幕信息。

Fromdouble

片段起始时间。

1.4
Todouble

片段结束时间。

2.5
ClipIdstring

片段 ID。

5FE19530C7A422197535FE74F5DB****
Contentstring

文本内容。

皮皮
Timestampdouble

片段时间戳。

1.4
StorageLocationstring

存储地址。

out-****.oss-cn-shanghai.aliyuncs.com
Statusstring

视频状态。

枚举值:
  • PrepareFailPrepareFail
  • UploadFailUploadFail
  • InitInit
  • UploadSuccUploadSucc
  • TranscodingTranscoding
  • TranscodeFailTranscodeFail
  • DeletedDeleted
  • NormalNormal
  • UploadingUploading
  • PreparingPreparing
  • BlockedBlocked
  • CheckingChecking
Normal
CreationTimestring

创建时间。格式为:yyyy-MM-ddTHH:mm:ssZ(UTC 时间)。

2017-11-14T09:15:50Z
ModificationTimestring

更新时间。格式为:yyyy-MM-ddTHH:mm:ssZ(UTC 时间)。

2017-11-14T09:15:50Z
MediaIdstring

媒资 ID。

1c6ce34007d571ed94667630a6bc****
Tagsstring

标签列表。

标签1, 标签2
Descriptionstring

描述。

阿里云VOD视频描述
AppIdstring

应用 ID。默认取值:app-1000000。

app-1000000
Sizelong

源文件大小。单位:字节。

10897890
CoverUrlstring

封面 URL。

http://example.aliyundoc.com/snapshot/****.jpg?auth_key=1498476426-0-0-f00b9455c49a423ce69cf4e27333****
Durationfloat

时长(单位:秒)。

12.2
Titlestring

标题。

史上最牛音乐播放器
Snapshotsarray

视频截图 URL 数组。

Snapshotsstring

视频截图 URL。

http://example.aliyundoc.com/snapshot/****.jpg?auth_key=1498476426-0-0-f00b9455c49a423ce69cf4e27333****
Totallong

符合条件的媒资总数。

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-12OpenAPI 入参发生变更查看变更详情