Keyboard shortcuts

Press ← or → to navigate between chapters

Press ? to show this help

Press Esc to hide this help

이미지와 문서의 텍스트 추출

텍스트 내용만 필요한 경우와 블록 및 경계 상자까지 필요한 경우를 구분합니다. extractLayoutAwareTextV2의 결과는 구조화된 JSON입니다. format 또는 config.format의 TEXT, MARKDOWN, HTML은 블록 내용의 표현을 선택하며 응답 전체를 해당 텍스트 형식으로 바꾸지 않습니다.

이미지의 extractTextV2는 합쳐진 텍스트와 페이지별 텍스트를 JSON으로 반환합니다. 문서의 V2 레이아웃 추출과 V2 텍스트 추출은 PDF만 지원합니다. 기존 extractLayoutAwareContent도 아래에 현재 매개변수를 유지하지만 새 구성을 만들 때는 V2를 사용합니다. 이전하려면 달라진 블록 또는 응답 스키마에 맞게 결과 파서를 변경해야 합니다.

페이지와 출력 조건

작업페이지 또는 출력 조건
extractAllTextPDF의 전체 텍스트, DOCX의 일반 문단만 추출
getPdfPageDimensions페이지 치수를 포인트 단위의 JSON으로 반환
extractTextFromPagesToArray0부터 시작하는 startPage와 endPage를 모두 포함하며 생략값은 첫 페이지와 마지막 페이지
V2 추출과 VLM의 pageRange0부터 시작하는 startPageInclusive 포함, endPageExclusive 제외이며 생략한 끝은 문서 경계
ocrOnPage, ocrOnPages필수 정수 pageNumber 하나를 전달
extractUnstructuredTextFromPage필수 정수 pageNumber 하나를 전달

VLM 구성

extractVlmText의 llmSpec은 type: "chat"과 내부 chat 객체를 포함합니다. 그 안에서 실제 모델의 API 이름 또는 등록 모델 RID, 시스템 프롬프트와 사용자 프롬프트를 지정합니다. maxTokens는 요청별 생성 토큰 수의 상한입니다.

전처리는 레이아웃 기반 방식이나 텍스트 추출 방식 중 하나를 선택합니다. 레이아웃 기반 구성에서 표 영역 처리를 사용하면 cropConfig.tablePrompt가 필요합니다. imageSpec을 제공할 때는 resizingMode와 mimeType이 필수입니다. 여기서 mimeType은 PNG 같은 형식 식별자이며 image/png 문자열과 구분합니다. VLM의 outputFormat은 필수이고 허용값은 MARKDOWN입니다.

각 분기의 객체를 변환 요청의 transformation 값으로 사용합니다. type으로 분기를 선택한 다음 해당 분기의 필수 필드를 제공합니다.

변환 imageToText

이미지에서 텍스트를 추출합니다.

이름자료형필수 여부의미와 조건예시 값
typeenum필수허용값: imageToText.imageToText
operationunion<extractLayoutAwareTextV2, extractTextV2, extractLayoutAwareContent, ocr>필수이미지에서 텍스트를 추출할 작업입니다.

operation의 구조

분기 extractLayoutAwareTextV2

이미지의 텍스트 블록과 경계 상자를 구조화된 JSON으로 추출합니다. 기존 imageToText.extractLayoutAwareContent(ImageExtractLayoutAwareContentOperation)를 대체하며 블록 스키마가 다르므로 이전할 때 결과 파서를 갱신해야 합니다. format은 각 블록 내용의 일반 텍스트, Markdown 또는 HTML 형식을 선택하며 전체 결과는 JSON입니다.

이름자료형필수 여부의미와 조건예시 값
typeenum필수허용값: extractLayoutAwareTextV2.extractLayoutAwareTextV2
formatenum선택추출한 텍스트의 내용 형식입니다. 허용값: TEXT, MARKDOWN, HTML.
languageslist<OcrLanguageOrScript>선택OCR에 사용할 언어 또는 문자 체계 목록입니다.
languages의 구조

배열 항목은 OcrLanguageOrScript이며 자료형은 union<language, script>입니다.

OCR 언어 또는 문자 체계 중 하나를 지정합니다.

분기 language

OCR 언어를 지정하는 래퍼입니다.

