메인 콘텐츠로 건너뛰기

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.

이 가이드는 Anti-AI 보호 주문을 생성하는 과정을 안내합니다 — 이미지 업로드부터 보호된 결과물 다운로드까지.

​
사전 준비

  • BIZ MORI API 키 (여기서 발급)
  • 보호할 이미지 파일 (jpeg, jpg, png, webp, tiff, 또는 bmp)

​
1단계: 주문 생성

주문을 생성하고 S3에 파일을 업로드하기 위한 Presigned URL을 받습니다.
파일을 업로드하는 대신 이미지 URL을 직접 제공할 수도 있습니다. URL 모드에 대한 자세한 내용은 Anti-AI 주문 생성 API를 참고하세요.
curl -X POST https://api.bizmori.com/api/v2/orders/anti-ai \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "idempotencyKey": "01960d3e-a4f2-7b3c-8a1d-4c7e2f9b0a3d",
    "files": [{ "fileName": "photo.jpg" }]
  }'
응답: 
{
  "data": {
    "orderName": "anti_ai_2026-02-19",
    "orderId": "123456789",
    "status": "pending",
    "files": [
      {
        "fileId": 1,
        "fileName": "photo.jpg",
        "uploadUrl": "https://s3.amazonaws.com/...",
        "fileKey": "temp/123456789/0/photo.jpg"
      }
    ]
  }
}

​
2단계: 파일 업로드

1단계 응답의 uploadUrl로 파일을 PUT 업로드합니다. Authorization 헤더는 필요 없습니다 — S3 직접 업로드입니다.
cURL
curl -X PUT "https://s3.amazonaws.com/..." \
  -H "Content-Type: image/jpeg" \
  --data-binary @photo.jpg
Presigned URL은 1시간 후 만료됩니다. 만료된 경우 URL 갱신 엔드포인트를 사용하여 새 URL을 받으세요.

​
3단계: 주문 확인

모든 파일 업로드 완료 후, 처리를 시작하기 위해 주문을 확인합니다: 
curl -X POST https://api.bizmori.com/api/v2/orders/anti-ai/confirm \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"idempotencyKey": "01960d40-b5f2-7c3e-9d1a-5e7f2c9b1b4e", "orderId": "123456789"}'

​
4단계: 주문 상태 확인

주문 상태를 폴링하거나 웹훅을 설정하여 처리 완료 알림을 받습니다. 
curl https://api.bizmori.com/api/v2/orders/123456789 \
  -H "Authorization: Bearer YOUR_API_TOKEN"
응답: 
{
  "data": {
    "type": "antiAi",
    "orderId": "123456789",
    "channel": "api",
    "thumbnailImageUrl": "https://s3.amazonaws.com/...",
    "status": "complete",
    "orderName": "anti_ai_2026-03-18",
    "fileCount": 1,
    "createdAt": "2026-03-18T12:00:00.000Z",
    "updatedAt": "2026-03-18T12:01:30.000Z",
    "errors": null
  }
}
주문 상태 흐름:
상태의미
pending파일 업로드 대기 중
inProgress처리 중
complete완료 (다운로드 가능)
failed처리 실패

​
5단계: 결과 다운로드

상태가 complete이면 다운로드 URL을 받습니다: 
curl https://api.bizmori.com/api/v2/orders/123456789/download \
  -H "Authorization: Bearer YOUR_API_TOKEN"
응답: 
{
  "data": {
    "downloadUrl": "https://s3.amazonaws.com/...",
    "expiresIn": 3600
  }
}
downloadUrl은 1시간 유효한 Presigned S3 URL입니다. 이 URL로 보호된 파일을 직접 다운로드하세요. Anti-AI API에서 지원하는 옵션과 상세한 설명은 API 레퍼런스를 참고하세요.

​
에러 처리

HTTP 상태 코드의미조치
400잘못된 요청파라미터 및 파일 형식 확인
401인증 실패API 키 확인
429사용량 초과요청 빈도를 줄이거나 플랜 업그레이드
전체 에러 코드는 에러 코드 페이지를 참고하세요.

​
다음 단계

워터마크 삽입

이미지에 비가시성 워터마크를 삽입합니다.

워터마크 검출

이미지에서 비가시성 워터마크를 검출하고 추출합니다.

AI Detection

AI 생성 이미지를 확률 점수로 탐지합니다.

웹훅

처리 완료 시 알림을 받기 위해 웹훅을 설정합니다.