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

사전 준비

  • BIZ MORI API 키 (여기서 발급)
  • 비가시성 워터마크를 삽입할 파일 (jpeg, jpg, png, webp, tiff, bmp, 또는 pdf)
자동 발급된 sk_test_로 실제 워터마크 처리를 실행하거나 크레딧을 사용하지 않고 주문 흐름을 검증할 수 있습니다. 테스트 업로드는 파일 내용을 폐기하며 다운로드 가능한 결과를 만들지 않습니다. 실제 워터마크 파일을 얻으려면 일반 API 키를 사용하세요.

1단계: 주문 생성

워터마크 텍스트와 함께 비가시성 워터마크 삽입 주문을 생성합니다.
응답:

2단계: 파일 업로드

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

3단계: 주문 상태 확인 & 결과 다운로드

주문 상태를 폴링하거나 웹훅을 설정하여 처리 완료 알림을 받습니다.
응답:
상태가 complete이면 다운로드 URL을 받습니다:
응답:
url7일 유효한 Presigned S3 URL입니다.
테스트 주문은 결과 파일을 만들지 않습니다. downloadUrlnull이고 다운로드 엔드포인트는 PROCESSED_FILE_NOT_FOUND를 반환할 수 있습니다.
비가시성 워터마크 삽입 API에서 지원하는 옵션과 상세한 설명은 API 레퍼런스를 참고하세요.

전체 React 예제

위 내용을 모두 하나의 컴포넌트로 연결했습니다: 진행률을 보여주는 단일 파일 업로드, 추가/삭제와 중복 검사가 가능한 워터마크 텍스트 목록, 백오프 폴링, 다운로드 링크까지. React 외에 별도의 의존성은 없습니다.
WatermarkEmbedUploader.jsx
import.meta.env.VITE_MORI_API_TOKEN은 Vite의 문법입니다. Next.js에서는 process.env.NEXT_PUBLIC_MORI_API_TOKEN을 사용하거나, 사용 중인 번들러가 클라이언트 코드에 노출하는 방식을 따르세요. crypto.randomUUID()는 보안 컨텍스트에서만 동작합니다. HTTPS와 localhost에서는 문제없지만, 일반 HTTP LAN 주소에서는 사용할 수 없습니다.

에러 처리

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

다음 단계

Anti-AI

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

워터마크 검출

이미지에서 비가시성 워터마크를 검출하고 추출합니다.

AI Detection

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

웹훅

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