文档首页/ 云空间服务 KooDrive/ API参考/ API/ AI_saas服务调用接口/ 综合搜索视频搜索 - EnhancedSearch
更新时间：2026-06-16 GMT+08:00
查看PDF
分享

综合搜索视频搜索 - EnhancedSearch

功能介绍

授权信息

当前API调用无需身份策略权限。

URI

POST /koodrive/ose/v1/media/enhanced/search

请求参数

表1 请求Body参数

参数

是否必选

参数类型

描述

type

是

Integer

搜索类型：0组合搜索；1语义搜索（包含 短词、长文本语义、小目标检查）；2以图搜图；

content

否

String

长文本

imgUrl

否

String

图片的Base64,例如： data:image/png;base64,{base64_image}

conditions

否

conditions object

组合搜索条件

similarity

否

Double

相似度阈值

videoType

否

Integer

视频类型：

pageInfo

否

pageInfo object

分页信息

sortInfo

否

sortInfo object

排序信息
表2 conditions

参数

是否必选

参数类型

描述

time

否

String

时间。 完整时间范围：YYYY-MM-DD HH:MM:SS~YYYY-MM-DD HH:MM:SS

完整精确：YYYY-MM-DD HH:MM:SS /YYYY-MM-DD / HH:MM:SS

place

否

String

地点

target

否

String

目标

scene

否

String

场景

smallTarget

否

Boolean

是否为小目标
表3 pageInfo

参数

是否必选

参数类型

描述

cursor

否

String

游标

count

否

Integer

最大查询数量，最大1000
表4 sortInfo

参数

是否必选

参数类型

描述

sortType

否

Integer

排序类型 0匹配度（默认）；1时间（先取拍摄时间，再取创建时间）；2视频时长

sortOrder

否

Integer

排序顺序 0顺序 ，1倒序（默认）

响应参数

状态码：200

表5 响应Body参数

参数

参数类型

描述

code

String

状态码

msg

String

状态描述

data

data object

响应结构体
表6 data

参数

参数类型

描述

contentList

Array of contentList objects

搜索响应列表

nextCursor

String

下一页游标
表7 contentList

参数

参数类型

描述

fileId

String

视频文件ID

fileName

String

文件名

videoCoverUrl

String

视频封面图片

videoDuration

String

视频时长

videoType

Integer

视频培训

hitFrameList

Array of hitFrameList objects

命中关键帧列表
表8 hitFrameList

参数

参数类型

描述

frameId

String

命中关键帧ID

startTime

String

命中关键帧开始时间

matchScore

String

相似度得分

matchInfo

String

匹配信息：例如 【短词精准命中：手机】| 场景：户外 | 时间：白天

请求示例

无

响应示例

无

状态码

状态码

描述

200

搜索视频响应

相关文档