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

Create watermark embed order

Create a watermark embedding order.

Up to 10 watermark texts per image
Up to 100 files per order
Supported image formats (IMG): jpg, jpeg, png, webp, bmp, tiff
Supported document formats (DOCUMENT): pdf

Input Modes (Upload / URL / Mixed)

The input mode is determined by the presence of originalFileUrl in each file object:

Upload mode (no originalFileUrl): Presigned URL issued → Client uploads to S3 → Processing starts automatically
URL mode (originalFileUrl provided): Image downloaded from the URL and processed immediately
Mixed mode: Some files in Upload mode, others in URL mode simultaneously

Behavior

Condition	Order Status	Confirm Required
All files have `originalFileUrl`	`pending`	No (auto-starts after server downloads)
Any file without `originalFileUrl`	`pending`	No (auto-starts after upload)

Unlike Anti-AI and AI Detection, Watermark Embed does not require a separate confirm step. Processing starts automatically after file upload completes.

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"
      }
    ]
  }
}

Download order results

Once your order reaches complete status, use the Get download URL endpoint to retrieve a presigned download URL:

curl -X GET https://api.bizmori.com/api/v2/orders/{orderId}/download \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Order files are available for download for up to 7 days after order creation. After 7 days, the order transitions to expired status and files can no longer be downloaded.

Authorizations

Authorization

string

header

required

API Key for external client access

Body

application/json

idempotencyKey

string

required

Idempotency key

files

object[]

required

Required array length: 1 - 100 elements

Hide child attributes

files.fileName

string

required

File name

Example:

"image.jpg"

files.watermarks

object[]

required

Required array length: 1 - 10 elements

Hide child attributes

files.watermarks.text

string

required

Watermark text

Maximum string length: 1000

files.originalFileUrl

string<uri>

Original image URL (optional)

Provided: URL mode (no presigned URL issued, immediate processing)
Not provided: Upload mode (presigned URL issued)

Example:

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

Response

Order created successfully

data

object

Hide child attributes

data.orderName

string

data.orderId

string

data.status

enum<string>

Order status

pending: Always returned regardless of input mode

Available options:

pending

data.files

object[]

Hide child attributes

data.files.fileId

integer

data.files.fileName

string

data.files.uploadUrl

string<uri>

Presigned upload URL. Returned in upload mode only.

data.files.originalFileUrl

string<uri>

Public image URL provided in the request. Returned in URL mode only.

data.files.fileKey

string

S3 object key for the file.

data.files.fileFormat

enum<string>

File format.

Available options:

JPG,

PNG,

WEBP,

BMP,

TIFF,

PDF

data.files.fileType

enum<string>

File type category.

Available options:

IMG,

DOCUMENT

Confirm AI Detection order Create watermark extract order

Documentation Index

​Download order results

Authorizations

Body

Response

Download order results