> ## 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. # 워터마크 추출 주문 생성 > 워터마크 추출 주문을 생성합니다. - 주문당 파일 1개 - 이미지 (jpg, jpeg, png, webp, bmp, tiff) 또는 PDF 파일 지원 - 이미지의 경우 `includeOriginal: true`로 원본 파일도 함께 업로드 가능 - PDF는 `includeOriginal` 미지원 ## OpenAPI ````yaml /ko/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는 디지털 콘텐츠 보호를 위한 네 가지 핵심 서비스를 제공합니다: - **Anti-AI**: 이미지를 AI 학습으로부터 보호 - **Watermark Embed**: 이미지에 보이지 않는 디지털 워터마크 삽입 - **Watermark Extract**: 이미지에서 워터마크 추출 및 검증 - **AI Detection**: 이미지가 AI로 생성되었는지 감지 contact: name: BIZ MORI 지원 email: support@bizmori.com servers: - url: https://api.bizmori.com description: 프로덕션 security: [] tags: - name: Anti-AI description: AI 학습 방지 이미지 보호 주문 - name: Watermark Embed description: 워터마크 삽입 주문 - name: Watermark Extract description: 워터마크 추출 주문 - name: AI Detection description: AI 생성 이미지 감지 주문 - name: Orders description: 주문 조회 및 관리 - name: Webhooks description: 웹훅 설정 및 이벤트 paths: /api/v2/orders/wtr-extract: post: tags: - Watermark Extract summary: 워터마크 추출 주문 생성 description: | 워터마크 추출 주문을 생성합니다. - 주문당 파일 1개 - 이미지 (jpg, jpeg, png, webp, bmp, tiff) 또는 PDF 파일 지원 - 이미지의 경우 `includeOriginal: true`로 원본 파일도 함께 업로드 가능 - PDF는 `includeOriginal` 미지원 requestBody: required: true content: application/json: schema: type: object required: - idempotencyKey - file properties: idempotencyKey: type: string description: 멱등성 키 file: type: object required: - fileName properties: fileName: type: string description: 워터마크된 파일 이름 (확장자 포함) example: watermarked.jpg includeOriginal: type: boolean default: false description: | 원본 파일 포함 (이미지 전용) - true: 원본 파일 업로드 URL도 발급 - PDF 파일에는 사용 불가 originalFile: type: object description: 원본 파일 정보 (includeOriginal이 true일 때 필수) required: - fileName properties: fileName: type: string description: 원본 파일 이름 example: original.jpg examples: imageOnly: summary: 단일 이미지 (워터마크만) value: idempotencyKey: key-001 file: fileName: watermarked.jpg imageWithOriginal: summary: 이미지 + 원본 포함 value: idempotencyKey: key-002 file: fileName: watermarked.jpg includeOriginal: true originalFile: fileName: original.jpg pdfOnly: summary: PDF 파일 value: idempotencyKey: key-003 file: fileName: document.pdf responses: '200': description: 주문 생성 성공 content: application/json: schema: type: object properties: data: type: object properties: orderName: type: string description: 주문 이름 (자동 생성) orderId: type: string description: 주문 ID file: $ref: '#/components/schemas/WtrExtractOrderFile' examples: imageOnlyResponse: summary: 단일 이미지 응답 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: 이미지 + 원본 응답 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: 워터마크 추출 주문 파일 정보 properties: fileId: type: integer description: 파일 ID fileName: type: string description: 파일 이름 uploadUrl: type: string format: uri description: 업로드 URL (프리사인드 URL) fileKey: type: string description: S3 파일 키 fileFormat: type: string description: 파일 형식 example: JPG fileType: type: string enum: - IMG - DOCUMENT description: 파일 타입 (이미지 또는 PDF) role: type: string enum: - watermarked description: 파일 역할 (항상 "watermarked") sequence: type: integer description: 파일 순서 (항상 1) example: 1 originalFile: type: object nullable: true description: 원본 파일 정보 (includeOriginal이 true일 때만 포함) properties: fileId: type: integer description: 파일 ID fileName: type: string description: 파일 이름 uploadUrl: type: string format: uri description: 업로드 URL (프리사인드 URL) fileKey: type: string description: S3 파일 키 fileFormat: type: string description: 파일 형식 fileType: type: string enum: - IMG description: 파일 타입 (이미지만 해당) role: type: string enum: - original description: 파일 역할 (항상 "original") sequence: type: integer description: 파일 순서 (항상 1) example: 1 ErrorResponse: type: object properties: code: type: string description: 에러 코드 responses: BadRequest: description: 잘못된 요청 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: code: VALIDATION_FAILED Unauthorized: description: 인증 실패 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: code: AUTH_NOT_AUTHENTICATED UsageLimitExceeded: description: 사용량 한도 초과 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: code: USAGE_LIMIT_EXCEEDED securitySchemes: BearerAuth: type: http scheme: bearer description: 외부 클라이언트 접근을 위한 API 키 ````