이름자료형필수 여부의미와 조건예시 값
typeenum필수허용값: language.language
languageenum필수OCR 언어 코드입니다. 허용값은 OCR 언어를 따릅니다.
분기 script

OCR 문자 체계를 지정하는 래퍼입니다.

이름자료형필수 여부의미와 조건예시 값
typeenum필수허용값: script.script
scriptenum필수OCR 문자 체계 코드입니다. 허용값은 OCR 문자 체계를 따릅니다.

분기 extractTextV2

이미지에서 텍스트를 추출하여 합쳐진 텍스트와 페이지별 텍스트를 JSON으로 반환합니다. format은 일반 텍스트, Markdown 또는 HTML을 선택합니다. 텍스트 블록과 경계 상자가 필요하면 imageToText.extractLayoutAwareTextV2(ExtractImageLayoutAwareTextV2Operation)를 사용합니다.

이름자료형필수 여부의미와 조건예시 값
typeenum필수허용값: extractTextV2.extractTextV2
formatenum선택추출한 텍스트의 내용 형식입니다. 허용값: TEXT, MARKDOWN, HTML.
languageslist<OcrLanguageOrScript>선택OCR에 사용할 언어 또는 문자 체계 목록입니다.
languages의 구조

배열 항목은 OcrLanguageOrScript이며 자료형은 union<language, script>입니다.

OCR 언어 또는 문자 체계 중 하나를 지정합니다.

분기 language

OCR 언어를 지정하는 래퍼입니다.

이름자료형필수 여부의미와 조건예시 값
typeenum필수허용값: language.language
languageenum필수OCR 언어 코드입니다. 허용값은 OCR 언어를 따릅니다.
분기 script

OCR 문자 체계를 지정하는 래퍼입니다.

이름자료형필수 여부의미와 조건예시 값
typeenum필수허용값: script.script
scriptenum필수OCR 문자 체계 코드입니다. 허용값은 OCR 문자 체계를 따릅니다.

분기 extractLayoutAwareContent

사용을 권장하지 않는 기존 작업입니다. imageToText.extractLayoutAwareTextV2(ExtractImageLayoutAwareTextV2Operation)로 이전할 때 달라진 블록 스키마에 맞게 결과 파서를 갱신합니다.

이름자료형필수 여부의미와 조건예시 값
typeenum필수허용값: extractLayoutAwareContent.extractLayoutAwareContent
parametersobject필수레이아웃을 고려한 내용 추출의 매개변수입니다.
parameters의 구조
이름자료형필수 여부의미와 조건예시 값
languageslist<OcrLanguage>선택추출에 사용할 언어입니다.
languages의 구조

배열 항목은 OcrLanguage이며 자료형은 enum입니다.

OCR 언어 코드입니다.

허용값은 OCR 언어를 따릅니다.

분기 ocr

이미지에 OCR(광학 문자 인식)을 수행합니다.

이름자료형필수 여부의미와 조건예시 값
typeenum필수허용값: ocr.ocr
parametersobject필수OCR 작업의 매개변수입니다.
parameters의 구조
이름자료형필수 여부의미와 조건예시 값
outputFormatunion<hocr, text>필수OCR 결과의 출력 형식입니다.
languageslist<OcrLanguageOrScript>선택OCR에 사용할 언어 또는 문자 체계입니다.
outputFormat의 구조
분기 hocr

HTML 기반 hOCR 형식입니다.

이름자료형필수 여부의미와 조건예시 값
typeenum필수허용값: hocr.hocr
분기 text

일반 텍스트 형식입니다.

이름자료형필수 여부의미와 조건예시 값
typeenum필수허용값: text.text
languages의 구조

배열 항목은 OcrLanguageOrScript이며 자료형은 union<language, script>입니다.

OCR 언어 또는 문자 체계 중 하나를 지정합니다.

분기 language

OCR 언어를 지정하는 래퍼입니다.

이름자료형필수 여부의미와 조건예시 값
typeenum필수허용값: language.language
languageenum필수OCR 언어 코드입니다. 허용값은 OCR 언어를 따릅니다.
분기 script

OCR 문자 체계를 지정하는 래퍼입니다.

