文档首页/ 云空间服务 KooDrive/ API参考/ API/ AI云服务相关/ 添加AI文件通知 - AiFileResourceNotice
更新时间：2026-06-16 GMT+08:00
查看PDF
分享

添加AI文件通知 - AiFileResourceNotice

功能介绍

添加AI文件通知

授权信息

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

URI

POST /koodrive/ose/v1/fileresource/ai/notice

请求参数

表1 请求Header参数

参数

是否必选

参数类型

描述

Authorization

是

String

该字段存储的是Access Token。调用KooDrive的API使用Token认证，拥有Token就代表拥有某种权限，在调用API的时候将Token加到请求消息头中，从而通过身份认证，获得操作API的权限。Access Token的获取请参考对应的开发手册，格式参考：Bearer+{access_token}

X-User-Id

是

String

用户id，用于app鉴权

X-Date

是

String

日期，用于app鉴权

X-Traceid

否

String

消息日志跟踪标识（必须58位）

language

否

String

国际化语言标识，符合i18n规范，如zh-CN表示简体中文，en-US表示美式英语，不传默认美式英语

X-AIUser-Id

是

String

用户id，用于appId鉴权，与X-User-Id必选其一，都存在时以X-AIUser-Id的值为准
表2 请求Body参数

参数

是否必选

参数类型

描述

changedFileInfoList

否

Array of changedFileInfoList objects

要触发ai整理通知的文件id列表
表3 changedFileInfoList

参数

是否必选

参数类型

描述

fileId

是

String

文件ID

videoMetaInfo

否

VideoMetaInfo object

视频元数据信息

resourceId

是

String

资源ID

resourceState

是

String

资源类型

contextInfo

是

contextInfo object

上下文通知
表4 VideoMetaInfo

参数

是否必选

参数类型

描述

createTime

否

String

创建时间

shotTime

否

String

拍摄时间

address

否

String

拍摄地址
表5 contextInfo

参数

是否必选

参数类型

描述

fullProcessFlag

是

String

全流程处理标记

响应参数

状态码：200

表6 响应Body参数

参数

参数类型

描述

code

Integer

响应码

msg

String

响应信息

状态码：401

表7 响应Body参数

参数

参数类型

描述

code

Integer

响应码

msg

String

响应信息

请求示例

添加AI文件通知请求体

/koodrive/ose/v1/fileresource/ai/notice

{
  "changedFileInfoList" : [ {
    "fileId" : "fengTest",
    "resourceId" : "fengTest",
    "resourceState" : "aifunc",
    "contextInfo" : {
      "fullProcessFlag" : "voice"
    }
  } ]
}

响应示例

状态码：200

添加AI文件通知响应成功

{
  "code" : 0,
  "msg" : "success"
}

状态码

状态码

描述

200

添加AI文件通知响应成功

401

鉴权失效
父主题： AI云服务相关

相关文档