cURL

curl -X POST https://api.bizmori.com/api/v2/orders/ai-detection \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"idempotencyKey": "0e6c4a9b-b1d8-457e-a9fc-4b7d0e3a6c59", "fileName": "photo.jpg"}'

const response = await fetch('https://api.bizmori.com/api/v2/orders/ai-detection', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    idempotencyKey: '0e6c4a9b-b1d8-457e-a9fc-4b7d0e3a6c59',
    fileName: 'photo.jpg'
  })
});
const data = await response.json();

import requests

response = requests.post(
    'https://api.bizmori.com/api/v2/orders/ai-detection',
    headers={'Authorization': 'Bearer YOUR_API_TOKEN'},
    json={'idempotencyKey': '0e6c4a9b-b1d8-457e-a9fc-4b7d0e3a6c59', 'fileName': 'photo.jpg'}
)
data = response.json()

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.bizmori.com/api/v2/orders/ai-detection",
  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' => '0e6c4a9b-b1d8-457e-a9fc-4b7d0e3a6c59',
    'fileName' => 'photo.jpg',
    'orderName' => 'my-detection-order',
    'options' => [
        'generateHeatmap' => false,
        'generateOverlay' => false,
        'generateThumbnail' => false
    ]
  ]),
  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/ai-detection"

	payload := strings.NewReader("{\n  \"idempotencyKey\": \"0e6c4a9b-b1d8-457e-a9fc-4b7d0e3a6c59\",\n  \"fileName\": \"photo.jpg\",\n  \"orderName\": \"my-detection-order\",\n  \"options\": {\n    \"generateHeatmap\": false,\n    \"generateOverlay\": false,\n    \"generateThumbnail\": false\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/ai-detection")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"idempotencyKey\": \"0e6c4a9b-b1d8-457e-a9fc-4b7d0e3a6c59\",\n  \"fileName\": \"photo.jpg\",\n  \"orderName\": \"my-detection-order\",\n  \"options\": {\n    \"generateHeatmap\": false,\n    \"generateOverlay\": false,\n    \"generateThumbnail\": false\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.bizmori.com/api/v2/orders/ai-detection")

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\": \"0e6c4a9b-b1d8-457e-a9fc-4b7d0e3a6c59\",\n  \"fileName\": \"photo.jpg\",\n  \"orderName\": \"my-detection-order\",\n  \"options\": {\n    \"generateHeatmap\": false,\n    \"generateOverlay\": false,\n    \"generateThumbnail\": false\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "data": {
    "orderId": "<string>",
    "orderName": "<string>",
    "status": "pending",
    "file": {
      "fileId": 123,
      "fileName": "<string>",
      "uploadUrl": "<string>",
      "fileKey": "<string>"
    }
  }
}

{
  "code": "VALIDATION_FAILED"
}

{
  "code": "AUTH_NOT_AUTHENTICATED"
}

{
  "code": "USAGE_LIMIT_EXCEEDED"
}

AI Detection

Create AI Detection order

Creates an AI Detection order and issues an upload URL for the image. Live keys receive an S3 presigned URL; test keys receive an absolute BIZ MORI test-upload URL.

Flow

Call this endpoint to receive an upload URL
Upload the image using the live S3 URL or test BIZ MORI URL
Call POST /api/v2/orders/ai-detection/confirm to start async detection
Use webhooks or poll the order detail endpoint for the result

Order Status

Status	Description
`pending`	Waiting for file upload
`inProgress`	Detection is in progress
`complete`	Detection complete, result available
`failed`	Detection failed

Supported Formats

jpg, jpeg, png, webp, bmp, tiff

POST

api

orders

ai-detection

cURL

curl -X POST https://api.bizmori.com/api/v2/orders/ai-detection \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"idempotencyKey": "0e6c4a9b-b1d8-457e-a9fc-4b7d0e3a6c59", "fileName": "photo.jpg"}'

const response = await fetch('https://api.bizmori.com/api/v2/orders/ai-detection', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    idempotencyKey: '0e6c4a9b-b1d8-457e-a9fc-4b7d0e3a6c59',
    fileName: 'photo.jpg'
  })
});
const data = await response.json();

import requests