이름자료형필수 여부의미와 조건예시 값
typeenum필수허용값: script.script
scriptenum필수OCR 문자 체계 코드입니다. 허용값은 OCR 문자 체계를 따릅니다.

변환 documentToText

문서에서 텍스트를 추출합니다.

이름자료형필수 여부의미와 조건예시 값
typeenum필수허용값: documentToText.documentToText
operationunion필수문서에서 텍스트를 추출할 작업입니다.

operation의 구조

분기 extractTableOfContents

문서의 목차를 추출합니다.

이름자료형필수 여부의미와 조건예시 값
typeenum필수허용값: extractTableOfContents.extractTableOfContents

분기 getPdfPageDimensions

PDF의 각 페이지 치수를 포인트 단위의 JSON으로 반환합니다.

이름자료형필수 여부의미와 조건예시 값
typeenum필수허용값: getPdfPageDimensions.getPdfPageDimensions

분기 extractAllText

문서 전체 페이지의 텍스트를 추출합니다. PDF는 전체 텍스트를 포함하며 DOCX는 일반 문단만 포함합니다.

이름자료형필수 여부의미와 조건예시 값
typeenum필수허용값: extractAllText.extractAllText

분기 extractVlmText

시각 언어 모델(VLM)로 문서의 레이아웃과 구조를 해석하여 텍스트를 추출합니다.

이름자료형필수 여부의미와 조건예시 값
typeenum필수허용값: extractVlmText.extractVlmText
llmSpecunion<chat>필수언어 모델 요청의 명세입니다.
preprocessingConfigurationunion<layoutAware, extractText>선택VLM 추출의 전처리 구성입니다.
imageSpecobject선택시각 기반 추출의 이미지 처리 설정입니다. 모델에 보내기 전에 문서 페이지를 이미지로 변환하는 방식을 제어합니다.
outputFormatenum필수시각 언어 모델이 추출한 텍스트의 출력 형식입니다. 허용값: MARKDOWN.
pageRangeobject선택문서 추출의 페이지 범위입니다.
llmSpec의 구조
분기 chat

채팅 기반 LLM 명세를 지정하는 래퍼입니다.

이름자료형필수 여부의미와 조건예시 값
typeenum필수허용값: chat.chat
chatobject필수시스템 프롬프트와 사용자 프롬프트를 포함한 채팅 명세입니다.
chat의 구조
이름자료형필수 여부의미와 조건예시 값
modelLocatorunion<apiName, registeredModelRid>필수언어 모델을 찾을 식별 정보입니다.
systemPromptstring필수LLM의 시스템 프롬프트입니다.
userPromptstring필수LLM의 사용자 프롬프트입니다.
maxTokensinteger선택요청 한 번에서 생성할 최대 토큰 수입니다.
modelLocator의 구조
분기 apiName

API 이름으로 모델을 지정하는 래퍼입니다.

이름자료형필수 여부의미와 조건예시 값
typeenum필수허용값: apiName.apiName
apiNamestring필수언어 모델의 API 이름입니다.
분기 registeredModelRid

RID로 LMS 등록 모델을 지정합니다.

이름자료형필수 여부의미와 조건예시 값
typeenum필수허용값: registeredModelRid.registeredModelRid
registeredModelRidstring필수등록된 언어 모델의 RID입니다.
preprocessingConfiguration의 구조
분기 layoutAware

레이아웃 기반 전처리를 지정하는 래퍼입니다.

이름자료형필수 여부의미와 조건예시 값
typeenum필수허용값: layoutAware.layoutAware
layoutAwareobject필수레이아웃을 고려한 추출 전처리 구성입니다.
layoutAware의 구조
이름자료형필수 여부의미와 조건예시 값
transformationConfigobject필수V2 문서 레이아웃 텍스트 추출 구성입니다.
cropConfigobject선택표 영역 자르기 구성입니다.
transformationConfig의 구조
이름자료형필수 여부의미와 조건예시 값
formatenum선택추출한 텍스트의 내용 형식입니다. 허용값: TEXT, MARKDOWN, HTML.
modeenum선택문서 추출의 OCR 모드입니다. 허용값: AUTO, ELECTRONIC, SCAN.
languageslist<OcrLanguageOrScript>선택OCR에 사용할 언어 또는 문자 체계 목록입니다.
languages의 구조

