# 获取视频第一帧图片（API名称：video/grabImage）
#### 功能介绍
视频上传并获取第一帧缩略图
#### 相关接口
| **接口名称**                                                             | **调用说明**                                                     |
|:---|:---|
| [获取Token](https://support.huaweicloud.com/api-isdp/api_01_0019.html) | 调用该接口获取到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](https://support.huaweicloud.com/api-isdp/api_01_0019.html)中获取的access_token的值 |
   
#### 请求参数
| **参数**     | **类型**  | **是否必填** | **描述**                             |
|:---|:---|:---|:---|
| Width      | int     | 否        | 缩略的宽度                              |
| height     | int     | 否        | 缩略的高度                              |
| forceRatio | Boolean | 否        | 是否强制按照宽高生成缩略图(如果为false，则生成最佳比例缩略图) |
| upload     | file    | 是        | 文件                                 |
| funcPoint  | String  | 是        | 功能点                                |
   
#### 响应参数
| **参数**  | **类型** | **描述** |
|:---|:---|:---|
| imageId | int    | 图片id   |
| videoId | int    | 视频id   |
   
#### 请求示例
![](https://support.huaweicloud.com/api-isdp/zh-cn_image_0000002522734563.png "点击放大")
#### 响应示例
```
{
    "status": "200 OK",
    "msg": "",
    "data": {
        "seconds": 178,
        "imageId": 7671884,
        "videoId": 7671885
    },
    "success": false,
    "failed": false
}
```