Skip to main content
POST
cURL

이미지 업로드 방법

응답에서 받은 uploadUrl을 사용하여 PUT 요청으로 이미지를 업로드합니다. 일반 키는 프리사인드 저장소 URL을 반환하고, 테스트 키는 요청 본문을 소비한 뒤 폐기하는 BIZ MORI 테스트 업로드 URL을 반환합니다:
일반 프리사인드 업로드 URL은 10분 후 만료됩니다. 테스트 업로드 URL에는 자체 인증 정보가 있으므로 Bearer 헤더가 필요하지 않습니다. URL이 만료되기 전에 업로드하고 주문 확인 엔드포인트를 호출하세요.

감지 결과 확인

업로드를 확인하면 주문 상태가 inProgress로 변경됩니다. 감지가 완료되면 다음 방법으로 결과를 확인할 수 있습니다:
  1. 웹훅order.aiDetection.completed 또는 order.aiDetection.failed 이벤트 구독
  2. 폴링주문 상세 조회 엔드포인트를 상태가 complete 또는 failed가 될 때까지 호출
감지 결과는 주문 상세 응답의 aiDetection 필드에 포함됩니다:
테스트 주문은 파일명으로 감지 결과를 고정합니다. _ai는 확률 0.98, _human은 확률 0.02를 반환합니다. 테스트 주문은 다운로드 가능한 히트맵·오버레이 파일을 만들지 않습니다.

상태 코드

인증

Authorization
string
header
필수

외부 클라이언트 접근을 위한 Bearer API 키. 일반 키는 sk_ 접두사를 사용하고, 테스트 키는 sk_test_ 접두사로 모의 응답을 사용해 실제 처리나 크레딧 사용 없이 주문 흐름을 검증합니다.

본문

application/json
idempotencyKey
string
필수

중복 요청 방지를 위한 멱등성 키

예시:

"0e6c4a9b-b1d8-457e-a9fc-4b7d0e3a6c59"

fileName
string
필수

이미지 파일명 (확장자 포함). 지원 형식: jpg, jpeg, png, webp, bmp, tiff

예시:

"photo.jpg"

orderName
string

주문명 (선택 사항, 미입력 시 자동 생성)

Maximum string length: 64
예시:

"my-detection-order"

options
object

출력 옵션 (선택사항). 생성된 파일은 주문 상세 조회 응답에 포함됩니다.

응답

주문 생성 성공

data
object