# 图片元数据提取接口 - IExtractPictureFeature
#### 功能介绍
图片元数据提取接口
#### 授权信息
当前API调用无需身份策略权限。
#### URI
POST /koodrive/ose/v1/aisaas/picture/feature/extract
#### 请求参数
表1请求Header参数 
| 参数            | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                    |
|:---|:---|:---|:---|
| X-Date        | 是    | String | 参数解释：签名时间，用于appId鉴权 约束限制：距当前时间15分钟以内，不能晚于当前时间 取值范围：日期格式，yyyMMdd'T'HHmmss'Z'，例：20251103T070140Z 默认取值：不涉及 |
| Authorization | 是    | String | 鉴权头                                                                                                                                                                                                                                   |
| X-User-Id     | 是    | String | 用户id，不用于appId鉴权                                                                                                                                                                                                                       |
| language      | 否    | String | 国际化语言标识，符合i18n规范，如zh-CN表示简体中文，en-US表示美式英语，不传默认美式英语                                                                                                                                                                                    |
| X-AIUser-Id   | 否    | String | 用户id，用于appId鉴权，与X-User-Id必选其一，都存在时以X-AIUser-Id的值为准                                                                                                                                                                                    |
   
表2请求Body参数 
| 参数       | 是否必选 | 参数类型                                                                   | 描述                                                                                                                                                                                                                                                                                       |
|:---|:---|:---|:---|
| sendType | 是    | Integer                                                                | 传送类型 1------url传送 2------base64传送 3------文件信息 4------共享存储文件路径 注：目前仅支持1 |
| fileUrl  | 是    | String                                                                 | 文件下载地址                                                                                                                                                                                                                                                                                   |
| fileInfo | 是    | Array of [FileInfo] objects | 文件信息                                                                                                                                                                                                                                                                                     |
   
 表3FileInfo 
| 参数         | 是否必选 | 参数类型   | 描述                                                              |
|:---|:---|:---|:---|
| createTime | 是    | Long   | 上传时间 时间戳，UTC时间        |
| shotTime   | 否    | Long   | 拍摄时间 时间戳，UTC时间        |
| address    | 否    | String | 地址信息 参考格式"北京市海淀区xx街道" |
   
#### 响应参数
**状态码：200**
表4响应Body参数 
| 参数     | 参数类型   | 描述   |
|:---|:---|:---|
| fileId | String | 文件id |
   
**状态码：401**
表5响应Body参数 
| 参数   | 参数类型   | 描述   |
|:---|:---|:---|
| code | String | 状态码  |
| msg  | String | 状态描述 |
   
#### 请求示例
从图片中提取信息
```
/koodrive/ose/v1/aisaas/picture/feature/extract
{
    "requestId":"123",
    "sendType":1,
    "fileUrl":"https://XXX.XXX.com/download/jpg/XXX.jpg",
    "base64":"123",
    "fileInfo":{
        "createTime": 2025XXXX
    },
    "userId": "d165465dsf",
    "fileId": "FILE_20250620"
}
```
#### 响应示例
**状态码：200**
图片元数据提取接口响应体
```
{
  "code" : "0",
  "message" : "",
  "success" : true,
  "data" : {
    "requestId" : "123",
    "fileId" : "FILE_20250620",
    "extra" : ""
  }
}
```
#### 状态码
| 状态码 | 描述           |
|:---|:---|
| 200 | 图片元数据提取接口响应体 |
| 401 | 鉴权失效         |