> ## Documentation Index > Fetch the complete documentation index at: https://docs.bizmori.com/llms.txt > Use this file to discover all available pages before exploring further. # Create watermark extract order > Create a watermark extraction order. - Only 1 file per order - Supports image (jpg, jpeg, png, webp, bmp, tiff) or PDF files - For images, `includeOriginal: true` allows uploading the original file alongside - PDF does not support `includeOriginal` ## OpenAPI ````yaml /api-reference/openapi.yaml POST /api/v2/orders/wtr-extract openapi: 3.0.0 info: title: BIZ MORI API version: 2.0.0 description: | BIZ MORI API provides four core services for digital content protection: - **Anti-AI**: Protect images from AI training - **Watermark Embed**: Embed invisible digital watermarks into images - **Watermark Extract**: Extract and verify watermarks from images - **AI Detection**: Detect whether an image is AI-generated contact: name: BIZ MORI Support email: support@bizmori.com servers: - url: https://api.bizmori.com description: Production security: [] tags: - name: Anti-AI description: Anti-AI image protection orders - name: Watermark Embed description: Watermark embedding orders - name: Watermark Extract description: Watermark extraction orders - name: AI Detection description: AI-generated image detection orders - name: Orders description: Order query and management - name: Webhooks description: Webhook configuration and events paths: /api/v2/orders/wtr-extract: post: tags: - Watermark Extract summary: Create watermark extract order description: > Create a watermark extraction order. - Only 1 file per order - Supports image (jpg, jpeg, png, webp, bmp, tiff) or PDF files - For images, `includeOriginal: true` allows uploading the original file alongside - PDF does not support `includeOriginal` requestBody: required: true content: application/json: schema: type: object required: - idempotencyKey - file properties: idempotencyKey: type: string description: Idempotency key file: type: object required: - fileName properties: fileName: type: string description: Watermarked file name (with extension) example: watermarked.jpg includeOriginal: type: boolean default: false description: | Include original file (image only) - true: Upload URL for original file is also issued - Not available for PDF files originalFile: type: object description: >- Original file info (required when includeOriginal is true) required: - fileName properties: fileName: type: string description: Original file name example: original.jpg examples: imageOnly: summary: Single image (watermark only) value: idempotencyKey: key-001 file: fileName: watermarked.jpg imageWithOriginal: summary: Image + original included value: idempotencyKey: key-002 file: fileName: watermarked.jpg includeOriginal: true originalFile: fileName: original.jpg pdfOnly: summary: PDF file value: idempotencyKey: key-003 file: fileName: document.pdf responses: '200': description: Order created successfully content: application/json: schema: type: object properties: data: type: object properties: orderName: type: string description: Order name (auto-generated) orderId: type: string description: Order ID file: $ref: '#/components/schemas/WtrExtractOrderFile' examples: imageOnlyResponse: summary: Single image response value: data: orderName: wtr_extract_2026-02-13 orderId: '123456789' file: fileId: 1 fileName: watermarked.jpg uploadUrl: https://s3.amazonaws.com/... fileKey: 123/456/watermarked.jpg fileFormat: JPG fileType: IMG role: watermarked sequence: 1 imageWithOriginalResponse: summary: Image + original response value: data: orderName: wtr_extract_2026-02-13 orderId: '123456789' file: fileId: 1 fileName: watermarked.jpg uploadUrl: https://s3.amazonaws.com/... fileKey: 123/456/watermarked.jpg fileFormat: JPG fileType: IMG role: watermarked sequence: 1 originalFile: fileId: 2 fileName: original.jpg uploadUrl: https://s3.amazonaws.com/... fileKey: 123/456/original.jpg fileFormat: JPG fileType: IMG role: original sequence: 1 '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '429': $ref: '#/components/responses/UsageLimitExceeded' security: - BearerAuth: [] x-codeSamples: - lang: curl label: cURL source: |- curl -X POST https://api.bizmori.com/api/v2/orders/wtr-extract \ -H "Authorization: Bearer YOUR_API_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "idempotencyKey": "key-extract-001", "file": { "fileName": "watermarked.jpg" } }' - lang: javascript label: JavaScript source: >- const response = await fetch('https://api.bizmori.com/api/v2/orders/wtr-extract', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_TOKEN', 'Content-Type': 'application/json' }, body: JSON.stringify({ idempotencyKey: 'key-extract-001', file: { fileName: 'watermarked.jpg' } }) }); const data = await response.json(); - lang: python label: Python source: |- import requests response = requests.post( 'https://api.bizmori.com/api/v2/orders/wtr-extract', headers={'Authorization': 'Bearer YOUR_API_TOKEN'}, json={ 'idempotencyKey': 'key-extract-001', 'file': { 'fileName': 'watermarked.jpg' } } ) data = response.json() components: schemas: WtrExtractOrderFile: type: object description: Watermark extract order file info properties: fileId: type: integer description: File ID fileName: type: string description: File name uploadUrl: type: string format: uri description: Upload URL (presigned URL) fileKey: type: string description: S3 file key fileFormat: type: string description: File format example: JPG fileType: type: string enum: - IMG - DOCUMENT description: File type (image or PDF) role: type: string enum: - watermarked description: File role (always "watermarked" for the main file) sequence: type: integer description: File sequence number (always 1) example: 1 originalFile: type: object nullable: true description: Original file info (only when includeOriginal is true) properties: fileId: type: integer description: File ID fileName: type: string description: File name uploadUrl: type: string format: uri description: Upload URL (presigned URL) fileKey: type: string description: S3 file key fileFormat: type: string description: File format fileType: type: string enum: - IMG description: File type (image only) role: type: string enum: - original description: File role (always "original") sequence: type: integer description: File sequence number (always 1) example: 1 ErrorResponse: type: object properties: code: type: string description: Error code responses: BadRequest: description: Bad request content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: code: VALIDATION_FAILED Unauthorized: description: Authentication failed content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: code: AUTH_NOT_AUTHENTICATED UsageLimitExceeded: description: Usage limit exceeded content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: code: USAGE_LIMIT_EXCEEDED securitySchemes: BearerAuth: type: http scheme: bearer description: API Key for external client access ````