Skip to main content
POST
cURL
sk_test_ 키를 사용하면 테스트 API 키에 설명된 테스트 주문 흐름을 따릅니다. 테스트 업로드는 응답의 BIZ MORI 업로드 URL을 사용하며 결과 파일은 만들지 않습니다.

주문 결과 다운로드

주문이 complete 상태가 되면 주문 결과 다운로드 URL 발급을 호출하세요. 한 번의 호출로 결과 파일별 URL(files[])과 결과 전체 ZIP(archiveUrl)을 함께 받습니다.
URL은 최대 1시간 동안 유효하므로 다운로드할 때마다 새로 요청하세요. 파일은 주문의 expiresAt까지 내려받을 수 있으며, 그 뒤에는 400 ORDER_EXPIRED를 반환합니다. sk_test_ 주문의 URL은 실제 결과가 아니라 고정 샘플 파일을 가리킵니다.

인증

Authorization
string
header
필수

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

본문

application/json
idempotencyKey
string
필수

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

files
object[]
필수
Required array length: 1 - 100 elements
orderName
string

주문 이름 (미입력 시 자동 생성)

Maximum string length: 64
mode
object

처리 모드 설정

outputTargets
object[]

Zero Copy 모드 결과 업로드 대상 (mode.zeroCopy가 true일 때 필수)

options
object

응답

주문 생성 성공

data
object