cURL

curl -X POST https://api.bizmori.com/api/v2/orders/wtr-embed \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "idempotencyKey": "key-embed-001",
    "files": [
      {
        "fileName": "image.jpg",
        "watermarks": [{"text": "MORI_WATERMARK"}]
      }
    ]
  }'

{
  "data": {
    "orderName": "wtr_embed_20260318120000.000",
    "orderId": "424706541233094656",
    "status": "pending",
    "files": [
      {
        "fileId": 2469,
        "fileName": "image.jpg",
        "uploadUrl": "https://s3.ap-northeast-2.amazonaws.com/...?X-Amz-Algorithm=AWS4-HMAC-SHA256&...",
        "fileKey": "wtr-embed/424706541233094656/images/1/image.jpg",
        "fileFormat": "JPG",
        "fileType": "IMG"
      },
      {
        "fileId": 2470,
        "fileName": "document.pdf",
        "uploadUrl": "https://s3.ap-northeast-2.amazonaws.com/...?X-Amz-Algorithm=AWS4-HMAC-SHA256&...",
        "fileKey": "wtr-embed/424706541233094656/documents/2/document.pdf",
        "fileFormat": "PDF",
        "fileType": "DOCUMENT"
      }
    ]
  }
}

Watermark-Embed

워터마크 삽입 주문 생성

워터마크 삽입 주문을 생성합니다.

이미지당 최대 10개의 워터마크 텍스트
주문당 최대 100개의 파일
지원 이미지 형식 (IMG): jpg, jpeg, png, webp, bmp, tiff
지원 문서 형식 (DOCUMENT): pdf

입력 모드 (업로드 / URL / 혼합)

입력 모드는 각 파일 객체의 originalFileUrl 존재 여부에 따라 결정됩니다:

업로드 모드 (originalFileUrl 없음): Presigned URL 발급 → 클라이언트가 S3에 업로드 → 처리 자동 시작
URL 모드 (originalFileUrl 제공): 해당 URL에서 이미지를 다운로드하여 즉시 처리
혼합 모드: 일부 파일은 업로드 모드, 나머지는 URL 모드로 동시 처리

동작 방식

조건	주문 상태	Confirm 필요 여부
모든 파일에 `originalFileUrl` 있음	`pending`	불필요 (서버 다운로드 후 자동 시작)
`originalFileUrl` 없는 파일 존재	`pending`	불필요 (업로드 후 자동 시작)

Anti-AI, AI Detection과 달리 Watermark Embed는 별도의 confirm 단계가 필요하지 않습니다. 파일 업로드가 완료되면 처리가 자동으로 시작됩니다.

POST

api

orders

wtr-embed

cURL

curl -X POST https://api.bizmori.com/api/v2/orders/wtr-embed \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "idempotencyKey": "key-embed-001",
    "files": [
      {
        "fileName": "image.jpg",
        "watermarks": [{"text": "MORI_WATERMARK"}]
      }
    ]
  }'

{
  "data": {
    "orderName": "wtr_embed_20260318120000.000",
    "orderId": "424706541233094656",
    "status": "pending",
    "files": [
      {
        "fileId": 2469,
        "fileName": "image.jpg",
        "uploadUrl": "https://s3.ap-northeast-2.amazonaws.com/...?X-Amz-Algorithm=AWS4-HMAC-SHA256&...",
        "fileKey": "wtr-embed/424706541233094656/images/1/image.jpg",
        "fileFormat": "JPG",
        "fileType": "IMG"
      },
      {
        "fileId": 2470,
        "fileName": "document.pdf",
        "uploadUrl": "https://s3.ap-northeast-2.amazonaws.com/...?X-Amz-Algorithm=AWS4-HMAC-SHA256&...",
        "fileKey": "wtr-embed/424706541233094656/documents/2/document.pdf",
        "fileFormat": "PDF",
        "fileType": "DOCUMENT"
      }
    ]
  }
}

인증

Authorization

string

header

필수

외부 클라이언트 접근을 위한 API 키

본문

application/json

idempotencyKey

string

필수

멱등성 키

files

object[]

필수

Required array length: 1 - 100 elements

Hide child attributes

files.fileName

string

필수

파일 이름

예시:

"image.jpg"

files.watermarks

object[]

필수

Required array length: 1 - 10 elements

Hide child attributes

files.watermarks.text

string

필수

워터마크 텍스트

Maximum string length: 1000

files.originalFileUrl

string<uri>

원본 이미지 URL (선택)

제공 시: URL 모드 (presigned URL 미발급, 즉시 처리)
미제공 시: 업로드 모드 (presigned URL 발급)

예시:

"https://example.com/image.jpg"

응답

주문 생성 성공

data

object

Hide child attributes

data.orderName

string

data.orderId

string

data.status

enum<string>

주문 상태

pending: 입력 모드에 관계없이 항상 반환

사용 가능한 옵션:

pending

data.files

object[]

Hide child attributes

data.files.fileId

integer

data.files.fileName

string

data.files.uploadUrl

string<uri>

S3 presigned 업로드 URL. 업로드 모드에서만 반환됩니다.

data.files.originalFileUrl

string<uri>

요청에 전달된 공개 이미지 URL. URL 모드에서만 반환됩니다.

data.files.fileKey

string

S3 오브젝트 키.

data.files.fileFormat

enum<string>

파일 형식.

사용 가능한 옵션:

JPG,

PNG,

WEBP,

BMP,

TIFF,

PDF

data.files.fileType

enum<string>

파일 유형 분류.

사용 가능한 옵션:

IMG,

DOCUMENT

AI Detection 주문 확인 워터마크 추출 주문 생성

Documentation Index

인증

본문

응답