확인을 위해 현재 어떤 엔드포인트를 사용 중이신지 알려주실 수 있을까요? 예를 들어 /v1/document-digitization 또는 Studio의 /v2/responses 등을 사용하고 계신지 확인 부탁드립니다.
참고로 Studio Jobs API의 background 작업을 사용 중이신 경우에는 POST /v2/responses/{job_id}/cancel 엔드포인트를 통해 진행 중인 작업을 취소하실 수 있습니다.
다만 표준 Document Parse 비동기 API의 경우 현재는 request_id 기반으로 작업을 취소하는 기능은 제공하고 있지 않은 점 양해 부탁드립니다.
정수민
•
Jul 16
안녕하세요.
먼저 답변주셔서 감사합니다.
두 가지 질문드리겠습니다. 현재 AWS Marketplace에서 구독하여 “/v1/document-digitization”를 사용하고 있습니다.
현재 사용하고 있는 “v1/document-digitization” 은 cancel기능을 사용할 수 없다고 이해하면 될까요? 그렇다면, 추후에 관련 기능이 개발될 수 있을까요?
말씀하신 Studio Jobs API가 이미지와 같은 AWS Market의 “DocumentParse_Studio_InferenceCount”를 사용하면 Cancle request가 가능할까요? (가능하다면 관련 비동기 코드도 함께 주시면 감사하겠습니다)
답변 부탁드립니다.
감사합니다. :)
Tim(임주현)
Team•
Jul 16
안녕하세요.
문의주신 내용을 기준으로 아래와 같이 안내드립니다.
/v1/document-digitization은 Document Parse API 엔드포인트이며, 동기 및 비동기 호출 방식에 따라 동작이 다릅니다.
1. 동기 요청
동기 요청의 경우, 요청을 수행한 클라이언트에서 연결을 종료하거나 Ctrl+C 등으로 요청을 중단할 수 있습니다. 다만 이는 클라이언트가 응답 대기를 중단하는 것이며, 이미 서버에 전달된 처리 작업까지 즉시 취소되는 것을 보장하는 별도의 Cancel API는 제공되지 않습니다. 요청이 서버에서 이미 처리 중인 경우에는 백엔드 작업이 계속 수행될 수 있습니다.
2. 비동기 요청 (/v1/document-digitization)
현재 /v1/document-digitization의 비동기 요청에 대해서는, 제출된 작업을 명시적으로 취소할 수 있는 Cancel API가 제공되지 않습니다.
3. Studio Jobs API
Studio Jobs API(v2)를 통해 제출된 백그라운드 작업의 경우, 아래 Cancel API로 진행 중인 작업을 취소할 수 있습니다.
POST /v2/document-intelligence/responses/{job_id}/cancel
진행 중(IN_PROGRESS)인 작업은 취소 요청 시 CANCELLING 상태로 전환되며, 이후 CANCELLED로 최종 처리됩니다.
이미 완료/실패 등 종료 상태인 작업에 취소를 요청하면 별도 동작 없이 현재 작업 상태가 그대로 반환됩니다.
따라서 작업 취소가 필요한 경우, Studio Jobs API(v2) 경로 사용을 권장드립니다.
4. AWS Marketplace 과금 항목
AWS Marketplace에 표시되는 DocumentParse_Studio_InferenceCount는 Studio에서 수행된 추론 사용량을 측정하기 위한 과금 단위입니다. 작업 취소는 진행 중인 처리를 중단하는 기능이며, 취소 시점까지 이미 수행된 추론 사용량에 대한 과금이 소급 취소되는 것은 아닌 점 참고 부탁드립니다.
(v1 비동기 요청의 취소 기능은 제품 로드맵 검토가 필요한 사항이므로, 구체적인 사용 사례와 필요 배경을 전달해주시면 제품팀에 기능 요청으로 공유하겠습니다.)
정수민
•
Jul 17
빠른 답변 감사합니다!
저는 개인정보가 포함된 대량 문서(100장 이상)를 다루는 연구를 진행하고 있는 대학원생입니다. Document Parse의 성능이 좋아서 AWS 환경에서 활용하고 있는데, 사용하다 보니 몇 가지 궁금한 점이 생겨 여쭤봅니다.
보안 관련: 아직 Studio 개념을 정확히 이해하지 못한 상태라 기본적인 질문일 수도 있는데요, Studio에 파일을 업로드(create)하는 방식이 v1 API 호출과 비교했을 때 보안 측면에서 차이가 있는지 궁금합니다. 저희가 다루는 문서에 개인정보가 포함되어 있어서, Studio에 올려도 안전한지 확인하고 진행하고 싶습니다.
성능 관련: Studio에서 Job을 생성하는 방식이 v1 비동기 방식과 실제로 어떤 차이가 있는지 궁금합니다. 저희가 대량의 파일로 테스트해봤을 때 요청이 큐에 많이 쌓이면서, 대량 문서를 빠르게 처리한다는 장점을 충분히 체감하기 어려웠습니다. 그래서 이전에 cancel 기능을 요청드렸던 것이기도 합니다.
응답 형식 관련: v2로 전환할 경우 응답(response) 형식이 기존 v1/document-digitization과 다른지도 궁금합니다. 만약 형식이 다르다면 저희 쪽에서 파싱 로직을 다시 수정해야 해서, 전환 전에 그 차이를 미리 파악하고 싶습니다.
비용 관련: AWS Marketplace 과금 기준을 보니 v1은 $0.01, v2(Studio)는 $0.012로 처리 단가 외에 Studio를 생성하고 유지하는 것 자체에 별도로 부과되는 비용(예: 에이전트/워크플로우 유지비, 구독료, 저장 비용 등)이 있는지도 확인 부탁드립니다.
혹시 Studio 방식에 보안상 문제가 없다면 이 방식으로 진행해보려고 합니다. 확인해주시면 감사하겠습니다!
Tim(임주현)
Team•
Jul 20
안녕하세요. 자세한 문의 남겨주셔서 감사합니다.
문의주신 내용을 항목별로 안내드리겠습니다.
먼저 보안 측면에서는 v1 Document Parse API와 Studio API 사이에 차이가 있습니다.v1 Document Parse API는 요청 처리 후 결과를 별도로 저장하지 않는 stateless 방식입니다. 반면 Studio API는 작업 이력과 결과를 이후에도 확인하고 활용할 수 있도록 당사 서버에 저장합니다.
Studio에 저장되는 데이터는 개인정보처리방침에 따른 내부 절차를 준수하여 관리되며, 암호화 등 필요한 보안 조치도 적용되어 있습니다. 따라서 Studio에 파일을 업로드하고 결과를 저장하는 것 자체에는 문제가 없지만, 연구 요건상 개인정보가 포함된 문서와 결과가 서버에 저장되지 않아야 한다면 v1 API를 사용하시는 편이 더 적합합니다.
성능 측면에서는 Studio 역시 내부적으로 Document Parse를 사용하기 때문에, 순수한 문서 파싱 처리 성능은 v1 비동기 API와 크게 다르지 않습니다. Studio는 대신 작업 취소, 단계별 결과 조회 등 운영과 관리에 필요한 기능을 추가로 제공합니다.
다만 말씀해주신 것처럼 하루 1만 장 이상의 대규모 문서를 빠르게 처리하는 것이 가장 중요한 경우에는 현재 기준으로 v1 비동기 API 사용을 권장드립니다.
응답 형식의 경우 v2 API는 워크플로우의 각 Step별로 결과를 제공합니다. 요청 시 include=["all"] 옵션을 사용하면 전체 Step의 결과를 확인할 수 있으며, 이 중 Parse Step 내부의 결과 형식은 기존 v1/document-digitization 응답과 동일합니다. 따라서 Parse 결과만 사용하신다면 기존 파싱 로직을 대부분 그대로 활용하실 수 있습니다.
비용과 관련해서는 안내된 문서 처리 단가 외에 Studio 생성이나 유지에 따른 별도의 구독료는 없습니다. 또한 에이전트 또는 워크플로우 유지비, 별도의 저장 비용도 현재 부과되지 않습니다.
문서 Parse 기능만 필요하고 데이터가 저장되지 않는 것이 중요하다면 v1 API가 더 적합합니다. 반면 작업 취소나 단계별 결과 관리 등 Studio의 운영 기능이 필요하다면 v2 API를 고려하실 수 있습니다.
v1 API에도 작업 취소 기능을 추가하는 방안은 현재 로드맵에 포함되어 있으나, 아직은 제공되지 않고 있습니다. 보내주신 대량 처리 및 취소 기능 관련 의견은 향후 로드맵 우선순위를 검토할 때 함께 반영하겠습니다.
Log in to comment and vote
Comments5
Tim(임주현)
Jul 16
안녕하세요.
확인을 위해 현재 어떤 엔드포인트를 사용 중이신지 알려주실 수 있을까요? 예를 들어
/v1/document-digitization또는 Studio의/v2/responses등을 사용하고 계신지 확인 부탁드립니다.참고로 Studio Jobs API의 background 작업을 사용 중이신 경우에는
POST /v2/responses/{job_id}/cancel엔드포인트를 통해 진행 중인 작업을 취소하실 수 있습니다.다만 표준 Document Parse 비동기 API의 경우 현재는
request_id기반으로 작업을 취소하는 기능은 제공하고 있지 않은 점 양해 부탁드립니다.정수민
Jul 16
안녕하세요.
먼저 답변주셔서 감사합니다.
두 가지 질문드리겠습니다. 현재 AWS Marketplace에서 구독하여 “/v1/document-digitization”를 사용하고 있습니다.
현재 사용하고 있는 “v1/document-digitization” 은 cancel기능을 사용할 수 없다고 이해하면 될까요? 그렇다면, 추후에 관련 기능이 개발될 수 있을까요?
말씀하신 Studio Jobs API가 이미지와 같은 AWS Market의 “DocumentParse_Studio_InferenceCount”를 사용하면 Cancle request가 가능할까요? (가능하다면 관련 비동기 코드도 함께 주시면 감사하겠습니다)
답변 부탁드립니다.
감사합니다. :)
Tim(임주현)
Jul 16
안녕하세요.
문의주신 내용을 기준으로 아래와 같이 안내드립니다.
/v1/document-digitization은 Document Parse API 엔드포인트이며, 동기 및 비동기 호출 방식에 따라 동작이 다릅니다.
1. 동기 요청
동기 요청의 경우, 요청을 수행한 클라이언트에서 연결을 종료하거나 Ctrl+C 등으로 요청을 중단할 수 있습니다.
다만 이는 클라이언트가 응답 대기를 중단하는 것이며, 이미 서버에 전달된 처리 작업까지 즉시 취소되는 것을 보장하는 별도의 Cancel API는 제공되지 않습니다. 요청이 서버에서 이미 처리 중인 경우에는 백엔드 작업이 계속 수행될 수 있습니다.
2. 비동기 요청 (/v1/document-digitization)
현재 /v1/document-digitization의 비동기 요청에 대해서는, 제출된 작업을 명시적으로 취소할 수 있는 Cancel API가 제공되지 않습니다.
3. Studio Jobs API
Studio Jobs API(v2)를 통해 제출된 백그라운드 작업의 경우, 아래 Cancel API로 진행 중인 작업을 취소할 수 있습니다.
진행 중(IN_PROGRESS)인 작업은 취소 요청 시 CANCELLING 상태로 전환되며, 이후 CANCELLED로 최종 처리됩니다.
이미 완료/실패 등 종료 상태인 작업에 취소를 요청하면 별도 동작 없이 현재 작업 상태가 그대로 반환됩니다.
따라서 작업 취소가 필요한 경우, Studio Jobs API(v2) 경로 사용을 권장드립니다.
4. AWS Marketplace 과금 항목
AWS Marketplace에 표시되는 DocumentParse_Studio_InferenceCount는 Studio에서 수행된 추론 사용량을 측정하기 위한 과금 단위입니다. 작업 취소는 진행 중인 처리를 중단하는 기능이며, 취소 시점까지 이미 수행된 추론 사용량에 대한 과금이 소급 취소되는 것은 아닌 점 참고 부탁드립니다.
(v1 비동기 요청의 취소 기능은 제품 로드맵 검토가 필요한 사항이므로, 구체적인 사용 사례와 필요 배경을 전달해주시면 제품팀에 기능 요청으로 공유하겠습니다.)
정수민
Jul 17
빠른 답변 감사합니다!
저는 개인정보가 포함된 대량 문서(100장 이상)를 다루는 연구를 진행하고 있는 대학원생입니다. Document Parse의 성능이 좋아서 AWS 환경에서 활용하고 있는데, 사용하다 보니 몇 가지 궁금한 점이 생겨 여쭤봅니다.
보안 관련: 아직 Studio 개념을 정확히 이해하지 못한 상태라 기본적인 질문일 수도 있는데요, Studio에 파일을 업로드(create)하는 방식이 v1 API 호출과 비교했을 때 보안 측면에서 차이가 있는지 궁금합니다. 저희가 다루는 문서에 개인정보가 포함되어 있어서, Studio에 올려도 안전한지 확인하고 진행하고 싶습니다.
성능 관련: Studio에서 Job을 생성하는 방식이 v1 비동기 방식과 실제로 어떤 차이가 있는지 궁금합니다. 저희가 대량의 파일로 테스트해봤을 때 요청이 큐에 많이 쌓이면서, 대량 문서를 빠르게 처리한다는 장점을 충분히 체감하기 어려웠습니다. 그래서 이전에 cancel 기능을 요청드렸던 것이기도 합니다.
응답 형식 관련: v2로 전환할 경우 응답(response) 형식이 기존 v1/document-digitization과 다른지도 궁금합니다. 만약 형식이 다르다면 저희 쪽에서 파싱 로직을 다시 수정해야 해서, 전환 전에 그 차이를 미리 파악하고 싶습니다.
비용 관련: AWS Marketplace 과금 기준을 보니 v1은 $0.01, v2(Studio)는 $0.012로 처리 단가 외에 Studio를 생성하고 유지하는 것 자체에 별도로 부과되는 비용(예: 에이전트/워크플로우 유지비, 구독료, 저장 비용 등)이 있는지도 확인 부탁드립니다.
혹시 Studio 방식에 보안상 문제가 없다면 이 방식으로 진행해보려고 합니다. 확인해주시면 감사하겠습니다!
Tim(임주현)
Jul 20
안녕하세요. 자세한 문의 남겨주셔서 감사합니다.
문의주신 내용을 항목별로 안내드리겠습니다.
먼저 보안 측면에서는 v1 Document Parse API와 Studio API 사이에 차이가 있습니다.v1 Document Parse API는 요청 처리 후 결과를 별도로 저장하지 않는 stateless 방식입니다. 반면 Studio API는 작업 이력과 결과를 이후에도 확인하고 활용할 수 있도록 당사 서버에 저장합니다.
Studio에 저장되는 데이터는 개인정보처리방침에 따른 내부 절차를 준수하여 관리되며, 암호화 등 필요한 보안 조치도 적용되어 있습니다. 따라서 Studio에 파일을 업로드하고 결과를 저장하는 것 자체에는 문제가 없지만, 연구 요건상 개인정보가 포함된 문서와 결과가 서버에 저장되지 않아야 한다면 v1 API를 사용하시는 편이 더 적합합니다.
성능 측면에서는 Studio 역시 내부적으로 Document Parse를 사용하기 때문에, 순수한 문서 파싱 처리 성능은 v1 비동기 API와 크게 다르지 않습니다. Studio는 대신 작업 취소, 단계별 결과 조회 등 운영과 관리에 필요한 기능을 추가로 제공합니다.
다만 말씀해주신 것처럼 하루 1만 장 이상의 대규모 문서를 빠르게 처리하는 것이 가장 중요한 경우에는 현재 기준으로 v1 비동기 API 사용을 권장드립니다.
응답 형식의 경우 v2 API는 워크플로우의 각 Step별로 결과를 제공합니다. 요청 시
include=["all"]옵션을 사용하면 전체 Step의 결과를 확인할 수 있으며, 이 중 Parse Step 내부의 결과 형식은 기존v1/document-digitization응답과 동일합니다. 따라서 Parse 결과만 사용하신다면 기존 파싱 로직을 대부분 그대로 활용하실 수 있습니다.비용과 관련해서는 안내된 문서 처리 단가 외에 Studio 생성이나 유지에 따른 별도의 구독료는 없습니다. 또한 에이전트 또는 워크플로우 유지비, 별도의 저장 비용도 현재 부과되지 않습니다.
문서 Parse 기능만 필요하고 데이터가 저장되지 않는 것이 중요하다면 v1 API가 더 적합합니다. 반면 작업 취소나 단계별 결과 관리 등 Studio의 운영 기능이 필요하다면 v2 API를 고려하실 수 있습니다.
v1 API에도 작업 취소 기능을 추가하는 방안은 현재 로드맵에 포함되어 있으나, 아직은 제공되지 않고 있습니다. 보내주신 대량 처리 및 취소 기능 관련 의견은 향후 로드맵 우선순위를 검토할 때 함께 반영하겠습니다.
감사합니다.