이미지와 문서의 텍스트 추출
텍스트 내용만 필요한 경우와 블록 및 경계 상자까지 필요한 경우를 구분합니다. extractLayoutAwareTextV2의 결과는 구조화된 JSON입니다. format 또는 config.format의 TEXT, MARKDOWN, HTML은 블록 내용의 표현을 선택하며 응답 전체를 해당 텍스트 형식으로 바꾸지 않습니다.
이미지의 extractTextV2는 합쳐진 텍스트와 페이지별 텍스트를 JSON으로 반환합니다. 문서의 V2 레이아웃 추출과 V2 텍스트 추출은 PDF만 지원합니다. 기존 extractLayoutAwareContent도 아래에 현재 매개변수를 유지하지만 새 구성을 만들 때는 V2를 사용합니다. 이전하려면 달라진 블록 또는 응답 스키마에 맞게 결과 파서를 변경해야 합니다.
페이지와 출력 조건
| 작업 | 페이지 또는 출력 조건 |
|---|---|
extractAllText | PDF의 전체 텍스트, DOCX의 일반 문단만 추출 |
getPdfPageDimensions | 페이지 치수를 포인트 단위의 JSON으로 반환 |
extractTextFromPagesToArray | 0부터 시작하는 startPage와 endPage를 모두 포함하며 생략값은 첫 페이지와 마지막 페이지 |
V2 추출과 VLM의 pageRange | 0부터 시작하는 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
이미지에서 텍스트를 추출합니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 허용값: imageToText. | imageToText |
operation | union<extractLayoutAwareTextV2, extractTextV2, extractLayoutAwareContent, ocr> | 필수 | 이미지에서 텍스트를 추출할 작업입니다. |
operation의 구조
분기 extractLayoutAwareTextV2
이미지의 텍스트 블록과 경계 상자를 구조화된 JSON으로 추출합니다. 기존 imageToText.extractLayoutAwareContent(ImageExtractLayoutAwareContentOperation)를 대체하며 블록 스키마가 다르므로 이전할 때 결과 파서를 갱신해야 합니다. format은 각 블록 내용의 일반 텍스트, Markdown 또는 HTML 형식을 선택하며 전체 결과는 JSON입니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 허용값: extractLayoutAwareTextV2. | extractLayoutAwareTextV2 |
format | enum | 선택 | 추출한 텍스트의 내용 형식입니다. 허용값: TEXT, MARKDOWN, HTML. | |
languages | list<OcrLanguageOrScript> | 선택 | OCR에 사용할 언어 또는 문자 체계 목록입니다. |
languages의 구조
배열 항목은 OcrLanguageOrScript이며 자료형은 union<language, script>입니다.
OCR 언어 또는 문자 체계 중 하나를 지정합니다.
분기 language
OCR 언어를 지정하는 래퍼입니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 허용값: language. | language |
language | enum | 필수 | OCR 언어 코드입니다. 허용값은 OCR 언어를 따릅니다. |
분기 script
OCR 문자 체계를 지정하는 래퍼입니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 허용값: script. | script |
script | enum | 필수 | OCR 문자 체계 코드입니다. 허용값은 OCR 문자 체계를 따릅니다. |
분기 extractTextV2
이미지에서 텍스트를 추출하여 합쳐진 텍스트와 페이지별 텍스트를 JSON으로 반환합니다. format은 일반 텍스트, Markdown 또는 HTML을 선택합니다. 텍스트 블록과 경계 상자가 필요하면 imageToText.extractLayoutAwareTextV2(ExtractImageLayoutAwareTextV2Operation)를 사용합니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 허용값: extractTextV2. | extractTextV2 |
format | enum | 선택 | 추출한 텍스트의 내용 형식입니다. 허용값: TEXT, MARKDOWN, HTML. | |
languages | list<OcrLanguageOrScript> | 선택 | OCR에 사용할 언어 또는 문자 체계 목록입니다. |
languages의 구조
배열 항목은 OcrLanguageOrScript이며 자료형은 union<language, script>입니다.
OCR 언어 또는 문자 체계 중 하나를 지정합니다.
분기 language
OCR 언어를 지정하는 래퍼입니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 허용값: language. | language |
language | enum | 필수 | OCR 언어 코드입니다. 허용값은 OCR 언어를 따릅니다. |
분기 script
OCR 문자 체계를 지정하는 래퍼입니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 허용값: script. | script |
script | enum | 필수 | OCR 문자 체계 코드입니다. 허용값은 OCR 문자 체계를 따릅니다. |
분기 extractLayoutAwareContent
사용을 권장하지 않는 기존 작업입니다. imageToText.extractLayoutAwareTextV2(ExtractImageLayoutAwareTextV2Operation)로 이전할 때 달라진 블록 스키마에 맞게 결과 파서를 갱신합니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 허용값: extractLayoutAwareContent. | extractLayoutAwareContent |
parameters | object | 필수 | 레이아웃을 고려한 내용 추출의 매개변수입니다. |
parameters의 구조
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
languages | list<OcrLanguage> | 선택 | 추출에 사용할 언어입니다. |
languages의 구조
배열 항목은 OcrLanguage이며 자료형은 enum입니다.
OCR 언어 코드입니다.
허용값은 OCR 언어를 따릅니다.
분기 ocr
이미지에 OCR(광학 문자 인식)을 수행합니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 허용값: ocr. | ocr |
parameters | object | 필수 | OCR 작업의 매개변수입니다. |
parameters의 구조
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
outputFormat | union<hocr, text> | 필수 | OCR 결과의 출력 형식입니다. | |
languages | list<OcrLanguageOrScript> | 선택 | OCR에 사용할 언어 또는 문자 체계입니다. |
outputFormat의 구조
분기 hocr
HTML 기반 hOCR 형식입니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 허용값: hocr. | hocr |
분기 text
일반 텍스트 형식입니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 허용값: text. | text |
languages의 구조
배열 항목은 OcrLanguageOrScript이며 자료형은 union<language, script>입니다.
OCR 언어 또는 문자 체계 중 하나를 지정합니다.
분기 language
OCR 언어를 지정하는 래퍼입니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 허용값: language. | language |
language | enum | 필수 | OCR 언어 코드입니다. 허용값은 OCR 언어를 따릅니다. |
분기 script
OCR 문자 체계를 지정하는 래퍼입니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 허용값: script. | script |
script | enum | 필수 | OCR 문자 체계 코드입니다. 허용값은 OCR 문자 체계를 따릅니다. |
변환 documentToText
문서에서 텍스트를 추출합니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 허용값: documentToText. | documentToText |
operation | union | 필수 | 문서에서 텍스트를 추출할 작업입니다. |
operation의 구조
분기 extractTableOfContents
문서의 목차를 추출합니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 허용값: extractTableOfContents. | extractTableOfContents |
분기 getPdfPageDimensions
PDF의 각 페이지 치수를 포인트 단위의 JSON으로 반환합니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 허용값: getPdfPageDimensions. | getPdfPageDimensions |
분기 extractAllText
문서 전체 페이지의 텍스트를 추출합니다. PDF는 전체 텍스트를 포함하며 DOCX는 일반 문단만 포함합니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 허용값: extractAllText. | extractAllText |
분기 extractVlmText
시각 언어 모델(VLM)로 문서의 레이아웃과 구조를 해석하여 텍스트를 추출합니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 허용값: extractVlmText. | extractVlmText |
llmSpec | union<chat> | 필수 | 언어 모델 요청의 명세입니다. | |
preprocessingConfiguration | union<layoutAware, extractText> | 선택 | VLM 추출의 전처리 구성입니다. | |
imageSpec | object | 선택 | 시각 기반 추출의 이미지 처리 설정입니다. 모델에 보내기 전에 문서 페이지를 이미지로 변환하는 방식을 제어합니다. | |
outputFormat | enum | 필수 | 시각 언어 모델이 추출한 텍스트의 출력 형식입니다. 허용값: MARKDOWN. | |
pageRange | object | 선택 | 문서 추출의 페이지 범위입니다. |
llmSpec의 구조
분기 chat
채팅 기반 LLM 명세를 지정하는 래퍼입니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 허용값: chat. | chat |
chat | object | 필수 | 시스템 프롬프트와 사용자 프롬프트를 포함한 채팅 명세입니다. |
chat의 구조
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
modelLocator | union<apiName, registeredModelRid> | 필수 | 언어 모델을 찾을 식별 정보입니다. | |
systemPrompt | string | 필수 | LLM의 시스템 프롬프트입니다. | |
userPrompt | string | 필수 | LLM의 사용자 프롬프트입니다. | |
maxTokens | integer | 선택 | 요청 한 번에서 생성할 최대 토큰 수입니다. |
modelLocator의 구조
분기 apiName
API 이름으로 모델을 지정하는 래퍼입니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 허용값: apiName. | apiName |
apiName | string | 필수 | 언어 모델의 API 이름입니다. |
분기 registeredModelRid
RID로 LMS 등록 모델을 지정합니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 허용값: registeredModelRid. | registeredModelRid |
registeredModelRid | string | 필수 | 등록된 언어 모델의 RID입니다. |
preprocessingConfiguration의 구조
분기 layoutAware
레이아웃 기반 전처리를 지정하는 래퍼입니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 허용값: layoutAware. | layoutAware |
layoutAware | object | 필수 | 레이아웃을 고려한 추출 전처리 구성입니다. |
layoutAware의 구조
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
transformationConfig | object | 필수 | V2 문서 레이아웃 텍스트 추출 구성입니다. | |
cropConfig | object | 선택 | 표 영역 자르기 구성입니다. |
transformationConfig의 구조
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
format | enum | 선택 | 추출한 텍스트의 내용 형식입니다. 허용값: TEXT, MARKDOWN, HTML. | |
mode | enum | 선택 | 문서 추출의 OCR 모드입니다. 허용값: AUTO, ELECTRONIC, SCAN. | |
languages | list<OcrLanguageOrScript> | 선택 | OCR에 사용할 언어 또는 문자 체계 목록입니다. |
languages의 구조
배열 항목은 OcrLanguageOrScript이며 자료형은 union<language, script>입니다.
OCR 언어 또는 문자 체계 중 하나를 지정합니다.
분기 language
OCR 언어를 지정하는 래퍼입니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 허용값: language. | language |
language | enum | 필수 | OCR 언어 코드입니다. 허용값은 OCR 언어를 따릅니다. |
분기 script
OCR 문자 체계를 지정하는 래퍼입니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 허용값: script. | script |
script | enum | 필수 | OCR 문자 체계 코드입니다. 허용값은 OCR 문자 체계를 따릅니다. |
cropConfig의 구조
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
tablePrompt | string | 필수 | 표 추출용 프롬프트입니다. |
분기 extractText
텍스트 추출 전처리를 지정하는 래퍼입니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 허용값: extractText. | extractText |
extractText | object | 필수 | V2 문서 텍스트 추출 구성입니다. |
extractText의 구조
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
format | enum | 선택 | 추출한 텍스트의 내용 형식입니다. 허용값: TEXT, MARKDOWN, HTML. | |
mode | enum | 선택 | 문서 추출의 OCR 모드입니다. 허용값: AUTO, ELECTRONIC, SCAN. | |
languages | list<OcrLanguageOrScript> | 선택 | OCR에 사용할 언어 또는 문자 체계 목록입니다. |
languages의 구조
배열 항목은 OcrLanguageOrScript이며 자료형은 union<language, script>입니다.
OCR 언어 또는 문자 체계 중 하나를 지정합니다.
분기 language
OCR 언어를 지정하는 래퍼입니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 허용값: language. | language |
language | enum | 필수 | OCR 언어 코드입니다. 허용값은 OCR 언어를 따릅니다. |
분기 script
OCR 문자 체계를 지정하는 래퍼입니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 허용값: script. | script |
script | enum | 필수 | OCR 문자 체계 코드입니다. 허용값은 OCR 문자 체계를 따릅니다. |
imageSpec의 구조
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
resizingMode | enum | 필수 | 이미지 크기 조절 방식입니다. 허용값: RESIZING, FIT_INTO_BOUNDING_BOX. | |
height | integer | 선택 | 목표 높이이며 단위는 픽셀입니다. | |
width | integer | 선택 | 목표 너비이며 단위는 픽셀입니다. | |
mimeType | enum | 필수 | 이미지 항목의 형식입니다. 허용값: BMP, TIFF, NITF, JP2K, JPG, PNG, WEBP. |
pageRange의 구조
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
startPageInclusive | integer | 선택 | 0부터 시작하는 시작 페이지이며 범위에 포함합니다. 생략하면 문서 처음부터 처리합니다. | |
endPageExclusive | integer | 선택 | 0부터 시작하는 끝 페이지이며 범위에서 제외합니다. 생략하면 문서 끝까지 처리합니다. |
분기 extractTextFromPagesToArray
여러 페이지의 텍스트를 문자열 목록으로 추출합니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 허용값: extractTextFromPagesToArray. | extractTextFromPagesToArray |
startPage | integer | 선택 | 0부터 시작하는 시작 페이지입니다. 생략하면 첫 페이지를 사용합니다. | |
endPage | integer | 선택 | 0부터 시작하는 끝 페이지이며 범위에 포함합니다. 생략하면 마지막 페이지를 사용합니다. |
분기 ocrOnPage
문서의 특정 페이지에 OCR을 수행합니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 허용값: ocrOnPage. | ocrOnPage |
pageNumber | integer | 필수 | OCR 대상 페이지 번호입니다. | |
parameters | object | 필수 | OCR 작업의 매개변수입니다. |
parameters의 구조
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
outputFormat | union<hocr, text> | 필수 | OCR 결과의 출력 형식입니다. | |
languages | list<OcrLanguageOrScript> | 선택 | OCR에 사용할 언어 또는 문자 체계입니다. |
outputFormat의 구조
분기 hocr
HTML 기반 hOCR 형식입니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 허용값: hocr. | hocr |
분기 text
일반 텍스트 형식입니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 허용값: text. | text |
languages의 구조
배열 항목은 OcrLanguageOrScript이며 자료형은 union<language, script>입니다.
OCR 언어 또는 문자 체계 중 하나를 지정합니다.
분기 language
OCR 언어를 지정하는 래퍼입니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 허용값: language. | language |
language | enum | 필수 | OCR 언어 코드입니다. 허용값은 OCR 언어를 따릅니다. |
분기 script
OCR 문자 체계를 지정하는 래퍼입니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 허용값: script. | script |
script | enum | 필수 | OCR 문자 체계 코드입니다. 허용값은 OCR 문자 체계를 따릅니다. |
분기 extractFormFields
PDF의 폼 필드 데이터를 추출합니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 허용값: extractFormFields. | extractFormFields |
분기 extractLayoutAwareTextV2
PDF의 텍스트 블록과 경계 상자를 페이지별로 묶은 구조화된 JSON으로 추출합니다. 기존 documentToText.extractLayoutAwareContent(DocumentExtractLayoutAwareContentOperation)를 대체하며 응답 스키마가 다르므로 이전할 때 결과 파서를 갱신해야 합니다. config.format은 블록 내용의 일반 텍스트, Markdown 또는 HTML 형식을 선택하며 전체 결과는 JSON입니다. PDF만 지원합니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 허용값: extractLayoutAwareTextV2. | extractLayoutAwareTextV2 |
pageRange | object | 선택 | 문서 추출의 페이지 범위입니다. | |
config | object | 필수 | V2 문서 레이아웃 텍스트 추출 구성입니다. |
pageRange의 구조
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
startPageInclusive | integer | 선택 | 0부터 시작하는 시작 페이지이며 범위에 포함합니다. 생략하면 문서 처음부터 처리합니다. | |
endPageExclusive | integer | 선택 | 0부터 시작하는 끝 페이지이며 범위에서 제외합니다. 생략하면 문서 끝까지 처리합니다. |
config의 구조
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
format | enum | 선택 | 추출한 텍스트의 내용 형식입니다. 허용값: TEXT, MARKDOWN, HTML. | |
mode | enum | 선택 | 문서 추출의 OCR 모드입니다. 허용값: AUTO, ELECTRONIC, SCAN. | |
languages | list<OcrLanguageOrScript> | 선택 | OCR에 사용할 언어 또는 문자 체계 목록입니다. |
languages의 구조
배열 항목은 OcrLanguageOrScript이며 자료형은 union<language, script>입니다.
OCR 언어 또는 문자 체계 중 하나를 지정합니다.
분기 language
OCR 언어를 지정하는 래퍼입니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 허용값: language. | language |
language | enum | 필수 | OCR 언어 코드입니다. 허용값은 OCR 언어를 따릅니다. |
분기 script
OCR 문자 체계를 지정하는 래퍼입니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 허용값: script. | script |
script | enum | 필수 | OCR 문자 체계 코드입니다. 허용값은 OCR 문자 체계를 따릅니다. |
분기 extractTextV2
V2 텍스트 추출로 전체 페이지의 텍스트를 추출하며 페이지별 텍스트를 제공합니다. PDF만 지원합니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 허용값: extractTextV2. | extractTextV2 |
pageRange | object | 선택 | 문서 추출의 페이지 범위입니다. | |
config | object | 필수 | V2 문서 텍스트 추출 구성입니다. |
pageRange의 구조
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
startPageInclusive | integer | 선택 | 0부터 시작하는 시작 페이지이며 범위에 포함합니다. 생략하면 문서 처음부터 처리합니다. | |
endPageExclusive | integer | 선택 | 0부터 시작하는 끝 페이지이며 범위에서 제외합니다. 생략하면 문서 끝까지 처리합니다. |
config의 구조
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
format | enum | 선택 | 추출한 텍스트의 내용 형식입니다. 허용값: TEXT, MARKDOWN, HTML. | |
mode | enum | 선택 | 문서 추출의 OCR 모드입니다. 허용값: AUTO, ELECTRONIC, SCAN. | |
languages | list<OcrLanguageOrScript> | 선택 | OCR에 사용할 언어 또는 문자 체계 목록입니다. |
languages의 구조
배열 항목은 OcrLanguageOrScript이며 자료형은 union<language, script>입니다.
OCR 언어 또는 문자 체계 중 하나를 지정합니다.
분기 language
OCR 언어를 지정하는 래퍼입니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 허용값: language. | language |
language | enum | 필수 | OCR 언어 코드입니다. 허용값은 OCR 언어를 따릅니다. |
분기 script
OCR 문자 체계를 지정하는 래퍼입니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 허용값: script. | script |
script | enum | 필수 | OCR 문자 체계 코드입니다. 허용값은 OCR 문자 체계를 따릅니다. |
분기 extractUnstructuredTextFromPage
지정한 페이지의 비정형 텍스트를 추출합니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 허용값: extractUnstructuredTextFromPage. | extractUnstructuredTextFromPage |
pageNumber | integer | 필수 | 페이지 번호입니다. |
분기 extractLayoutAwareContent
사용을 권장하지 않는 기존 작업입니다. documentToText.extractLayoutAwareTextV2(ExtractDocumentLayoutAwareTextV2Operation)로 이전할 때 달라진 응답 스키마에 맞게 결과 파서를 갱신합니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 허용값: extractLayoutAwareContent. | extractLayoutAwareContent |
parameters | object | 필수 | 레이아웃을 고려한 내용 추출의 매개변수입니다. |
parameters의 구조
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
languages | list<OcrLanguage> | 선택 | 추출에 사용할 언어입니다. |
languages의 구조
배열 항목은 OcrLanguage이며 자료형은 enum입니다.
OCR 언어 코드입니다.
허용값은 OCR 언어를 따릅니다.
분기 ocrOnPages
문서 페이지의 OCR 접근 패턴을 생성합니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 허용값: ocrOnPages. | ocrOnPages |
parameters | object | 필수 | OCR 작업의 매개변수입니다. | |
pageNumber | integer | 필수 | 페이지 번호입니다. |
parameters의 구조
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
outputFormat | union<hocr, text> | 필수 | OCR 결과의 출력 형식입니다. | |
languages | list<OcrLanguageOrScript> | 선택 | OCR에 사용할 언어 또는 문자 체계입니다. |
outputFormat의 구조
분기 hocr
HTML 기반 hOCR 형식입니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 허용값: hocr. | hocr |
분기 text
일반 텍스트 형식입니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 허용값: text. | text |
languages의 구조
배열 항목은 OcrLanguageOrScript이며 자료형은 union<language, script>입니다.
OCR 언어 또는 문자 체계 중 하나를 지정합니다.
분기 language
OCR 언어를 지정하는 래퍼입니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 허용값: language. | language |
language | enum | 필수 | OCR 언어 코드입니다. 허용값은 OCR 언어를 따릅니다. |
분기 script
OCR 문자 체계를 지정하는 래퍼입니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 허용값: script. | script |
script | enum | 필수 | OCR 문자 체계 코드입니다. 허용값은 OCR 문자 체계를 따릅니다. |