> ## 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-embed`를 사용하세요. 이 엔드포인트의 모든 응답(인증 오류와 `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 안내 메시지가 담기며, 과금되지 않고 크레딧은 복원됩니다. - 종료 시각에 이미 처리 중인 주문은 결과 기록까지 마칩니다. 이후 새로 다시 실행하지는 않습니다. 워터마크 삽입 주문을 생성합니다. - 이미지당 최대 10개의 워터마크 텍스트 - 주문당 최대 100개의 파일 - 지원 이미지 형식 (IMG): jpg, jpeg, png, webp, bmp, tiff - 지원 문서 형식 (DOCUMENT): pdf ## 입력 모드 (업로드 / URL / 혼합) 입력 모드는 각 파일 객체의 `originalFileUrl` 존재 여부에 따라 결정됩니다: - **업로드 모드** (`originalFileUrl` 없음): Presigned URL 발급 → 클라이언트가 S3에 업로드 → 처리 자동 시작 - **URL 모드** (`originalFileUrl` 제공): 해당 URL에서 이미지를 다운로드하여 즉시 처리 - **혼합 모드**: 일부 파일은 업로드 모드, 나머지는 URL 모드로 동시 처리 ### 동작 방식 | 조건 | 주문 상태 | Confirm 필요 여부 | |------|---------|-----------------| | 모든 파일에 `originalFileUrl` 있음 | `pending` | 불필요 (서버 다운로드 후 자동 시작) | | `originalFileUrl` 없는 파일 존재 | `pending` | 불필요 (업로드 후 자동 시작) | Anti-AI, AI Detection과 달리 Watermark Embed는 별도의 confirm 단계가 필요하지 않습니다. 파일 업로드가 완료되면 처리가 자동으로 시작됩니다. > [!WARNING] > > **지원 종료.** 이 v2 엔드포인트는 2026년 10월 9일 09:00 KST(00:00 UTC)에 지원이 종료되었습니다. 새로 연동한다면 [`POST /api/v3/orders/wtr-embed`](https://docs.contentcare.ai/ko/api-reference/watermark-embed/create-order-v3)를 사용하고, 마이그레이션 방법은 [워터마크 삽입 빠른 시작](https://docs.contentcare.ai/ko/quickstart/watermark-embed.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 엔드포인트로 새로 요청하세요. > [!NOTE] > > `sk_test_` 키를 사용하면 응답의 BIZ MORI 테스트 업로드 URL로 파일을 업로드합니다. 업로드가 끝나면 confirm 없이 처리가 시작되며 다운로드 가능한 결과 파일은 만들지 않습니다. ## 주문 결과 다운로드 주문이 `complete` 상태가 되면 [주문 결과 다운로드 URL 발급](https://docs.contentcare.ai/ko/api-reference/orders/download-order-v3.md)을 호출하세요. 한 번의 호출로 결과 파일별 URL(`files[]`)과 결과 전체 ZIP(`archiveUrl`)을 함께 받습니다. ```bash theme={null} curl -X GET https://api.bizmori.com/api/v3/orders/{orderId}/download \ -H "Authorization: Bearer YOUR_API_KEY" ``` > [!WARNING] > > URL은 최대 1시간 동안 유효하므로 다운로드할 때마다 새로 요청하세요. 파일은 주문의 `expiresAt`까지 내려받을 수 있으며, 그 뒤에는 `400 ORDER_EXPIRED`를 반환합니다. `sk_test_` 주문의 URL은 실제 결과가 아니라 고정 샘플 파일을 가리킵니다. ## OpenAPI ````yaml ko/api-reference/openapi.yaml POST /api/v2/orders/wtr-embed 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-embed: post: tags: - Watermark Embed summary: 워터마크 삽입 주문 생성 description: > **지원 종료.** 이 엔드포인트는 2026년 10월 9일 09:00 KST(00:00 UTC)에 지원이 종료되었습니다. `POST /api/v3/orders/wtr-embed`를 사용하세요. 이 엔드포인트의 모든 응답(인증 오류와 `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 안내 메시지가 담기며, 과금되지 않고 크레딧은 복원됩니다. - 종료 시각에 이미 처리 중인 주문은 결과 기록까지 마칩니다. 이후 새로 다시 실행하지는 않습니다. 워터마크 삽입 주문을 생성합니다. - 이미지당 최대 10개의 워터마크 텍스트 - 주문당 최대 100개의 파일 - 지원 이미지 형식 (IMG): jpg, jpeg, png, webp, bmp, tiff - 지원 문서 형식 (DOCUMENT): pdf ## 입력 모드 (업로드 / URL / 혼합) 입력 모드는 각 파일 객체의 `originalFileUrl` 존재 여부에 따라 결정됩니다: - **업로드 모드** (`originalFileUrl` 없음): Presigned URL 발급 → 클라이언트가 S3에 업로드 → 처리 자동 시작 - **URL 모드** (`originalFileUrl` 제공): 해당 URL에서 이미지를 다운로드하여 즉시 처리 - **혼합 모드**: 일부 파일은 업로드 모드, 나머지는 URL 모드로 동시 처리 ### 동작 방식 | 조건 | 주문 상태 | Confirm 필요 여부 | |------|---------|-----------------| | 모든 파일에 `originalFileUrl` 있음 | `pending` | 불필요 (서버 다운로드 후 자동 시작) | | `originalFileUrl` 없는 파일 존재 | `pending` | 불필요 (업로드 후 자동 시작) | Anti-AI, AI Detection과 달리 Watermark Embed는 별도의 confirm 단계가 필요하지 않습니다. 파일 업로드가 완료되면 처리가 자동으로 시작됩니다. operationId: createWatermarkEmbedOrder requestBody: required: true content: application/json: schema: type: object required: - idempotencyKey - files properties: idempotencyKey: type: string description: 멱등성 키 files: type: array minItems: 1 maxItems: 100 items: type: object required: - fileName - watermarks properties: fileName: type: string description: 파일 이름 example: image.jpg originalFileUrl: type: string format: uri description: | 원본 이미지 URL (선택) - 제공 시: URL 모드 (presigned URL 미발급, 즉시 처리) - 미제공 시: 업로드 모드 (presigned URL 발급) example: https://example.com/image.jpg watermarks: type: array minItems: 1 maxItems: 10 items: type: object required: - text properties: text: type: string maxLength: 1000 description: 워터마크 텍스트 examples: uploadMode: summary: 업로드 모드 (기본) value: idempotencyKey: 5e9c7a3b-b4d2-4f18-83e6-8b1a2d5f7c93 files: - fileName: image1.jpg watermarks: - text: MORI_WATERMARK - fileName: image2.png watermarks: - text: MORI_WATERMARK urlMode: summary: URL 모드 (즉시 처리) value: idempotencyKey: 6f1d8b4c-c5e3-4029-94f7-9c2b3e6a8d04 files: - fileName: image1.jpg originalFileUrl: https://example.com/image1.jpg watermarks: - text: MORI_WATERMARK - fileName: image2.png originalFileUrl: https://example.com/image2.png watermarks: - text: MORI_WATERMARK mixedMode: summary: 혼합 모드 value: idempotencyKey: 7a2e9c5d-d6f4-413a-a5b8-0d3c4f7b9e15 files: - fileName: upload-file.jpg watermarks: - text: MORI_WATERMARK - fileName: url-file.png originalFileUrl: https://example.com/image.png watermarks: - text: MORI_WATERMARK 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 orderId: type: string status: type: string enum: - pending description: | 주문 상태 - `pending`: 입력 모드에 관계없이 항상 반환 files: type: array items: type: object description: >- 파일 정보 (모드에 따라 필드가 다릅니다) - 업로드 모드: fileId, fileName, uploadUrl, fileKey, fileFormat, fileType - URL 모드: fileId, fileName, originalFileUrl, fileKey, fileFormat, fileType properties: fileId: type: integer fileName: type: string uploadUrl: type: string format: uri description: >- 업로드 URL이며 업로드 모드에서만 반환됩니다. live 키는 S3 presigned URL을 받고, 테스트 키는 절대 `https://api.bizmori.com/api/v2/test-uploads/{signedToken}` URL을 받습니다. 두 URL은 1시간 후 만료됩니다. signed token 자체가 테스트 업로드를 인가하므로 PUT에 Authorization 헤더가 필요 없습니다. 테스트 요청 본문은 스트림으로 소비되어 저장되지 않으며, 테스트 주문은 사용량 차감이나 실제 외부 처리 없이 모의 결과로 전이합니다. originalFileUrl: type: string format: uri description: 요청에 전달된 공개 이미지 URL. URL 모드에서만 반환됩니다. fileKey: type: string description: > 파일 식별자: live 키에서는 S3 object key이고 테스트 키에서는 격리된 logical key입니다. fileFormat: type: string description: 파일 형식. enum: - JPG - PNG - WEBP - BMP - TIFF - PDF fileType: type: string description: 파일 유형 분류. enum: - IMG - DOCUMENT examples: uploadModeResponse: summary: 업로드 모드 응답 value: data: orderName: wtr_embed_20260318120000.000 orderId: '424706541233094656' status: pending files: - fileId: 2469 fileName: image.jpg uploadUrl: >- https://s3.ap-northeast-2.amazonaws.com/...?X-Amz-Algorithm=AWS4-HMAC-SHA256&... fileKey: wtr-embed/424706541233094656/images/1/image.jpg fileFormat: JPG fileType: IMG - fileId: 2470 fileName: document.pdf uploadUrl: >- https://s3.ap-northeast-2.amazonaws.com/...?X-Amz-Algorithm=AWS4-HMAC-SHA256&... fileKey: >- wtr-embed/424706541233094656/documents/2/document.pdf fileFormat: PDF fileType: DOCUMENT urlModeResponse: summary: URL 모드 응답 value: data: orderName: wtr_embed_20260318120000.000 orderId: '424707536709206016' status: pending files: - fileId: 2490 fileName: image.png originalFileUrl: https://example.com/image.jpg fileKey: wtr-embed/424707536709206016/images/1/image.png fileFormat: PNG fileType: IMG mixedModeResponse: summary: 혼합 모드 응답 value: data: orderName: wtr_embed_20260318120000.000 orderId: '424707536709206016' status: pending files: - fileId: 2490 fileName: image.png originalFileUrl: https://example.com/image.jpg fileKey: wtr-embed/424707536709206016/images/1/image.png fileFormat: PNG fileType: IMG - fileId: 2491 fileName: photo.jpeg uploadUrl: >- https://s3.ap-northeast-2.amazonaws.com/...?X-Amz-Algorithm=AWS4-HMAC-SHA256&... fileKey: wtr-embed/424707536709206016/images/2/photo.jpeg fileFormat: JPG fileType: IMG '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-embed \ -H "Authorization: Bearer YOUR_API_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "idempotencyKey": "5e9c7a3b-b4d2-4f18-83e6-8b1a2d5f7c93", "files": [ { "fileName": "image.jpg", "watermarks": [{"text": "MORI_WATERMARK"}] } ] }' - lang: javascript label: JavaScript source: >- const response = await fetch('https://api.bizmori.com/api/v2/orders/wtr-embed', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_TOKEN', 'Content-Type': 'application/json' }, body: JSON.stringify({ idempotencyKey: '5e9c7a3b-b4d2-4f18-83e6-8b1a2d5f7c93', files: [ { fileName: 'image.jpg', watermarks: [{ text: 'MORI_WATERMARK' }] } ] }) }); const data = await response.json(); - lang: python label: Python source: |- import requests response = requests.post( 'https://api.bizmori.com/api/v2/orders/wtr-embed', headers={'Authorization': 'Bearer YOUR_API_TOKEN'}, json={ 'idempotencyKey': '5e9c7a3b-b4d2-4f18-83e6-8b1a2d5f7c93', 'files': [ { 'fileName': 'image.jpg', 'watermarks': [{'text': 'MORI_WATERMARK'}] } ] } ) data = response.json() components: 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 schemas: ErrorResponse: type: object properties: code: type: string description: 에러 코드 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.