동영상의 썸네일 이미지를 조회합니다.

썸네일 이미지는 동영상 업로드 시 듀레이션 구간별로 6장을 추출합니다.
추출된 각 이미지는 height를 기준으로 원본사이즈, 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 NameTypeDescription
key (Required)StringAPI 키
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

NameTypeDescription
representThumbnail대표로 지정된 썸네일
selectedBoolean대표 이미지 선택 여부
seqInteger이미지 번호
playtimeInteger이미지 추출 장면의 시간 (second)
originalUrlString원본 사이즈 URL
sizeInteger이미지 사이즈
urlString썸네일 이미지 URL