동영상의 썸네일 이미지를 조회합니다.
썸네일 이미지는 동영상 업로드 시 듀레이션 구간별로 6장을 추출합니다.
추출된 각 이미지는 width를 기준으로 원본사이즈, 160px, 320px, 640px의 사이즈 별로 조회됩니다.
- 과도한 API 요청이 발생하는 경우 사용량이 제한될 수 있습니다.
- 또한 현재 제공 중인 API의 종류 및 내용은 더 나은 API 서비스 제공을 위해 변경 및 업데이트될 수 있습니다.
※ 썸네일 이미지 조회 API는 조회 후 썸네일 이미지를 다운로드하여 별도 보관소에 저장하여 사용하는 것을 목적으로 합니다.
Request URL
GET https://api.wecandeo.com/info/v2/video/thumbnails.json?key={API key}&access_key={access_key}
Request Parameters
| Parameter Name | Type | Description |
|---|---|---|
| key (Required) | String | API 키 |
| access_key (Required) | String | 원본 키 (Original Key – Video Access Key_Level 1) |
Response Example
{
"videoThumbnails": {
"representThumbnail": {
"seq": 3,
"selected": true,
"playtime": 19,
"originalUrl": "https://timgs.wecandeo.com/thumb/2836/20190904/15/V8897876_5509_fd3d1c6_00001.jpg",
"variantUrl": [
{
"size": 160,
"url": "https://timgs.wecandeo.com/thumb/2836/20190904/15/V8897876_5509_fd3d1c6_00001_160_90.jpg"
}, {
"size": 320,
"url": "https://timgs.wecandeo.com/thumb/2836/20190904/15/V8897876_5509_fd3d1c6_00001_320_180.jpg"
}, {
"size": 640,
"url": "https://timgs.wecandeo.com/thumb/2836/20190904/15/V8897876_5509_fd3d1c6_00001_640_360.jpg"
}
]
},
"errorInfo": {
"errorCode": "None",
"errorMessage": ""
},
"thumbnails": [
{
"seq": 1,
"selected": false,
"playtime": 1,
"originalUrl": "https://timgs.wecandeo.com/thumb/2836/20190904/15/V8897876_5508_1427c0b_00000.jpg",
"variantUrl": [
{
"size": 160,
"url": "https://timgs.wecandeo.com/thumb/2836/20190904/15/V8897876_5508_1427c0b_00000_160_90.jpg"
}, {
"size": 320,
"url": "https://timgs.wecandeo.com/thumb/2836/20190904/15/V8897876_5508_1427c0b_00000_320_180.jpg"
}, {
"size": 640,
"url": "https://timgs.wecandeo.com/thumb/2836/20190904/15/V8897876_5508_1427c0b_00000_640_360.jpg"
}
]
},
{
"seq": 2,
"selected": false,
"playtime": 10,
"originalUrl": "https://timgs.wecandeo.com/thumb/2836/20190904/15/V8897876_5509_fd3d1c6_00000.jpg",
"variantUrl": [
{
"size": 160,
"url": "https://timgs.wecandeo.com/thumb/2836/20190904/15/V8897876_5509_fd3d1c6_00000_160_90.jpg"
}, {
"size": 320,
"url": "https://timgs.wecandeo.com/thumb/2836/20190904/15/V8897876_5509_fd3d1c6_00000_320_180.jpg"
}, {
"size": 640,
"url": "https://timgs.wecandeo.com/thumb/2836/20190904/15/V8897876_5509_fd3d1c6_00000_640_360.jpg"
}
]
},
{
"seq": 3,
"selected": true,
"playtime": 19,
"originalUrl": "https://timgs.wecandeo.com/thumb/2836/20190904/15/V8897876_5509_fd3d1c6_00001.jpg",
"variantUrl": [
{
"size": 160,
"url": "https://timgs.wecandeo.com/thumb/2836/20190904/15/V8897876_5509_fd3d1c6_00001_160_90.jpg"
}, {
"size": 320,
"url": "https://timgs.wecandeo.com/thumb/2836/20190904/15/V8897876_5509_fd3d1c6_00001_320_180.jpg"
}, {
"size": 640,
"url": "https://timgs.wecandeo.com/thumb/2836/20190904/15/V8897876_5509_fd3d1c6_00001_640_360.jpg"
}
]
},
{
"seq": 4,
"selected": false,
"playtime": 28,
"originalUrl": "https://timgs.wecandeo.com/thumb/2836/20190904/15/V8897876_5509_fd3d1c6_00002.jpg",
"variantUrl": [
{
"size": 160,
"url": "https://timgs.wecandeo.com/thumb/2836/20190904/15/V8897876_5509_fd3d1c6_00002_160_90.jpg"
}, {
"size": 320,
"url": "https://timgs.wecandeo.com/thumb/2836/20190904/15/V8897876_5509_fd3d1c6_00002_320_180.jpg"
}, {
"size": 640,
"url": "https://timgs.wecandeo.com/thumb/2836/20190904/15/V8897876_5509_fd3d1c6_00002_640_360.jpg"
}
]
}, {
"seq": 5,
"selected": false,
"playtime": 37,
"originalUrl": "https://timgs.wecandeo.com/thumb/2836/20190904/15/V8897876_5509_fd3d1c6_00003.jpg",
"variantUrl": [
{
"size": 160,
"url": "https://timgs.wecandeo.com/thumb/2836/20190904/15/V8897876_5509_fd3d1c6_00003_160_90.jpg"
}, {
"size": 320,
"url": "https://timgs.wecandeo.com/thumb/2836/20190904/15/V8897876_5509_fd3d1c6_00003_320_180.jpg"
}, {
"size": 640,
"url": "https://timgs.wecandeo.com/thumb/2836/20190904/15/V8897876_5509_fd3d1c6_00003_640_360.jpg"
}
]
}, {
"seq": 6,
"selected": false,
"playtime": 46,
"originalUrl": "https://timgs.wecandeo.com/thumb/2836/20190904/15/V8897876_5510_39c449e_00000.jpg",
"variantUrl": [
{
"size": 160,
"url": "https://timgs.wecandeo.com/thumb/2836/20190904/15/V8897876_5510_39c449e_00000_160_90.jpg"
}, {
"size": 320,
"url": "https://timgs.wecandeo.com/thumb/2836/20190904/15/V8897876_5510_39c449e_00000_320_180.jpg"
}, {
"size": 640,
"url": "https://timgs.wecandeo.com/thumb/2836/20190904/15/V8897876_5510_39c449e_00000_640_360.jpg"
}
]
}
]
}
}
Response Data Value
| Name | Type | Description |
|---|---|---|
| representThumbnail | - | 대표로 지정된 썸네일 |
| selected | Boolean | 대표 이미지 선택 여부 |
| seq | Integer | 이미지 번호 |
| playtime | Integer | 이미지 추출 장면의 시간 (second) |
| originalUrl | String | 원본 사이즈 URL |
| size | Integer | 이미지 사이즈 |
| url | String | 썸네일 이미지 URL |