배열 항목은 OcrLanguageOrScript이며 자료형은 union<language, script>입니다.

OCR 언어 또는 문자 체계 중 하나를 지정합니다.

분기 language

OCR 언어를 지정하는 래퍼입니다.

이름자료형필수 여부의미와 조건예시 값
typeenum필수허용값: language.language
languageenum필수OCR 언어 코드입니다. 허용값은 OCR 언어를 따릅니다.
분기 script

OCR 문자 체계를 지정하는 래퍼입니다.

이름자료형필수 여부의미와 조건예시 값
typeenum필수허용값: script.script
scriptenum필수OCR 문자 체계 코드입니다. 허용값은 OCR 문자 체계를 따릅니다.
cropConfig의 구조
이름자료형필수 여부의미와 조건예시 값
tablePromptstring필수표 추출용 프롬프트입니다.
분기 extractText

텍스트 추출 전처리를 지정하는 래퍼입니다.

이름자료형필수 여부의미와 조건예시 값
typeenum필수허용값: extractText.extractText
extractTextobject필수V2 문서 텍스트 추출 구성입니다.
extractText의 구조
이름자료형필수 여부의미와 조건예시 값
formatenum선택추출한 텍스트의 내용 형식입니다. 허용값: TEXT, MARKDOWN, HTML.
modeenum선택문서 추출의 OCR 모드입니다. 허용값: AUTO, ELECTRONIC, SCAN.
languageslist<OcrLanguageOrScript>선택OCR에 사용할 언어 또는 문자 체계 목록입니다.
languages의 구조

배열 항목은 OcrLanguageOrScript이며 자료형은 union<language, script>입니다.

OCR 언어 또는 문자 체계 중 하나를 지정합니다.

분기 language

OCR 언어를 지정하는 래퍼입니다.

이름자료형필수 여부의미와 조건예시 값
typeenum필수허용값: language.language
languageenum필수OCR 언어 코드입니다. 허용값은 OCR 언어를 따릅니다.
분기 script

OCR 문자 체계를 지정하는 래퍼입니다.

이름자료형필수 여부의미와 조건예시 값
typeenum필수허용값: script.script
scriptenum필수OCR 문자 체계 코드입니다. 허용값은 OCR 문자 체계를 따릅니다.
imageSpec의 구조
이름자료형필수 여부의미와 조건예시 값
resizingModeenum필수이미지 크기 조절 방식입니다. 허용값: RESIZING, FIT_INTO_BOUNDING_BOX.
heightinteger선택목표 높이이며 단위는 픽셀입니다.
widthinteger선택목표 너비이며 단위는 픽셀입니다.
mimeTypeenum필수이미지 항목의 형식입니다. 허용값: BMP, TIFF, NITF, JP2K, JPG, PNG, WEBP.
pageRange의 구조
이름자료형필수 여부의미와 조건예시 값
startPageInclusiveinteger선택0부터 시작하는 시작 페이지이며 범위에 포함합니다. 생략하면 문서 처음부터 처리합니다.
endPageExclusiveinteger선택0부터 시작하는 끝 페이지이며 범위에서 제외합니다. 생략하면 문서 끝까지 처리합니다.

분기 extractTextFromPagesToArray

여러 페이지의 텍스트를 문자열 목록으로 추출합니다.

이름자료형필수 여부의미와 조건예시 값
typeenum필수허용값: extractTextFromPagesToArray.extractTextFromPagesToArray
startPageinteger선택0부터 시작하는 시작 페이지입니다. 생략하면 첫 페이지를 사용합니다.
endPageinteger선택0부터 시작하는 끝 페이지이며 범위에 포함합니다. 생략하면 마지막 페이지를 사용합니다.

분기 ocrOnPage

문서의 특정 페이지에 OCR을 수행합니다.

이름자료형필수 여부의미와 조건예시 값
typeenum필수허용값: ocrOnPage.ocrOnPage
pageNumberinteger필수OCR 대상 페이지 번호입니다.
parametersobject필수OCR 작업의 매개변수입니다.
parameters의 구조
이름자료형필수 여부의미와 조건예시 값
outputFormatunion<hocr, text>필수OCR 결과의 출력 형식입니다.
languageslist<OcrLanguageOrScript>선택OCR에 사용할 언어 또는 문자 체계입니다.
outputFormat의 구조
분기 hocr

