# 语义搜图 - 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--按照相关度倒序排序 |
   
 表3PageInfo 
| 参数             | 是否必选 | 参数类型    | 描述                          |
|:---|:---|:---|:---|
| pageSize       | 否    | Integer | 每页显示数量默认为10，最大限制100，最小限制 10 |
| pageCursor     | 否    | String  | 起始游标，为空时从第一页开始查询            |
| needTotalCount | 否    | Integer | 是否返回总数（0 不返回，1返回），默认值为0     |
   
#### 响应参数
**状态码：200**
表4响应Body参数 
| 参数             | 参数类型                                                                                     | 描述     |
|:---|:---|:---|
| photos         | Array of [ImageSearchInfo] objects | 图片信息列表 |
| nextPageCursor | String                                                                                   | 游标     |
| totalCount     | Integer                                                                                  | 总数     |
   
 表5ImageSearchInfo 
| 参数         | 参数类型   | 描述   |
|:---|:---|:---|
| 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 | 鉴权失效    |