文档首页/ 云空间服务 KooDrive/ API参考/ API/ AI_saas服务调用接口_以文搜图/ 语义搜图 - IIntelligentsearchPicture
更新时间：2025-10-22 GMT+08:00
查看PDF
分享

语义搜图 - IIntelligentsearchPicture

功能介绍

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

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

授权信息

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

URI

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

请求参数

表1 请求Header参数

参数

是否必选

参数类型

描述

Authorization

是

String

鉴权头

X-Date

是

String

签名时间，用于appId鉴权

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"
}

状态码

状态码

描述

200

语义搜图响应体

401

鉴权失效

相关文档