文档首页/ 云空间服务 KooDrive/ API参考/ API/ 文件管理/ 生成视频缩略图任务接口 - createVideoThumbnailTask
更新时间：2026-03-04 GMT+08:00
查看PDF
分享

生成视频缩略图任务接口 - createVideoThumbnailTask

功能介绍

生成视频缩略图任务接口

授权信息

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

URI

POST /koodrive/ose/v1/video/thumbnail

请求参数

表1 请求Header参数

参数

是否必选

参数类型

描述

Authorization

是

String

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

X-Traceid

否

String

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

language

否

String

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

X-User-Id

是

String

用户id，用于app鉴权

X-Date

是

String

日期，用于app鉴权

x-hw-share-folder-id

否

String

参数解释：

共享文件夹ID。如果传入了该请求头，则说明当前的操作是在共享文件夹内。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及
表2 请求Body参数

参数

是否必选

参数类型

描述

fileId

是

String

文件ID

containerId

是

String

空间ID

userId

是

String

用户ID

响应参数

状态码：200

表3 响应Body参数

参数

参数类型

描述

code

Integer

响应码

msg

String

响应信息

请求示例

生成视频缩略图任务接口请求体示例

/koodrive/ose/v1/video/thumbnail

Authorization:Bearer+10f88d07fa************44791e9ff
{
  "containerId": "IAAAKIRZGifzJgncA1605122035640590977",
  "fileId": "FkiferVNK5NwXck7XXBhPLIRhV1GayJPc",
  ”userId“: "1605107117323346560"
}

响应示例

状态码：200

生成视频缩略图任务响应体

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

状态码

状态码

描述

200

生成视频缩略图任务响应体
父主题： 文件管理