개발가이드

  • 개발가이드

동영상 미리보기 이미지 추출

동영상에서 일정 구간마다 미리보기 이미지를 추출합니다.

추출할 썸네일 개수를 최대 200개까지 지정이 가능하며, 재생시간(초)보다 추출할 이미지 개수가 많은 경우 1초당 1개씩 재생시간(초) 만큼 추출됩니다. 추출된 이미지 파일은 압축파일(.zip)로 압축됩니다.

정보

Method
URL
POST
https://apick.app/rest/extract_video_thumbnail

요청

Header
이름
필수
설명
CL_AUTH_KEY
O
인증키(MD5)
FormData
이름
타입
필수
설명
video
File
O
동영상 파일
width
String
X
이미지 가로 길이(기본값 480)
세로 길이는 가로 길이 비율에 따라 자동 계산
count
String
X
추출할 이미지 개수

응답

Header
이름
필수
설명
success
O
API 서버 정상 응답 여부
cost
O
API 호출 요금
ms
O
API 응답 시간
Content-Type
O
응답 바디 데이터 타입
Content-Disposition
O
파일명
(output 고정)
Body
이름
타입
설명
zip 형식의 바이너리 데이터

예시

요청 예시

curl -k -X POST "https://apick.app/rest/extract_video_thumbnail" \
-H "CL_AUTH_KEY: $API_KEY" \
-F "video=@/C:/Users/user/Desktop/sample_video.mp4" \
-F "width=1920" \
-F "count=36"
응답 예시

{zip 형식의 바이너리 데이터}
현재 페이지 북마크