Skip to main content
이 가이드는 이미지에서 비가시성 워터마크를 검출하는 과정을 안내합니다 — 주문 생성부터 검출 결과 확인까지. 모든 엔드포인트는 순수 HTTPS와 JSON을 사용하므로 서버에서든 브라우저에서든 동일하게 호출할 수 있습니다. 각 단계에는 React 탭이 포함되어 있으며, 페이지 하단에서 전체 복사 붙여넣기 컴포넌트를 확인할 수 있습니다.

사전 준비

  • BIZ MORI API 키 (여기서 발급)
  • 비가시성 워터마크가 삽입된 이미지 파일 (jpeg, jpg, png, webp, bmp, 또는 tiff) 또는 PDF
자동 발급된 sk_test_로 실제 워터마크 검출이나 크레딧 사용 없이 주문 흐름을 검증할 수 있습니다. 테스트 업로드는 파일 내용을 폐기하고 결정적인 검출 상태를 반환합니다. 실제 파일에서 워터마크를 추출하려면 일반 API 키를 사용하세요.

1단계: 주문 생성

비가시성 워터마크 검출 주문을 생성합니다.
응답:
보다 정확한 검출을 위해 원본(비가시성 워터마크 삽입 전) 이미지를 함께 제공할 수 있습니다. 자세한 사용 방법은 API 레퍼런스를 참고하세요.

2단계: 파일 업로드

1단계 응답의 uploadUrl로 파일을 PUT 업로드합니다. Authorization 헤더는 필요 없습니다 — S3 직접 업로드입니다.
별도의 확인(confirm) 단계가 필요 없습니다. 비가시성 워터마크 삽입과 마찬가지로, 파일 업로드가 완료되면 검출 처리가 자동으로 시작됩니다. 업로드 후 바로 결과를 확인하시면 됩니다.
live 키는 S3 presigned URL을 받고, 테스트 키는 https://api.bizmori.com/api/v2/test-uploads/{signedToken}을 받습니다. 두 URL 모두 1시간 후 만료되며 같은 방식으로 Authorization 헤더 없이 PUT합니다. 테스트 업로드는 스트림으로만 소비되고 저장·처리되지 않습니다. 만료되면 URL 갱신을 사용하세요.

3단계: 결과 확인

주문 상태를 폴링하거나 웹훅을 설정하여 검출 완료 알림을 받습니다.
응답 (비가시성 워터마크 검출됨):
응답 (비가시성 워터마크 미검출):
status로 작업 완료 여부를 확인한 뒤, statusCode로 결과를 읽으세요:

전체 React 예제

위 내용을 모두 하나의 컴포넌트로 연결했습니다: 진행률을 보여주는 단일 파일 업로드, 백오프 폴링, 그리고 statusCode로 렌더링하는 검출 결과까지. React 외에 별도의 의존성은 없습니다.
WatermarkExtractChecker.jsx
import.meta.env.VITE_MORI_API_TOKEN은 Vite 문법입니다. Next.js에서는 process.env.NEXT_PUBLIC_MORI_API_TOKEN을 사용하거나, 사용 중인 번들러가 클라이언트 코드에 노출하는 방식을 사용하세요. crypto.randomUUID()는 보안 컨텍스트에서만 동작합니다. HTTPS와 localhost에서는 문제없지만, 일반 HTTP LAN 주소에서는 사용할 수 없습니다.
공개 결과에는 statusCode와 검출된 경우 watermarkText만 포함되며 MID는 포함되지 않습니다.

에러 처리

전체 에러 코드는 에러 코드 페이지를 참고하세요.

다음 단계

Anti-AI

이미지를 AI 학습 및 생성으로부터 보호합니다.

워터마크 삽입

이미지에 비가시성 워터마크를 삽입합니다.

AI Detection

AI 생성 이미지를 확률 점수로 탐지합니다.

웹훅

처리 완료 시 알림을 받기 위해 웹훅을 설정합니다.