response = requests.post(
    'https://api.bizmori.com/api/v2/orders/ai-detection',
    headers={'Authorization': 'Bearer YOUR_API_TOKEN'},
    json={'idempotencyKey': '0e6c4a9b-b1d8-457e-a9fc-4b7d0e3a6c59', 'fileName': 'photo.jpg'}
)
data = response.json()

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.bizmori.com/api/v2/orders/ai-detection",
  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' => '0e6c4a9b-b1d8-457e-a9fc-4b7d0e3a6c59',
    'fileName' => 'photo.jpg',
    'orderName' => 'my-detection-order',
    'options' => [
        'generateHeatmap' => false,
        'generateOverlay' => false,
        'generateThumbnail' => false
    ]
  ]),
  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/ai-detection"

	payload := strings.NewReader("{\n  \"idempotencyKey\": \"0e6c4a9b-b1d8-457e-a9fc-4b7d0e3a6c59\",\n  \"fileName\": \"photo.jpg\",\n  \"orderName\": \"my-detection-order\",\n  \"options\": {\n    \"generateHeatmap\": false,\n    \"generateOverlay\": false,\n    \"generateThumbnail\": false\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/ai-detection")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"idempotencyKey\": \"0e6c4a9b-b1d8-457e-a9fc-4b7d0e3a6c59\",\n  \"fileName\": \"photo.jpg\",\n  \"orderName\": \"my-detection-order\",\n  \"options\": {\n    \"generateHeatmap\": false,\n    \"generateOverlay\": false,\n    \"generateThumbnail\": false\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.bizmori.com/api/v2/orders/ai-detection")

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\": \"0e6c4a9b-b1d8-457e-a9fc-4b7d0e3a6c59\",\n  \"fileName\": \"photo.jpg\",\n  \"orderName\": \"my-detection-order\",\n  \"options\": {\n    \"generateHeatmap\": false,\n    \"generateOverlay\": false,\n    \"generateThumbnail\": false\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "data": {
    "orderId": "<string>",
    "orderName": "<string>",
    "status": "pending",
    "file": {
      "fileId": 123,
      "fileName": "<string>",
      "uploadUrl": "<string>",
      "fileKey": "<string>"
    }
  }
}

{
  "code": "VALIDATION_FAILED"
}

{
  "code": "AUTH_NOT_AUTHENTICATED"
}

{
  "code": "USAGE_LIMIT_EXCEEDED"
}

How to upload the image

After receiving the uploadUrl from the response, upload your image using a PUT request. Live keys return a presigned storage URL. Test keys return a BIZ MORI test upload URL that consumes and discards the request body:

curl -X PUT "UPLOAD_URL" \
  -H "Content-Type: image/jpeg" \
  --data-binary @photo.jpg

Live presigned upload URLs expire after 10 minutes. Test upload URLs carry their own authorization and do not require a Bearer header. Upload the file before the URL expires, then call the Confirm order endpoint.

Getting the detection result

Once you confirm the upload, the order status changes to inProgress. When detection completes, the result is available via:

Webhook — Subscribe to order.aiDetection.completed or order.aiDetection.failed events
Polling — Call the Get order endpoint until status is complete or failed

The detection result is included in the order detail response under aiDetection:

{
  "data": {
    "orderId": "...",
    "status": "complete",
    "aiDetection": {
      "probability": 0.97,
      "statusCode": 1
    }
  }
}

Test orders return deterministic detection results from the input file name. Use _ai for probability 0.98 or _human for probability 0.02. Test orders do not create downloadable heatmap or overlay files.

Status Codes

`statusCode`	Meaning
`1`	Highly likely AI-generated
`2`	Likely AI-generated
`3`	Likely human-created
`4`	Highly likely human-created

Authorizations

Authorization

string

header

required

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

application/json

idempotencyKey

string

required

Idempotency key to prevent duplicate requests

Example:

"0e6c4a9b-b1d8-457e-a9fc-4b7d0e3a6c59"

fileName

string

required

Image file name with extension. Supported: jpg, jpeg, png, webp, bmp, tiff

Example:

"photo.jpg"

orderName

string

Order name (optional, auto-generated if not provided)

Maximum string length: 64

Example:

"my-detection-order"

options

object

Output options (optional). Generated files are included in the order detail response.

Hide child attributes

options.generateHeatmap

boolean

default:false

Generate AI detection heatmap image

options.generateOverlay

boolean

default:false

Generate heatmap overlay on original image

options.generateThumbnail

boolean

default:false

Generate thumbnail image

Response

Order created successfully

data

object

Hide child attributes

data.orderId

string

Order ID

data.orderName

string

Order name

data.status

enum<string>

Order status

Available options:

pending

data.file

object

Hide child attributes

data.file.fileId

integer

File record ID

data.file.fileName

string

File name

data.file.uploadUrl

string<uri>

Upload URL. 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.

data.file.fileKey

string

File identifier: an S3 object key for live keys or an isolated logical key for test keys.

Overview

Anti-AI

AI Detection

Watermark Embed

Watermark Extract

Orders

Webhooks

Create AI Detection order

Flow

Order Status

Supported Formats

How to upload the image

Getting the detection result

Status Codes

Authorizations

Body

Response

​How to upload the image

​Getting the detection result

​Status Codes

Authorizations

Body

Response

How to upload the image

Getting the detection result

Status Codes