语义搜图 - IIntelligentsearchPicture

功能介绍

语义搜图接口，支持时间、地点、语义、事物标签、人名标签、关系标签搜索。

时间、地点、事物标签、人名标签、关系标签依赖上游传入，为逻辑搜索。

授权信息

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

URI

POST /koodrive/ose/v1/aisaas/picture/intelligentsearch

请求参数

表1 请求Header参数
参数	是否必选	参数类型	描述
Authorization	是	String	鉴权头
X-Date	是	String	参数解释：签名时间，用于appId鉴权约束限制：距当前时间15分钟以内，不能晚于当前时间取值范围：日期格式，yyyMMdd'T'HHmmss'Z'，例：20251103T070140Z 默认取值：不涉及
X-AIUser-Id	否	String	用户id，用于appId鉴权，与X-User-Id必选其一，都存在时以X-AIUser-Id的值为准
X-User-Id	是	String	用户id，不用于appId鉴权
language	否	String	国际化语言标识，符合i18n规范，如zh-CN表示简体中文，en-US表示美式英语，不传默认美式英语

表2 请求Body参数
参数	是否必选	参数类型	描述
query	是	String	搜索文本
pageInfo	否	PageInfo object	分页信息
sortType	否	Integer	排序方式（不填默认1） 1--按图片拍摄时间倒序排序（如拍摄时间为空则用上传时间） 2--按图片拍摄时间正序排序（如拍摄时间为空则用上传时间） 3--按照相关度倒序排序

表3 PageInfo
参数	是否必选	参数类型	描述
pageSize	否	Integer	每页显示数量默认为10，最大限制100，最小限制 10
pageCursor	否	String	起始游标，为空时从第一页开始查询
needTotalCount	否	Integer	是否返回总数（0 不返回，1返回），默认值为0

响应参数

状态码：200

表4 响应Body参数
参数	参数类型	描述
photos	Array of ImageSearchInfo objects	图片信息列表
nextPageCursor	String	游标
totalCount	Integer	总数

表5 ImageSearchInfo
参数	参数类型	描述
fileId	String	文件ID
score	Double	分数
createTime	Long	上传时间
shotTime	Long	拍摄时间

状态码：401

表6 响应Body参数
参数	参数类型	描述
code	String	状态码
msg	String	状态描述

请求示例

语义搜图请求体

/koodrive/ose/v1/aisaas/picture/intelligentsearch

{
  "query" : "word"
}

响应示例

状态码：200

语义搜图响应体

{
    "nextPageCursor": "",
    "photos": [
        {
            "fileId": "FILE_1729*************",
            "score": 0.238,
            "createTime": 1752458298,
            "shotTime": 0
        },
        {
            "fileId": "FILE_1729*************"",
            "score": 0.689,
            "createTime": 1752458298,
            "shotTime": 0
        }
    ],
    "code": 0,
    "msg": "success"
}