HTML 기반 hOCR 형식입니다.

이름자료형필수 여부의미와 조건예시 값
typeenum필수허용값: hocr.hocr
분기 text

일반 텍스트 형식입니다.

이름자료형필수 여부의미와 조건예시 값
typeenum필수허용값: text.text
languages의 구조

배열 항목은 OcrLanguageOrScript이며 자료형은 union<language, script>입니다.

OCR 언어 또는 문자 체계 중 하나를 지정합니다.

분기 language

OCR 언어를 지정하는 래퍼입니다.

이름자료형필수 여부의미와 조건예시 값
typeenum필수허용값: language.language
languageenum필수OCR 언어 코드입니다. 허용값은 OCR 언어를 따릅니다.
분기 script

OCR 문자 체계를 지정하는 래퍼입니다.

이름자료형필수 여부의미와 조건예시 값
typeenum필수허용값: script.script
scriptenum필수OCR 문자 체계 코드입니다. 허용값은 OCR 문자 체계를 따릅니다.

분기 extractFormFields

PDF의 폼 필드 데이터를 추출합니다.

이름자료형필수 여부의미와 조건예시 값
typeenum필수허용값: extractFormFields.extractFormFields

분기 extractLayoutAwareTextV2

PDF의 텍스트 블록과 경계 상자를 페이지별로 묶은 구조화된 JSON으로 추출합니다. 기존 documentToText.extractLayoutAwareContent(DocumentExtractLayoutAwareContentOperation)를 대체하며 응답 스키마가 다르므로 이전할 때 결과 파서를 갱신해야 합니다. config.format은 블록 내용의 일반 텍스트, Markdown 또는 HTML 형식을 선택하며 전체 결과는 JSON입니다. PDF만 지원합니다.

이름자료형필수 여부의미와 조건예시 값
typeenum필수허용값: extractLayoutAwareTextV2.extractLayoutAwareTextV2
pageRangeobject선택문서 추출의 페이지 범위입니다.
configobject필수V2 문서 레이아웃 텍스트 추출 구성입니다.
pageRange의 구조
이름자료형필수 여부의미와 조건예시 값
startPageInclusiveinteger선택0부터 시작하는 시작 페이지이며 범위에 포함합니다. 생략하면 문서 처음부터 처리합니다.
endPageExclusiveinteger선택0부터 시작하는 끝 페이지이며 범위에서 제외합니다. 생략하면 문서 끝까지 처리합니다.
config의 구조
이름자료형필수 여부의미와 조건예시 값
formatenum선택추출한 텍스트의 내용 형식입니다. 허용값: TEXT, MARKDOWN, HTML.
modeenum선택문서 추출의 OCR 모드입니다. 허용값: AUTO, ELECTRONIC, SCAN.
languageslist<OcrLanguageOrScript>선택OCR에 사용할 언어 또는 문자 체계 목록입니다.
languages의 구조

배열 항목은 OcrLanguageOrScript이며 자료형은 union<language, script>입니다.

OCR 언어 또는 문자 체계 중 하나를 지정합니다.

분기 language

OCR 언어를 지정하는 래퍼입니다.

이름자료형필수 여부의미와 조건예시 값
typeenum필수허용값: language.language
languageenum필수OCR 언어 코드입니다. 허용값은 OCR 언어를 따릅니다.
분기 script

OCR 문자 체계를 지정하는 래퍼입니다.

이름자료형필수 여부의미와 조건예시 값
typeenum필수허용값: script.script
scriptenum필수OCR 문자 체계 코드입니다. 허용값은 OCR 문자 체계를 따릅니다.

분기 extractTextV2

V2 텍스트 추출로 전체 페이지의 텍스트를 추출하며 페이지별 텍스트를 제공합니다. PDF만 지원합니다.

