{"openapi":"3.0.3","info":{"title":"APICK 동영상 미리보기 이미지 추출","version":"1.0.0","description":"동영상 파일 한 개를 올리면 재생시간을 고르게 나눈 지점마다 장면을 JPEG 이미지로 뽑아 ZIP 파일 하나로 돌려줍니다. 응답은 JSON이 아닌 ZIP 파일입니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/extract_video_thumbnail":{"post":{"summary":"동영상 미리보기 이미지 추출","description":"동영상 파일 한 개를 올리면 재생시간을 고르게 나눈 지점마다 장면을 JPEG 이미지로 뽑아 ZIP 파일 하나로 돌려줍니다. 응답은 JSON이 아닌 ZIP 파일입니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"파일 직접 응답","content":{"application/zip":{"schema":{"type":"string","format":"binary"}}}},"default":{"description":"HTTP 상태 및 서비스 오류코드 확인","content":{"application/json":{"schema":{"type":"object"}}}}},"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"video":{"type":"string","description":"처리할 동영상 파일입니다. 지원 확장자·최대 길이·용량은 상품별로 다릅니다. (file)","format":"binary"},"width":{"type":"string","description":"이미지 가로 길이 (범위: 100 ~ 2000, 기본값 480). 세로 길이는 가로 비율에 따라 자동 계산 (string)","example":"480"},"count":{"type":"string","description":"영상에서 추출할 썸네일 이미지 수입니다. 0~200 범위이며, 생략하면 100장을 추출합니다. 값이 클수록 처리 시간과 응답 크기가 늘어납니다. (string)","example":"10"}},"required":["video"]}}}}}}},"x-code-tables":[{"title":"오류와 대처","columns":["HTTP","data.error","대처"],"rows":[["400","파일 유형이 맞지 않습니다. 동영상 형식의 파일만 허용됩니다.","동영상 파일인지 확인하세요."],["424","첨부파일이 없습니다.","파일 필드 이름을 video로 보냈는지 확인하세요."],["424","알 수 없는 이유로 실패했습니다.","영상이 손상되지 않았는지 확인하고 다시 요청하세요."],["408","처리 시간 초과로 실패했습니다.","data.success가 3입니다. count를 줄이거나 영상을 나눠 요청하세요."]]}],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}