동영상의 썸네일 이미지를 조회합니다.
썸네일 이미지는 동영상 업로드 시 전체 재생시간에서 구간별로 6장을 추출합니다.
- 과도한 API 요청이 발생하는 경우 사용량이 제한될 수 있습니다.
- 비정상적인 사용 패턴이 발견되는 경우 API 이용이 제한될 수 있습니다.
- 현재 제공 중인 API의 종류 및 내용은 더 나은 API 서비스 제공을 위해 변경 및 업데이트 될 수 있습니다.
※ 썸네일 이미지 조회 API는 조회 후 썸네일 이미지를 주소를 저장하여 사용하는 것을 목적으로 합니다.
Request URL
GET https://api.v4.wecandeo.com/info/videopack/thumbnail/v1/info.json?accessKey={Access Key}
Request Parameters
| Parameter Name | Type | Description |
|---|---|---|
| accessKey (Required) | String | 원본 키 (Access Key) |
Response Example
{
"videoThumbnails": {
"representThumbnail": {
"seq": 2,
"selected": true,
"playTime": 19,
"originalUrl": "https://{DOMAIN}/thumb/20230504/21/a86071a7-26b6-49f6-a027-35651309aca3_2ed87c28-6be2-464b-a7a0-999d609c30b2.jpg"
},
"thumbnails": [
{
"seq": 0,
"selected": false,
"playTime": 1,
"originalUrl": "https://{DOMAIN}/thumb/20230504/21/a86071a7-26b6-49f6-a027-35651309aca3_b9887e1a-884c-42c9-bd85-9267a3acbab2.jpg"
},
{
"seq": 1,
"selected": false,
"playTime": 10,
"originalUrl": "https://{DOMAIN}/thumb/20230504/21/a86071a7-26b6-49f6-a027-35651309aca3_caea33ca-d79c-4b3c-9b89-65ea5cf5fef9.jpg"
},
{
"seq": 2,
"selected": true,
"playTime": 19,
"originalUrl": "https://{DOMAIN}/thumb/20230504/21/a86071a7-26b6-49f6-a027-35651309aca3_2ed87c28-6be2-464b-a7a0-999d609c30b2.jpg"
},
{
"seq": 3,
"selected": false,
"playTime": 28,
"originalUrl": "https://{DOMAIN}/thumb/20230504/21/a86071a7-26b6-49f6-a027-35651309aca3_c7f693fb-8610-44c2-b20f-afc344a4b7de.jpg"
},
{
"seq": 4,
"selected": false,
"playTime": 37,
"originalUrl": "https://{DOMAIN}/thumb/20230504/21/a86071a7-26b6-49f6-a027-35651309aca3_8f77b35f-6338-4c20-a9d3-6ea8098fdd79.jpg"
},
{
"seq": 5,
"selected": false,
"playTime": 46,
"originalUrl": "https://{DOMAIN}/thumb/20230504/21/a86071a7-26b6-49f6-a027-35651309aca3_424b6c52-7d4d-4e40-b2f1-a2691eb30efd.jpg"
}
]
}
}
Response Data Value
| Name | Type | Description |
|---|---|---|
| representThumbnail | - | 대표로 지정된 썸네일 |
| selected | Boolean | 대표 이미지 선택 여부 |
| seq | Integer | 이미지 번호 |
| playTime | Integer | 이미지 추출 장면의 시간 (second) |
| originalUrl | String | 썸네일 이미지 URL |