일반적인 텍스트 처리 매개변수

텍스트 처리 API의 언어 제한 사항

텍스트 분류

분류 API는 영어 문서에만 사용할 수 있습니다.

텍스트 추출

언어가 공통 스크립트를 공유하지 않는 경우 혼합 언어 문서에는 추출 API를 사용할 수 없습니다. 그러나 영어와 다른 언어가 혼합된 문서를 어떤 스크립트로든 사용할 수 있습니다. 예를 들어 영어와 프랑스어 텍스트가 혼합된 문서의 이미지에서 텍스트를 추출할 수 있는데, 두 언어가 모두 라틴어 기반이기 때문입니다. 그러나 일본어와 프랑스어 텍스트가 혼합된 문서의 이미지에서는 텍스트를 추출할 수 없습니다.

텍스트 추출 API는 영어 문서에서만 키-값 쌍 데이터를 추출하는 데 사용할 수 있습니다.

지원되는 필기 언어

다음 표는 필기체 텍스트 인식에서 지원되는 언어를 나열한 것입니다:

문서에 영어로 된 손글씨가 포함된 경우, s390x 에서 지원하는 언어 코드를 en_hw API 요청 본문에 사용하십시오.

지원되는 기계 인쇄 언어

다음 표는 인쇄 텍스트 인식을 위해 텍스트 추출 API가 지원하는 언어에 대한 세부 정보를 제공합니다:

기계 인쇄된 텍스트와 손글씨가 모두 포함된 문서

문서에 기계 인쇄 텍스트와 필기 텍스트가 혼합되어 있는 경우, 기계 인쇄 언어 모델과 필기 언어 모델 모두에 해당하는 언어 코드를 지정하여 API를 호출해야 합니다.

여러 언어로 된 문서

영어를 다른 언어와 함께 사용하는 경우를 제외하고는, 동일한 문자를 사용하지 않는 언어 간의 결합은 지원되지 않습니다.

languages_list문서에 라틴 문자나 CJK 문자를 사용하는 여러 언어로 된 텍스트가 포함된 경우,. eng예를 들어, 와 를 모두 fra 지정하면, 서비스는 내부적으로 해당 요청을 모델에 latn 매핑합니다.

지원되는 언어 표에 나열된 스크립트 기반 언어만 지원됩니다. 단일 요청에서 스크립트를 두 개 이상 지정할 수 없습니다.

허용되는 조합:

• ['fra', 'spa'] – 같은 문자를 사용하는 두 언어
• ['jpn', 'eng'] – 라틴어계가 아닌 언어와 영어가 결합된 형태 ['jpn'](문서에 일본어와 영어가 모두 포함되어 있다면, 이를 명시하는 것으로 충분합니다.)
• ['fra', 'spa', 'eng']
• ['jpn', 'kor'] – 같은 문자를 사용하는 두 언어
• ['heb', 'eng'] – 라틴어계가 아닌 언어와 영어가 결합된 형태
• ['latn'] – 단일 스크립트
• ['cjk'] – 단일 스크립트

지원되지 않는 조합:

• ['heb', 'fra'] – 라틴어계가 아닌 언어와 영어 이외의 라틴어계 언어의 조합
• ['cjk', 'fra']
• ['jpn', 'fra', 'eng'] – 비라틴어와 두 가지 라틴어 계열 언어의 조합
• ['latn', 'cjk'] – 두 가지 다른 스크립트

schemas 필드로 스키마 정의하기

레이아웃에 따라 문서는 크게 다음과 같은 유형으로 분류할 수 있습니다:

가변 레이아웃 문서

송장, 구매 주문서, 여권 등 구조가 여러 페이지에 걸쳐 있는 일관된 구조가 없는 문서.

고정 레이아웃 문서

각 페이지가 특정 레이아웃을 가진 세금 양식과 같이 각 페이지가 미리 정의된 형식을 따르는 구조화된 문서입니다.

"semantic_config": {
  "schemas": [ {
      "document_type": "Receipt",
      "document_description": "A receipt issued for a purchase at ABC store.",
      "fields": {
        "receipt_number": {
          "default": "",
          "example": "R-20241027-ABC",
          "description": "Unique identifier on the receipt."
        },
        "customer_name": {
          "default": "",
          "example": "John Smith",
          "description": "Full name of the customer or payee."
        },
        "date_of_transaction": {
          "default": "",
          "example": "2023-01-01",
          "description": "Date when the purchase or payment occurred."
        },
        "total_paid": {
          "default": "",
          "example": "8.64",
          "description": "Final amount paid by the customer."
        },
        "payment_method": {
          "default": "",
          "example": "Credit Card",
          "description": "How payment was made, such as cash, card, check, etc.)."
        },
      }
  } ]
}

사전 정의 및 사용자 정의 스키마가 schemas_merge_strategy 필드와 상호 작용하는 방식 제어하기

생성한 사용자 정의 스키마가 텍스트 처리 API에서 지원하는 사전 정의된 스키마와 상호 작용하는 방식을 정의할 수 있습니다.

다음 표에서는 semantic_config 매개변수에서 schemas_merge_strategy 설정을 구성할 때 사전 정의 및 사용자 정의 스키마가 처리되는 다양한 방식에 대해 자세히 설명합니다:

기본적으로 지원되는 사전 정의된 스키마와 일치하는 문서 유형에 대한 사용자 정의 스키마를 만들면 두 스키마가 병합된 후 문서의 키-값 쌍 데이터를 처리하는 데 사용됩니다.