API 문서

파일 워터마크와 비디오 프레임 추출 API를 제공합니다. 모든 경로는 현재 사이트 기준 상대 경로입니다.

워터마크

POST/api/watermark/

multipart/form-data로 이미지 또는 PDF와 워터마크 문구를 전송하면, 문구와 현재 시간을 반투명 대각선으로 합성합니다.

필수 필드: file, text (최대 120자)
지원 형식: 이미지(image/*), PDF(application/pdf)
성공 시 생성 파일의 번호, 이름, URL, 생성 시간을 JSON으로 반환
지원하지 않는 파일 또는 file 누락 시 400 반환

{
  "message": "Watermark added successfully.",
  "seq": 123,
  "name": "example_watermarked.png",
  "watermark_text": "CONFIDENTIAL",
  "file_url": "/media/files/...",
  "created_at": "2026-09-05T..."
}

워터마크 테스트 열기

비디오 프레임 추출

POST/api/videos/upload/

비디오 파일을 업로드해 비동기 프레임 추출 작업을 시작합니다.

필수 필드: file
선택 필드: fps_option (기본값 1), keep_original (기본값 false)
성공 시 작업 ID와 PENDING 상태를 202로 반환

GET/api/videos/tasks/<task_id>/

작업 상태(PENDING, PROCESSING, COMPLETED, FAILED)를 조회합니다.

GET/api/videos/tasks/<task_id>/images/

완료된 작업의 프레임 이미지 URL과 시점 정보를 조회합니다. 완료 전 요청은 400을 반환합니다.

비디오 테스트 열기

사용 시 참고

브라우저에서 호출할 때는 현재 페이지와 같은 HTTPS 도메인으로 요청하세요. 숫자 IP의 HTTP API 호출은 HTTPS 페이지에서 혼합 콘텐츠로 차단될 수 있습니다.

워터마크와 비디오 API 모두 업로드 파일을 서버 저장소에 보관합니다.