Skip to main content
POST
/
api
/
v2
/
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": "key-ai-001", "fileName": "photo.jpg"}'
{
  "data": {
    "orderId": "<string>",
    "orderName": "<string>",
    "status": "pending",
    "file": {
      "fileId": 123,
      "fileName": "<string>",
      "uploadUrl": "<string>",
      "fileKey": "<string>"
    }
  }
}

​
How to upload the image

After receiving the uploadUrl from the response, upload your image directly to S3 using a PUT request: 
curl -X PUT "UPLOAD_URL" \
  -H "Content-Type: image/jpeg" \
  --data-binary @photo.jpg
The presigned upload URL expires after 10 minutes. Upload your image before it 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:
  1. Webhook — Subscribe to order.aiDetection.completed or order.aiDetection.failed events
  2. 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
    }
  }
}

​
Status Codes

statusCodeMeaning
1Highly likely AI-generated
2Likely AI-generated
3Likely human-created
4Highly likely human-created

Authorizations

​
Authorization
string
header
required

API Key for external client access

Body

application/json
​
idempotencyKey
string
required

Idempotency key to prevent duplicate requests

Example:

"key-ai-detection-001"

​
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.

Response

Order created successfully

​
data
object