更新时间：2026-08-10 GMT+08:00
获取视频第一帧图片（API名称：video/grabImage）
功能介绍
视频上传并获取第一帧缩略图
相关接口
| 接口名称 | 调用说明 |
|---|---|
| 调用该接口获取到Token，再调用其他接口时，需要在请求消息头中添加“Authorization”，其值即为Token。 |
URL
| 请求方式 | HTTPS地址 | 服务架构 | 消息体类型 |
|---|---|---|---|
| POST | https://isdp+域名/openapi/openFile/v1/video/grabImage | OpenAPI | application/json |
请求头
| KEY | VALUE | 是否必填 | 描述 |
|---|---|---|---|
| Content-Type | application/json | 是 | 无 |
| Authorization | bearer ${access_token} | 是 | bearer +“ ”+5.2.1中获取的access_token的值 |
请求参数
| 参数 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| Width | int | 否 | 缩略的宽度 |
| height | int | 否 | 缩略的高度 |
| forceRatio | Boolean | 否 | 是否强制按照宽高生成缩略图(如果为false，则生成最佳比例缩略图) |
| upload | file | 是 | 文件 |
| funcPoint | String | 是 | 功能点 |
响应参数
| 参数 | 类型 | 描述 |
|---|---|---|
| imageId | int | 图片id |
| videoId | int | 视频id |
请求示例
响应示例
{
"status": "200 OK",
"msg": "",
"data": {
"seconds": 178,
"imageId": 7671884,
"videoId": 7671885
},
"success": false,
"failed": false
} 父主题： 基础数据管理
