이 문서는 영어 원문을 자동 번역한 것으로, 내용이 원문과 다를 수 있습니다.영어 원문 보기
문서를 한 번 업로드하고 받은 파일 ID를 워크플로우 실행에 사용해요. 업로드는 문서를 준비하는 단계이며, 워크플로우 실행은 별도로 요청합니다.
Python 예제는 시작하기의 client와 저장한 ID를 사용해요. cURL은 같은 흐름에서 받은 UPSTAGE_API_KEY, WORKFLOW_ID, CONFIG_ID, FILE_ID, JOB_ID 중 해당 작업에 필요한 값을 사용합니다.
파일 업로드하기
샘플 PDF를 사용하거나 경로와 파일명을 내 문서에 맞게 바꾸세요.
파일 정보 조회하기
기본 응답에는 준비 상태가 없으므로 view=status로 요청해 status를 확인해요. pages=none은 페이지별 상세 정보를 생략합니다. PROCESSING이면 기다리고, UPLOADED 또는 READY이면 실행에 사용할 수 있어요. FAILED이면 파일 준비가 실패한 상태입니다.
업로드한 파일 찾기
결과가 여러 페이지라면 다음 페이지 조회를 참고하세요.
보관 기간 정하기
파일은 삭제되거나 만료되기 전까지 ID로 재사용할 수 있어요. 7일 뒤 만료하려면 업로드에 아래 항목을 추가하세요. created_at은 파일 생성 시점부터 기간을 계산한다는 뜻이고, 604800은 7일을 초로 나타낸 값입니다. 응답의 expires_at은 Unix 만료 시각이며, 만료 설정이 없으면 null이에요.
사용하지 않는 파일 삭제하기
삭제한 파일 ID는 새 실행에 사용할 수 없어요. 나중에 다시 처리할 파일은 남겨두세요. 요청 필드와 업로드 옵션은 Files 명세를 확인하세요.