> ## 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. # AI Detection 주문 생성 > AI Detection 주문을 생성하고 이미지 업로드 URL을 발급합니다. live 키는 S3 presigned URL을 받고, 테스트 키는 절대 BIZ MORI test-upload URL을 받습니다. ## 처리 흐름 1. 이 엔드포인트를 호출하여 업로드 URL을 발급받습니다 2. live S3 URL 또는 테스트 BIZ MORI URL로 이미지를 업로드합니다 3. `POST /api/v2/orders/ai-detection/confirm` 을 호출하여 비동기 감지를 시작합니다 4. 웹훅 또는 주문 상세 조회 엔드포인트를 통해 결과를 확인합니다 ## 주문 상태 | 상태 | 설명 | |------|------| | `pending` | 파일 업로드 대기 중 | | `inProgress` | 감지 처리 중 | | `complete` | 감지 완료, 결과 확인 가능 | | `failed` | 감지 실패 | ## 지원 파일 형식 jpg, jpeg, png, webp, bmp, tiff ## 이미지 업로드 방법 응답에서 받은 `uploadUrl`을 사용하여 `PUT` 요청으로 이미지를 업로드합니다. 일반 키는 프리사인드 저장소 URL을 반환하고, 테스트 키는 요청 본문을 소비한 뒤 폐기하는 BIZ MORI 테스트 업로드 URL을 반환합니다: ```bash theme={null} curl -X PUT "UPLOAD_URL" \ -H "Content-Type: image/jpeg" \ --data-binary @photo.jpg ``` > [!NOTE] > > 일반 프리사인드 업로드 URL은 **1시간** 후 만료됩니다. 테스트 업로드 URL에는 자체 인증 정보가 있으므로 Bearer 헤더가 필요하지 않습니다. URL이 만료되기 전에 업로드하고 [주문 확인](https://docs.contentcare.ai/ko/api-reference/ai-detection/confirm-order.md) 엔드포인트를 호출하세요. ## 감지 결과 확인 업로드를 확인하면 주문 상태가 `inProgress`로 변경됩니다. 감지가 완료되면 다음 방법으로 결과를 확인할 수 있습니다: 1. **웹훅** — `order.aiDetection.completed` 또는 `order.aiDetection.failed` 이벤트 구독 2. **폴링** — [주문 상세 조회](https://docs.contentcare.ai/ko/api-reference/orders/get-order-v3.md)를 `status`가 `complete` 또는 `failed`가 될 때까지 호출 주문이 `complete`가 되면 감지 결과는 `result`에 들어 있습니다. 아래 예시는 주문 공통 필드를 생략했습니다. 전체 응답은 [주문 상세 조회](https://docs.contentcare.ai/ko/api-reference/orders/get-order-v3.md)를 참고하세요. ```json theme={null} { "data": { "type": "aiDetection", "orderId": "...", "status": "complete", "result": { "verdict": "likely_ai", "probability": 0.97, "options": { "generateHeatmap": true, "generateOverlay": false, "generateThumbnail": true }, "originalImageUrl": "https://...", "heatmapUrl": "https://...", "overlayUrl": null } } } ``` > [!NOTE] > > 테스트 주문은 파일명으로 감지 결과를 고정합니다. `_ai`는 확률 `0.98`, `_human`은 확률 `0.02`를 반환합니다. 테스트 주문은 다운로드 가능한 히트맵·오버레이 파일을 만들지 않습니다. ### 판정 | `result.verdict` | 확률 구간 | 의미 | | - | - | - | | `likely_ai` | ≥ 0.75 | AI 생성일 가능성이 높음 | | `uncertain_ai` | 0.5 – 0.75 | AI 생성일 가능성이 있음 | | `uncertain_real` | 0.25 – 0.5 | AI 생성이 아닐 가능성이 있음 | | `likely_real` | \< 0.25 | AI 생성이 아닐 가능성이 높음 | ## OpenAPI ````yaml ko/api-reference/openapi.yaml POST /api/v2/orders/ai-detection 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/ai-detection: post: tags: - AI Detection summary: AI Detection 주문 생성 description: > AI Detection 주문을 생성하고 이미지 업로드 URL을 발급합니다. live 키는 S3 presigned URL을 받고, 테스트 키는 절대 BIZ MORI test-upload URL을 받습니다. ## 처리 흐름 1. 이 엔드포인트를 호출하여 업로드 URL을 발급받습니다 2. live S3 URL 또는 테스트 BIZ MORI URL로 이미지를 업로드합니다 3. `POST /api/v2/orders/ai-detection/confirm` 을 호출하여 비동기 감지를 시작합니다 4. 웹훅 또는 주문 상세 조회 엔드포인트를 통해 결과를 확인합니다 ## 주문 상태 | 상태 | 설명 | |------|------| | `pending` | 파일 업로드 대기 중 | | `inProgress` | 감지 처리 중 | | `complete` | 감지 완료, 결과 확인 가능 | | `failed` | 감지 실패 | ## 지원 파일 형식 jpg, jpeg, png, webp, bmp, tiff operationId: createAiDetectionOrder requestBody: required: true content: application/json: schema: type: object required: - idempotencyKey - fileName properties: idempotencyKey: type: string description: 중복 요청 방지를 위한 멱등성 키 example: 0e6c4a9b-b1d8-457e-a9fc-4b7d0e3a6c59 orderName: type: string maxLength: 64 description: 주문명 (선택 사항, 미입력 시 자동 생성) example: my-detection-order fileName: type: string description: '이미지 파일명 (확장자 포함). 지원 형식: jpg, jpeg, png, webp, bmp, tiff' example: photo.jpg options: type: object description: 출력 옵션 (선택사항). 생성된 파일은 주문 상세 조회 응답에 포함됩니다. properties: generateHeatmap: type: boolean default: false description: AI 판별 히트맵 이미지 생성 여부 generateOverlay: type: boolean default: false description: 원본 위 히트맵 오버레이 이미지 생성 여부 generateThumbnail: type: boolean default: false description: 썸네일 이미지 생성 여부 responses: '200': description: 주문 생성 성공 content: application/json: schema: type: object properties: data: type: object properties: orderId: type: string description: 주문 ID orderName: type: string description: 주문명 status: type: string enum: - pending description: 주문 상태 file: type: object 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시간 후 만료됩니다. signed token 자체가 테스트 업로드를 인가하므로 PUT에 Authorization 헤더가 필요 없습니다. 테스트 요청 본문은 스트림으로 소비되어 저장되지 않으며, 테스트 주문은 사용량 차감이나 실제 외부 처리 없이 모의 결과로 전이합니다. fileKey: type: string description: > 파일 식별자: live 키에서는 S3 object key이고 테스트 키에서는 격리된 logical key입니다. '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/ai-detection \ -H "Authorization: Bearer YOUR_API_TOKEN" \ -H "Content-Type: application/json" \ -d '{"idempotencyKey": "0e6c4a9b-b1d8-457e-a9fc-4b7d0e3a6c59", "fileName": "photo.jpg"}' - lang: javascript label: JavaScript source: >- const response = await fetch('https://api.bizmori.com/api/v2/orders/ai-detection', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_TOKEN', 'Content-Type': 'application/json' }, body: JSON.stringify({ idempotencyKey: '0e6c4a9b-b1d8-457e-a9fc-4b7d0e3a6c59', fileName: 'photo.jpg' }) }); const data = await response.json(); - lang: python label: Python source: |- import requests response = requests.post( 'https://api.bizmori.com/api/v2/orders/ai-detection', headers={'Authorization': 'Bearer YOUR_API_TOKEN'}, json={'idempotencyKey': '0e6c4a9b-b1d8-457e-a9fc-4b7d0e3a6c59', 'fileName': 'photo.jpg'} ) 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 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.