> ## Documentation Index > Fetch the complete documentation index at: https://docs.contentcare.ai/llms.txt > Use this file to discover all available pages before exploring further. # 워터마크 추출 주문 생성 > **지원 종료.** 이 엔드포인트는 2026년 10월 9일 09:00 KST(00:00 UTC)에 지원이 종료되었습니다. `POST /api/v3/orders/wtr-extract`를 사용하세요. 이 엔드포인트의 모든 응답(인증 오류와 `410` 응답 포함)에는 `Deprecation: true`, `Sunset: Fri, 09 Oct 2026 00:00:00 GMT`, `Link: ; rel="successor-version"` 헤더가 포함됩니다. 2026년 10월 9일 09:00 KST(00:00 UTC)부터: - 인증·권한 검사는 지금처럼 먼저 수행하므로 `401`, `403` 오류는 기존과 같습니다. - 인증을 통과한 v2 워터마크 삽입·검출 요청은 live 키와 `sk_test_` 키 모두 `410 Gone`과 `{ "code": "WATERMARK_V2_API_SUNSET" }`을 받습니다. `Link` 헤더가 v3 엔드포인트를 가리키니 v3로 새로 요청하세요. - 그때까지 처리를 시작하지 않은 v2 주문은 처리되지 않고 실패로 확정됩니다. 주문 상세(`errors.errorCode`)와 실패 웹훅에 `WATERMARK_V2_API_SUNSET`과 v3 안내 메시지가 담기며, 과금되지 않고 크레딧은 복원됩니다. - 종료 시각에 이미 처리 중인 주문은 결과 기록까지 마칩니다. 이후 새로 다시 실행하지는 않습니다. 워터마크 추출 주문을 생성합니다. - 주문당 파일 1개 - 이미지 (jpg, jpeg, png, webp, bmp, tiff) 또는 PDF 파일 지원 - 이미지의 경우 `includeOriginal: true`로 원본 파일도 함께 업로드 가능 - PDF는 `includeOriginal` 미지원 > [!WARNING] > > **지원 종료.** 이 v2 엔드포인트는 2026년 10월 9일 09:00 KST(00:00 UTC)에 지원이 종료되었습니다. 새로 연동한다면 [`POST /api/v3/orders/wtr-extract`](https://docs.contentcare.ai/ko/api-reference/watermark-extract/create-order-v3)를 사용하고, 마이그레이션 방법은 [워터마크 검출 빠른 시작](https://docs.contentcare.ai/ko/quickstart/watermark-extract.md#v2에서-v3로-마이그레이션)을 참고하세요. > > **v2 지원 종료 후 동작** (2026년 10월 9일 09:00 KST, 00:00 UTC부터): > > * 인증·권한 검사는 지금처럼 먼저 수행하므로 `401`, `403` 오류는 기존과 같습니다. > * 인증을 통과한 v2 워터마크 삽입·검출 요청은 live 키와 `sk_test_` 키 모두 `410 Gone`과 `{ "code": "WATERMARK_V2_API_SUNSET" }`을 받습니다. `Link` 헤더가 v3 엔드포인트를 가리키니 v3로 새로 요청하세요. > * 그때까지 처리를 시작하지 않은 v2 주문은 처리되지 않고 실패로 확정됩니다. 주문 상세(`errors.errorCode`)와 실패 웹훅에 `WATERMARK_V2_API_SUNSET`과 v3 안내 메시지가 담기며, 과금되지 않고 크레딧은 복원됩니다. > * 종료 시각에 이미 처리 중인 주문은 결과 기록까지 마칩니다. 이후 새로 다시 실행하지는 않습니다. > * 기존 v2 주문 조회와 이미 생성된 결과·보고서 다운로드는 기존 보존 기간 안에서 계속 이용할 수 있습니다. v2 보고서를 새로 생성하거나 재생성할 수는 없습니다. > > 그 전까지 요청·응답 동작은 같고, v2 워터마크 엔드포인트의 모든 응답에 `Deprecation: true`, `Sunset: Fri, 09 Oct 2026 00:00:00 GMT`, `Link` 헤더만 추가됩니다. > [!WARNING] > > **v3 워터마크 검출은 v2로 삽입한 워터마크를 검출할 수 없습니다.** 엔드포인트만 v3로 바꿔도 기존 v2 워터마크 이미지는 검출되지 않으며, v2 지원이 종료된 뒤 v2 검출을 위한 예외도 제공하지 않습니다. ## 지원 종료 후 응답 2026년 10월 9일 09:00 KST(00:00 UTC)부터 이 엔드포인트에 인증을 통과한 요청을 보내면 다음과 같이 응답합니다. ```http theme={null} HTTP/1.1 410 Gone Content-Type: application/json; charset=utf-8 Deprecation: true Sunset: Fri, 09 Oct 2026 00:00:00 GMT Link: ; rel="successor-version" { "code": "WATERMARK_V2_API_SUNSET" } ``` `Link` 헤더의 v3 엔드포인트로 새로 요청하세요. ## 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로 생성되었는지 감지 - **테스트 API 키**: `sk_test_` 접두사의 키는 동일한 Bearer 인증을 사용하며, 실제 처리 서비스나 크레딧 사용 없이 주문 흐름을 검증할 수 있습니다. 테스트 업로드는 파일 내용을 폐기하고 결과 파일을 만들지 않습니다 contact: name: BIZ MORI 지원 email: support@contentcare.ai license: name: Proprietary url: https://docs.contentcare.ai/legal/terms 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: 웹훅 설정 및 이벤트 - name: Reports description: 워터마크 추출·AI Detection 주문의 PDF 분석 보고서 paths: /api/v2/orders/wtr-extract: post: tags: - Watermark Extract summary: 워터마크 추출 주문 생성 description: > **지원 종료.** 이 엔드포인트는 2026년 10월 9일 09:00 KST(00:00 UTC)에 지원이 종료되었습니다. `POST /api/v3/orders/wtr-extract`를 사용하세요. 이 엔드포인트의 모든 응답(인증 오류와 `410` 응답 포함)에는 `Deprecation: true`, `Sunset: Fri, 09 Oct 2026 00:00:00 GMT`, `Link: ; rel="successor-version"` 헤더가 포함됩니다. 2026년 10월 9일 09:00 KST(00:00 UTC)부터: - 인증·권한 검사는 지금처럼 먼저 수행하므로 `401`, `403` 오류는 기존과 같습니다. - 인증을 통과한 v2 워터마크 삽입·검출 요청은 live 키와 `sk_test_` 키 모두 `410 Gone`과 `{ "code": "WATERMARK_V2_API_SUNSET" }`을 받습니다. `Link` 헤더가 v3 엔드포인트를 가리키니 v3로 새로 요청하세요. - 그때까지 처리를 시작하지 않은 v2 주문은 처리되지 않고 실패로 확정됩니다. 주문 상세(`errors.errorCode`)와 실패 웹훅에 `WATERMARK_V2_API_SUNSET`과 v3 안내 메시지가 담기며, 과금되지 않고 크레딧은 복원됩니다. - 종료 시각에 이미 처리 중인 주문은 결과 기록까지 마칩니다. 이후 새로 다시 실행하지는 않습니다. 워터마크 추출 주문을 생성합니다. - 주문당 파일 1개 - 이미지 (jpg, jpeg, png, webp, bmp, tiff) 또는 PDF 파일 지원 - 이미지의 경우 `includeOriginal: true`로 원본 파일도 함께 업로드 가능 - PDF는 `includeOriginal` 미지원 operationId: createWatermarkExtractOrder 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: 8b3f1d6e-e7a5-424b-b6c9-1e4d5a8c0f26 file: fileName: watermarked.jpg imageWithOriginal: summary: 이미지 + 원본 포함 value: idempotencyKey: 9c4a2e7f-f8b6-435c-87da-2f5e6b9d1a37 file: fileName: watermarked.jpg includeOriginal: true originalFile: fileName: original.jpg pdfOnly: summary: PDF 파일 value: idempotencyKey: ad5b3f8a-a9c7-446d-98eb-3a6f7c0e2b48 file: fileName: document.pdf responses: '200': description: 주문 생성 성공 headers: Deprecation: description: 지원 중단(deprecated) API임을 나타냅니다 schema: type: string example: 'true' Sunset: description: 지원 종료 시점 (RFC 8594 HTTP-date, 2026년 10월 9일 09:00 KST) schema: type: string example: Fri, 09 Oct 2026 00:00:00 GMT Link: description: 후속 v3 API 경로 schema: type: string example: ; rel="successor-version" 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' '403': $ref: '#/components/responses/Forbidden' '410': description: >- v2 워터마크 지원 종료(2026년 10월 9일 09:00 KST부터). 인증·권한 검사를 통과한 요청에만 반환합니다. `Link` 헤더의 v3 경로로 새로 요청하세요. headers: Link: description: 후속 v3 API 경로 schema: type: string example: ; rel="successor-version" content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: code: WATERMARK_V2_API_SUNSET '429': $ref: '#/components/responses/UsageLimitExceeded' deprecated: true 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": "8b3f1d6e-e7a5-424b-b6c9-1e4d5a8c0f26", "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: '8b3f1d6e-e7a5-424b-b6c9-1e4d5a8c0f26', 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': '8b3f1d6e-e7a5-424b-b6c9-1e4d5a8c0f26', '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. live 키는 S3 presigned URL을 받고, 테스트 키는 절대 `https://api.bizmori.com/api/v2/test-uploads/{signedToken}` URL을 받습니다. 두 URL은 1시간 후 만료되며 `POST /api/v2/orders/{orderId}/refresh-urls`로 재발급할 수 있습니다. signed token 자체가 테스트 업로드를 인가하므로 PUT에 Authorization 헤더가 필요 없습니다. 테스트 요청 본문은 스트림으로 소비되어 저장되지 않으며, 테스트 주문은 사용량 차감이나 실제 외부 처리 없이 모의 결과로 전이합니다. fileKey: type: string description: | 파일 식별자: live 키에서는 S3 object key이고 테스트 키에서는 격리된 logical key입니다. 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. live 키는 S3 presigned URL을 받고, 테스트 키는 절대 `https://api.bizmori.com/api/v2/test-uploads/{signedToken}` URL을 받습니다. 두 URL은 1시간 후 만료되며 `POST /api/v2/orders/{orderId}/refresh-urls`로 재발급할 수 있습니다. signed token 자체가 테스트 업로드를 인가하므로 PUT에 Authorization 헤더가 필요 없습니다. 테스트 요청 본문은 스트림으로 소비되어 저장되지 않으며, 테스트 주문은 사용량 차감이나 실제 외부 처리 없이 모의 결과로 전이합니다. fileKey: type: string description: | 파일 식별자: live 키에서는 S3 object key이고 테스트 키에서는 격리된 logical key입니다. 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 Forbidden: description: API 키가 요청한 모드를 사용할 권한이 없음 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: code: AUTH_FORBIDDEN UsageLimitExceeded: description: 사용량 한도 초과 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: code: USAGE_LIMIT_EXCEEDED securitySchemes: BearerAuth: type: http scheme: bearer description: >- 외부 클라이언트 접근을 위한 Bearer API 키. 일반 키는 `sk_` 접두사를 사용하고, 테스트 키는 `sk_test_` 접두사로 모의 응답을 사용해 실제 처리나 크레딧 사용 없이 주문 흐름을 검증합니다. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.