Skip to main content
This guide walks you through embedding an invisible watermark into an image — from creating an order to downloading the watermarked result.

​
Prerequisites

  • A BIZ MORI API key (get one here)
  • An image or PDF file to watermark (jpeg, jpg, png, webp, tiff, bmp, or pdf)

​
Step 1: Create an order

Create a watermark embed order with your watermark text. 
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": "my-embed-001",
    "files": [
      {
        "fileName": "photo.jpg",
        "watermarks": [{ "text": "MORI_WATERMARK" }]
      }
    ]
  }'

const response = await fetch('https://api.bizmori.com/api/v2/orders/wtr-embed', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    idempotencyKey: 'my-embed-001',
    files: [
      {
        fileName: 'photo.jpg',
        watermarks: [{ text: 'MORI_WATERMARK' }],
      },
    ],
  }),
});
const { data } = await response.json();

import requests

res = requests.post(
    'https://api.bizmori.com/api/v2/orders/wtr-embed',
    headers={'Authorization': 'Bearer YOUR_API_TOKEN'},
    json={
        'idempotencyKey': 'my-embed-001',
        'files': [
            {
                'fileName': 'photo.jpg',
                'watermarks': [{'text': 'MORI_WATERMARK'}],
            }
        ],
    },
)
data = res.json()['data']
Response: 
{
  "data": {
    "orderName": "wtr_embed_2026-03-18",
    "orderId": "123456789",
    "status": "pending",
    "files": [
      {
        "fileId": 1,
        "fileName": "photo.jpg",
        "uploadUrl": "https://s3.amazonaws.com/...",
        "fileKey": "wtr-embed/123456789/images/1/photo.jpg",
        "fileFormat": "JPG",
        "fileType": "IMG"
      }
    ]
  }
}

​
Step 2: Upload files

PUT your file to the presigned uploadUrl from Step 1. This is a direct S3 upload — no Authorization header needed.
cURL
curl -X PUT "https://s3.amazonaws.com/..." \
  -H "Content-Type: image/jpeg" \
  --data-binary @photo.jpg
No confirm step needed. Unlike Anti-AI and AI Detection, Watermark Embed processing starts automatically after your file upload completes. Proceed directly to checking the order status.
Presigned URLs expire after 1 hour. If yours has expired, use the Refresh URLs endpoint to generate new ones.

​
Step 3: Check order status & download result

Poll the order or use webhooks to receive a push notification when processing completes. 
curl https://api.bizmori.com/api/v2/orders/123456789 \
  -H "Authorization: Bearer YOUR_API_TOKEN"

const res = await fetch('https://api.bizmori.com/api/v2/orders/123456789', {
  headers: { 'Authorization': 'Bearer YOUR_API_TOKEN' },
});
const { data } = await res.json();
// data.status: 'pending' | 'inProgress' | 'complete' | 'failed'

res = requests.get(
    'https://api.bizmori.com/api/v2/orders/123456789',
    headers={'Authorization': 'Bearer YOUR_API_TOKEN'},
)
status = res.json()['data']['status']
StatusMeaning
pendingWaiting for file upload
inProgressProcessing
completeReady for download
failedProcessing failed
Once status is complete, fetch the download URL: 
curl https://api.bizmori.com/api/v2/orders/123456789/download \
  -H "Authorization: Bearer YOUR_API_TOKEN"

const res = await fetch('https://api.bizmori.com/api/v2/orders/123456789/download', {
  headers: { 'Authorization': 'Bearer YOUR_API_TOKEN' },
});
const { data } = await res.json();
// data.downloadUrl — valid for 1 hour

res = requests.get(
    'https://api.bizmori.com/api/v2/orders/123456789/download',
    headers={'Authorization': 'Bearer YOUR_API_TOKEN'},
)
download_url = res.json()['data']['downloadUrl']
Response: 
{
  "data": {
    "downloadUrl": "https://s3.amazonaws.com/...",
    "expiresIn": 3600
  }
}
The downloadUrl is a presigned S3 URL valid for 1 hour.

​
Error handling

HTTP StatusMeaningAction
400Invalid requestCheck parameters and file format
401Authentication failedVerify your API key
429Rate limit exceededReduce request frequency or upgrade plan
For the complete error code reference, see Error Codes.

​
Next steps

Anti-AI

Protect images from AI training and generation.

Watermark Extract

Detect and extract watermarks from images.

AI Detection

Detect AI-generated images with probability scores.

Webhooks

Set up webhooks to get notified when processing completes.