이름자료형필수 여부의미와 조건예시 값
typeenum필수허용값: extractTextV2.extractTextV2
pageRangeobject선택문서 추출의 페이지 범위입니다.
configobject필수V2 문서 텍스트 추출 구성입니다.
pageRange의 구조
이름자료형필수 여부의미와 조건예시 값
startPageInclusiveinteger선택0부터 시작하는 시작 페이지이며 범위에 포함합니다. 생략하면 문서 처음부터 처리합니다.
endPageExclusiveinteger선택0부터 시작하는 끝 페이지이며 범위에서 제외합니다. 생략하면 문서 끝까지 처리합니다.
config의 구조
이름자료형필수 여부의미와 조건예시 값
formatenum선택추출한 텍스트의 내용 형식입니다. 허용값: TEXT, MARKDOWN, HTML.
modeenum선택문서 추출의 OCR 모드입니다. 허용값: AUTO, ELECTRONIC, SCAN.
languageslist<OcrLanguageOrScript>선택OCR에 사용할 언어 또는 문자 체계 목록입니다.
languages의 구조

배열 항목은 OcrLanguageOrScript이며 자료형은 union<language, script>입니다.

OCR 언어 또는 문자 체계 중 하나를 지정합니다.

분기 language

OCR 언어를 지정하는 래퍼입니다.

이름자료형필수 여부의미와 조건예시 값
typeenum필수허용값: language.language
languageenum필수OCR 언어 코드입니다. 허용값은 OCR 언어를 따릅니다.
분기 script

OCR 문자 체계를 지정하는 래퍼입니다.

이름자료형필수 여부의미와 조건예시 값
typeenum필수허용값: script.script
scriptenum필수OCR 문자 체계 코드입니다. 허용값은 OCR 문자 체계를 따릅니다.

분기 extractUnstructuredTextFromPage

지정한 페이지의 비정형 텍스트를 추출합니다.

이름자료형필수 여부의미와 조건예시 값
typeenum필수허용값: extractUnstructuredTextFromPage.extractUnstructuredTextFromPage
pageNumberinteger필수페이지 번호입니다.

분기 extractLayoutAwareContent

사용을 권장하지 않는 기존 작업입니다. documentToText.extractLayoutAwareTextV2(ExtractDocumentLayoutAwareTextV2Operation)로 이전할 때 달라진 응답 스키마에 맞게 결과 파서를 갱신합니다.

이름자료형필수 여부의미와 조건예시 값
typeenum필수허용값: extractLayoutAwareContent.extractLayoutAwareContent
parametersobject필수레이아웃을 고려한 내용 추출의 매개변수입니다.
parameters의 구조
이름자료형필수 여부의미와 조건예시 값
languageslist<OcrLanguage>선택추출에 사용할 언어입니다.
languages의 구조

배열 항목은 OcrLanguage이며 자료형은 enum입니다.

OCR 언어 코드입니다.

허용값은 OCR 언어를 따릅니다.

분기 ocrOnPages

문서 페이지의 OCR 접근 패턴을 생성합니다.

이름자료형필수 여부의미와 조건예시 값
typeenum필수허용값: ocrOnPages.ocrOnPages
parametersobject필수OCR 작업의 매개변수입니다.
pageNumberinteger필수페이지 번호입니다.
parameters의 구조
이름자료형필수 여부의미와 조건예시 값
outputFormatunion<hocr, text>필수OCR 결과의 출력 형식입니다.
languageslist<OcrLanguageOrScript>선택OCR에 사용할 언어 또는 문자 체계입니다.
outputFormat의 구조
분기 hocr

HTML 기반 hOCR 형식입니다.

이름자료형필수 여부의미와 조건예시 값
typeenum필수허용값: hocr.hocr
분기 text

일반 텍스트 형식입니다.

이름자료형필수 여부의미와 조건예시 값
typeenum필수허용값: text.text
languages의 구조

배열 항목은 OcrLanguageOrScript이며 자료형은 union<language, script>입니다.

OCR 언어 또는 문자 체계 중 하나를 지정합니다.

분기 language

OCR 언어를 지정하는 래퍼입니다.

이름자료형필수 여부의미와 조건예시 값
typeenum필수허용값: language.language
languageenum필수OCR 언어 코드입니다. 허용값은 OCR 언어를 따릅니다.
분기 script

OCR 문자 체계를 지정하는 래퍼입니다.

이름자료형필수 여부의미와 조건예시 값
typeenum필수허용값: script.script
scriptenum필수OCR 문자 체계 코드입니다. 허용값은 OCR 문자 체계를 따릅니다.