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": "5e9c7a3b-b4d2-4f18-83e6-8b1a2d5f7c93",
"files": [
{
"fileName": "image.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: '5e9c7a3b-b4d2-4f18-83e6-8b1a2d5f7c93',
files: [
{
fileName: 'image.jpg',
watermarks: [{ text: 'MORI_WATERMARK' }]
}
]
})
});
const data = await response.json();import requests
response = requests.post(
'https://api.bizmori.com/api/v2/orders/wtr-embed',
headers={'Authorization': 'Bearer YOUR_API_TOKEN'},
json={
'idempotencyKey': '5e9c7a3b-b4d2-4f18-83e6-8b1a2d5f7c93',
'files': [
{
'fileName': 'image.jpg',
'watermarks': [{'text': 'MORI_WATERMARK'}]
}
]
}
)
data = response.json()<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.bizmori.com/api/v2/orders/wtr-embed",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'idempotencyKey' => '5e9c7a3b-b4d2-4f18-83e6-8b1a2d5f7c93',
'files' => [
[
'fileName' => 'image1.jpg',
'watermarks' => [
[
'text' => 'MORI_WATERMARK'
]
]
],
[
'fileName' => 'image2.png',
'watermarks' => [
[
'text' => 'MORI_WATERMARK'
]
]
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.bizmori.com/api/v2/orders/wtr-embed"
payload := strings.NewReader("{\n \"idempotencyKey\": \"5e9c7a3b-b4d2-4f18-83e6-8b1a2d5f7c93\",\n \"files\": [\n {\n \"fileName\": \"image1.jpg\",\n \"watermarks\": [\n {\n \"text\": \"MORI_WATERMARK\"\n }\n ]\n },\n {\n \"fileName\": \"image2.png\",\n \"watermarks\": [\n {\n \"text\": \"MORI_WATERMARK\"\n }\n ]\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.bizmori.com/api/v2/orders/wtr-embed")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"idempotencyKey\": \"5e9c7a3b-b4d2-4f18-83e6-8b1a2d5f7c93\",\n \"files\": [\n {\n \"fileName\": \"image1.jpg\",\n \"watermarks\": [\n {\n \"text\": \"MORI_WATERMARK\"\n }\n ]\n },\n {\n \"fileName\": \"image2.png\",\n \"watermarks\": [\n {\n \"text\": \"MORI_WATERMARK\"\n }\n ]\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bizmori.com/api/v2/orders/wtr-embed")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"idempotencyKey\": \"5e9c7a3b-b4d2-4f18-83e6-8b1a2d5f7c93\",\n \"files\": [\n {\n \"fileName\": \"image1.jpg\",\n \"watermarks\": [\n {\n \"text\": \"MORI_WATERMARK\"\n }\n ]\n },\n {\n \"fileName\": \"image2.png\",\n \"watermarks\": [\n {\n \"text\": \"MORI_WATERMARK\"\n }\n ]\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"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"
}
]
}
}Create watermark embed order
Support ended. This endpoint ended support at 09:00 KST on October 9, 2026 (00:00 UTC). Use POST /api/v3/orders/wtr-embed instead.
Every response from this endpoint, including authentication errors and the 410 response, includes the Deprecation: true, Sunset: Fri, 09 Oct 2026 00:00:00 GMT, and Link: </api/v3/orders/wtr-embed>; rel="successor-version" headers.
From 09:00 KST on October 9, 2026 (00:00 UTC):
- Authentication and permission checks still run first, so
401and403errors are returned as before. - Authenticated requests to the v2 watermark embed and extract endpoints return
410 Gonewith{ "code": "WATERMARK_V2_API_SUNSET" }, for both live andsk_test_keys. TheLinkheader points to the v3 endpoint. Create new orders with v3. - v2 orders that have not started processing by then fail without being processed. The order details (
errors.errorCode) and the failed webhook carryWATERMARK_V2_API_SUNSETwith a message pointing to v3. The order is not charged, and its credits are restored. - Orders already processing at that time finish and record their result. No new run starts for them afterwards.
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 (
originalFileUrlprovided): 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) |
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": "5e9c7a3b-b4d2-4f18-83e6-8b1a2d5f7c93",
"files": [
{
"fileName": "image.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: '5e9c7a3b-b4d2-4f18-83e6-8b1a2d5f7c93',
files: [
{
fileName: 'image.jpg',
watermarks: [{ text: 'MORI_WATERMARK' }]
}
]
})
});
const data = await response.json();import requests
response = requests.post(
'https://api.bizmori.com/api/v2/orders/wtr-embed',
headers={'Authorization': 'Bearer YOUR_API_TOKEN'},
json={
'idempotencyKey': '5e9c7a3b-b4d2-4f18-83e6-8b1a2d5f7c93',
'files': [
{
'fileName': 'image.jpg',
'watermarks': [{'text': 'MORI_WATERMARK'}]
}
]
}
)
data = response.json()<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.bizmori.com/api/v2/orders/wtr-embed",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'idempotencyKey' => '5e9c7a3b-b4d2-4f18-83e6-8b1a2d5f7c93',
'files' => [
[
'fileName' => 'image1.jpg',
'watermarks' => [
[
'text' => 'MORI_WATERMARK'
]
]
],
[
'fileName' => 'image2.png',
'watermarks' => [
[
'text' => 'MORI_WATERMARK'
]
]
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.bizmori.com/api/v2/orders/wtr-embed"
payload := strings.NewReader("{\n \"idempotencyKey\": \"5e9c7a3b-b4d2-4f18-83e6-8b1a2d5f7c93\",\n \"files\": [\n {\n \"fileName\": \"image1.jpg\",\n \"watermarks\": [\n {\n \"text\": \"MORI_WATERMARK\"\n }\n ]\n },\n {\n \"fileName\": \"image2.png\",\n \"watermarks\": [\n {\n \"text\": \"MORI_WATERMARK\"\n }\n ]\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.bizmori.com/api/v2/orders/wtr-embed")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"idempotencyKey\": \"5e9c7a3b-b4d2-4f18-83e6-8b1a2d5f7c93\",\n \"files\": [\n {\n \"fileName\": \"image1.jpg\",\n \"watermarks\": [\n {\n \"text\": \"MORI_WATERMARK\"\n }\n ]\n },\n {\n \"fileName\": \"image2.png\",\n \"watermarks\": [\n {\n \"text\": \"MORI_WATERMARK\"\n }\n ]\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bizmori.com/api/v2/orders/wtr-embed")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"idempotencyKey\": \"5e9c7a3b-b4d2-4f18-83e6-8b1a2d5f7c93\",\n \"files\": [\n {\n \"fileName\": \"image1.jpg\",\n \"watermarks\": [\n {\n \"text\": \"MORI_WATERMARK\"\n }\n ]\n },\n {\n \"fileName\": \"image2.png\",\n \"watermarks\": [\n {\n \"text\": \"MORI_WATERMARK\"\n }\n ]\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"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"
}
]
}
}POST /api/v3/orders/wtr-embed for new integrations, and see the watermark embed quickstart to migrate.After v2 support ends (from 09:00 KST on October 9, 2026, which is 00:00 UTC):- Authentication and permission checks still run first, so
401and403errors are returned as before. - Authenticated requests to the v2 watermark embed and extract endpoints return
410 Gonewith{ "code": "WATERMARK_V2_API_SUNSET" }, for both live andsk_test_keys. TheLinkheader points to the v3 endpoint. Create new orders with v3. - v2 orders that have not started processing by then fail without being processed. The order details (
errors.errorCode) and the failed webhook carryWATERMARK_V2_API_SUNSETwith a message pointing to v3. The order is not charged, and its credits are restored. - Orders already processing at that time finish and record their result. No new run starts for them afterwards.
- You can still get existing v2 orders and download results and reports that were already created, within the existing retention period. New v2 reports cannot be created or regenerated.
Deprecation: true, Sunset: Fri, 09 Oct 2026 00:00:00 GMT, and Link headers.Response after support ends
From 09:00 KST on October 9, 2026 (00:00 UTC), an authenticated request to this endpoint returns:HTTP/1.1 410 Gone
Content-Type: application/json; charset=utf-8
Deprecation: true
Sunset: Fri, 09 Oct 2026 00:00:00 GMT
Link: </api/v3/orders/wtr-embed>; rel="successor-version"
{ "code": "WATERMARK_V2_API_SUNSET" }
Link header.
sk_test_ key, upload to the returned BIZ MORI test upload URL. The order moves to processing after its uploads finish, without a confirm call. Test processing does not create a downloadable result file.Download order results
Once your order reachescomplete status, call Get order result download URLs. One call returns a URL for each output file in files[] and a ZIP archive of all results in archiveUrl:
curl -X GET https://api.bizmori.com/api/v3/orders/{orderId}/download \
-H "Authorization: Bearer YOUR_API_KEY"
expiresAt; after that, the endpoint returns 400 ORDER_EXPIRED. For an sk_test_ order, the URLs point to fixed sample files instead of your results.Authorizations
Bearer API key for external client access. Live keys use the sk_ prefix; test keys use the sk_test_ prefix and support order-lifecycle testing with mock responses without processing or credit usage.
Body
Idempotency key
1 - 100 elementsHide child attributes
Hide child attributes
File name
"image.jpg"
Original image URL (optional)
- Provided: URL mode (no presigned URL issued, immediate processing)
- Not provided: Upload mode (presigned URL issued)
"https://example.com/image.jpg"
Response
Order created successfully
Hide child attributes
Hide child attributes
Order status
pending: Always returned regardless of input mode
pending Hide child attributes
Hide child attributes
Upload URL, returned in upload mode only. Live keys receive an S3 presigned URL; test keys receive an absolute https://api.bizmori.com/api/v2/test-uploads/{signedToken} URL. Both expire after one hour. PUT needs no Authorization header because the signed token authorizes the test upload. Test request bodies are streamed, not stored; test orders move to simulated results without usage consumption or actual external processing.
Public image URL provided in the request. Returned in URL mode only.
File identifier: an S3 object key for live keys or an isolated logical key for test keys.
File format.
JPG, PNG, WEBP, BMP, TIFF, PDF File type category.
IMG, DOCUMENT