文档首页/云空间服务 KooDrive/API参考/API/AI_saas服务调用接口_以文搜图/图片元数据提取接口 - IExtractPictureFeature
更新时间：2026-02-03 GMT+08:00
查看PDF
分享

图片元数据提取接口 - 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

文件信息

表3 FileInfo

参数

是否必选

参数类型

描述

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

鉴权失效

相关文档