맞춤법 검사 API

// 맞춤법 검사 요청 메시지
message CorrectErrorRequest {
  // 입력 문서
  Document document = 1;

  // 오프셋을 계산하기 위한 인코딩 타입
  EncodingType encoding_type = 2;


  // 커스텀 사전 도메인 정보, 하나만 지정 가능합니다.
  // v4.0에서는 폐기될 예정입니다. 새로운 custom_dict_names를 사용해주세요.
  // 새로운 custom_dict_names에 값이 들어있는 경우, 이 값은 무시됩니다.
  string custom_domain = 4 [deprecated = true];

  // 커스텀 사전 이름들
  // CustomDictionaryService를 사용해서 만든 사전을 여러 개 지정한다.
  // 하나 이상의 지정할 경우, 먼저 나오는 사전이 우선되어 사용된다.
  repeated string custom_dict_names = 5;

  // 맞춤법 검사기 적용 시 옵션을 지정한다.
  RevisionConfig config = 11;
}

// 맞춤법 검사기 설정
// 맞춤법 검사기 설정은 아무런 설정을 하지 않을 경우에 기본값을 설정하는 것을 기준으로
// 설정한다.
// (참고) 이 옵션은 구현 과정에서 지속적으로 추가될 수 있다.
message RevisionConfig {
  // split sentence 비활성화하면 문장 단위 분할을 하지 않는다.
  bool disable_split_sentence = 1;

  // 복합명사 분리 사전 적용 비활성화
  bool disable_caret_spacing = 2;

  // 보조 용언 띄어쓰기 비활성화
  bool disable_vx_spacing = 3;

  // 주어진 문장을 기사 등의 제목으로 취급, 기본값 false
  bool treat_as_title = 4;

  // 제약된 구두점 사용 기능 활성화
  bool enable_limited_punctuation = 5;

  // 공백을 제거하는 것을 활성화하기
  bool enable_cleanup_whitespace = 11;

  // 문장 단위 점검 활성화
  bool enable_sentence_check = 21;

  // 공공 용어 순화 제안 활성화(확인 블록만, 본문은 바꾸지 않음)
  bool enable_public_term_refine = 22;

  // 논란 여지가 있는 고침 활성화(지침이 권하지만 흔히 쓰이는 표현)
  bool enable_contested_fix = 23;

  // 혐오·차별 표현 확인 블록 비활성화
  bool disable_bias_check = 24;
}

// 맞춤법 검사의 응답
message CorrectErrorResponse {
  // 원래 요청 문서
  string origin = 1;
  // 교정 문장 문서
  string revised = 2;

  // 수정된 결과들 하나 이상
  repeated RevisedBlock revised_blocks = 3;

  // 교정 대상에서 지워야할 공백들의 목록
  repeated CleanUpRange whitespace_cleanup_ranges = 9;

  // 교정된 문장들
  repeated RevisedSentence revised_sentences = 11;

  // 교정 도움말들에 대한 정보
  map<string, ReviseHelp> helps = 12;

  // 텍스트의 언어, 만일 언어가 지정되지 않은 경우에는 자동으로 탐지하여 반환한다.
  // 언어가 지정된 경우에는 동일한 언어를 반환한다.
  // 이때, 언어는 ko_KR 등과 같이 사용한다.
  string language = 99;

  // 어절의 개수
  int32 tokens_count = 100;
}

message RevisedSentence {
  string origin = 1;
  string revised = 2;
}

// RevisedBlock은 교정 대상인 원문과 수정된 결과, 이유, 사용자 사전 추가 정보를 담고 있다.
//
// - origin: 교정의 원문으로, 교정 대상이 되는 원문의 위치와 범위 정보를 담고 있다.
// - revised: 교정 결과를 포함하며, 여러 개의 교정 후보가 있는 경우 가장 대표적인 
//   교정 결과를 포함한다.
// - revisions: 하나 이상의 교정 후보를 포함하며, 각 교정 결과는 점수, 카테고리, 
//   도움말 정보를 포함한다.
// - nested: 여러 개의 블럭이 하나로 합쳐지는 경우, 기존의 블럭들은 nested 블럭에 
//   포함된다.
// - lemma: 교정 대상에 대해 교정을 하지 않을 수도 있으며, 이를 사용자 사전에 
//   추가해야 하는 경우 원형을 밝혀 추가할 수 있도록 한다.
// - pos: 사전에 추가할 경우, 해당 단어의 형태 정보를 포함한다.
//
// [여러 블럭을 합치는 경우]
// 띄어쓰기 및 붙여쓰기가 여러 블럭에 연달아 있는 경우, 그 경계가 계속해서 
// 합쳐질 수 있다. 예를 들어, "`하지만아무도도와드리지않았다.`"의 경우, 
// "하지만 아무도", "아무도 도와", "도와드리지", "드리지 않았다."처럼 블럭이 
// 서로 경계에 닿아 있다. 이 경우 "`하지만아무도도와드리지않았다.`"를 하나의 
// 블럭으로 처리한다. 이를 UI에서 계산하여 처리하는 것은 많은 노력이 필요하므로, 
// 위의 4가지 경우를 `nested` 블럭에 포함하여 기술하도록 한다.
//
// [사용자 사전 후보 제시]
// 원문에 포함된 교정 블럭에 대한 교정 후보를 제시하는 것이 적절하지 않은 경우, 
// 사용자는 이 단어를 새로운 사전에 등록할 수 있다. 이를 위해 등록의 원본을 
// 제시한다. 예를 들어, "신박했다"라는 어절에 대해 교정한 경우, lemma로 "신박하"를 
// 제시하고 "형용사"로 품사를 제시할 수 있다. 여기에는 띄어 쓴 블럭의 복합명사도 
// 포함될 수 있다. 이 경우 "제품^품질관리^체계"처럼 대부분의 UI 처리 단위에서는 
// 이를 세부적으로 나눠서 표현할 필요는 없지만, 포함된 블럭을 구분하여 표현하고자 
// 하는 경우에도 이를 감안할 수 있다.
message RevisedBlock {
  // 교정 원문의 위치 및 원문 정보
  // 대부분은 어절 단위이지만, nested가 있는 경우 여러 블럭이 포함될 수 있다.
  // 원문의 한 어절에 여러 개의 교정이 있는 경우에는 이를 묶을 수도 있다.
  TextSpan origin = 1;
  // 교정된 결과물, 여러가지 중에 하나로서 가장 대표적인 경우
  string revised = 2;
  // 다양한 교정 문장의 예시들
  repeated Revision revisions = 3;

  // 한 어절에 여러 개의 수정이 이뤄지거나,
  // 서로 다른 어절의 수정이 경계를 닿아서 겹치는 경우에는
  // 기존의 교정 블럭은 nested에 포함된다.
  repeated RevisedBlock nested = 10;

  // 사용사 사전에 추가하기 위한 기본 단위, nested가 존재하는 쓸 수 없다.
  string lemma = 4;
  // 사용사 사전에 추가할 품사
  CustomDictPos pos = 5;
}

// 한개의 교정에 대한 정보
message Revision {
  // 수정을 제안한 토큰
  string revised = 1;
  // 수정에 대한 점수, 점수가 높으면 수정의 후보가 높다.
  double score = 2;
  // RevisionCagetory 정보
  RevisionCategory category = 3;
  // 수정에 대한 도움말, 인덱스 정보
  string help_id = 4;
}

// 교정에 대한 도움말 객체
message ReviseHelp {
  // 도움말 ID, 고정된 도움말이 있을 수 있고, 동적으로 생성되는 도움말이 있을 수 있다.
  string id = 1;
  // 문장 교정의 카테고리
  RevisionCategory category = 2;
  // 바뀌어야 하는 이유에 대한 섧명
  string comment = 3;
  // 변경이 될 수 있는 문장들
  repeated string examples = 4;
  // 관련 규정
  string rule_article = 5;
}

// 사용자 사전용 형태소
enum CustomDictPos {
  // 해당 없음
  POS_UNK = 0;
  // 복합명사 사전
  POS_NNG = 1;
  // 고유명사 사전
  POS_NNP = 2;
  // 복합명사 분리 사전
  POS_NNG_CARET = 3;
  // 동사 사전
  POS_VV = 4;
  // 형용사 사전
  POS_VA = 5;
  // 관형사 사전
  POS_MM = 6;
  // 감탄사 사전
  POS_IC = 7;
}

// 한국어 문장 교정의 카테고리
enum RevisionCategory {
  // 교정 카테고리가 없음
  UNKNOWN = 0;
  // 교정 유형: 어법에 관한 사항
  // 활용, 조사 결합, 구둣점 등
  GRAMMER = 1;
  // 교정 유형: 어법 단어 단위 규칙에 관한 사항
  // 사이시옷, 두음법칙, 한자결합(율,률) 등
  WORD = 2;
  // 교정 유형: 띄어쓰기에 관한 사항
  SPACING = 3;
  // 교정 유형: 표준어 일반
  STANDARD = 8;
  // 교정 유형: 오탈자
  TYPO = 9;
  // 교정 유형: 외래어 표기법
  FOREIGN_WORD = 10;
  // 교정 유형: 혼동하기 쉬운 단어
  CONFUSABLE_WORDS = 11;
  // 교정 유형: 문장 단위 오류
  SENTENCE = 12;
  // 교정 유형: 확인 필요
  CONFIRM = 13;
    // 생각 중: 스트리밍 후처리 대기 상태
    THINKING = 14;
}

// CleanUpRange 교정 대상에서 불필요한 공백을 지워야할 범위
message CleanUpRange {
  // 위치
  int32 offset = 1;
  // 길이
  int32 length = 2;
  // 지워야할 위치에 대한 추가 정보
  enum CleanUpPosition {
    // 처음
    START = 0;
    // 끝
    END = 1;
    // 중간
    MIDDLE = 2;
  }
  CleanUpPosition position = 3;
}

message StreamCorrectErrorRequest {
    // CorrectErrorRequest와 동일한 입력
    Document document = 1;
    EncodingType encoding_type = 2;
    string custom_domain = 4 [deprecated = true];
    repeated string custom_dict_names = 5;
    RevisionConfig config = 11;

    // 요청 ID (비워 두면 서버에서 생성)
    int64 req_id = 101;
}

message StreamCorrectErrorResponse {
    oneof res {
        StreamFirstCorrectError first = 1;
        CancelledRevision cancelled = 2;
        PostRevision post = 3;
        ProgressRevision progress = 4;
    }
}

어제도 너무더워서잠이오지를않았다.그런데, 오늘은 더심하네요.

{
    "origin": "어제도 너무더워서잠이오지를않았다.그런데, 오늘은 더심하네요.",
    "revised": "어제도 너무 더워서 잠이 오지를 않았다. 그런데, 오늘은 더 심하네요.",
    "revised_blocks": [
        {
            "revisions": [
                {
                    "revised": "너무 너무 더워서 잠이 오지를 않았다. 그런데,",
                    "score": 0.99,
                    "category": "CONFIRM",
                    "help_id": "Merged"
                }
            ],
            "nested": [
                {
                    "revisions": [
                        {
                            "revised": "너무 더워서잠이오지를않았다.그런데,",
                            "score": 0,
                            "category": "SPACING",
                            "help_id": "띄어쓰기_공통"
                        }
                    ],
                    "nested": [],
                    "origin": {
                        "content": "너무더워서잠이오지를않았다.그런데,",
                        "begin_offset": 6,
                        "length": 0
                    },
                    "revised": "너무 더워서잠이오지를않았다.그런데,",
                    "lemma": "",
                    "pos": "POS_UNK"
                },
                {
                    "revisions": [
                        {
                            "revised": "더워서 잠이오지를않았다.그런데,",
                            "score": 0,
                            "category": "SPACING",
                            "help_id": "띄어쓰기_공통"
                        }
                    ],
                    "nested": [],
                    "origin": {
                        "content": "더워서잠이오지를않았다.그런데,",
                        "begin_offset": 9,
                        "length": 0
                    },
                    "revised": "더워서 잠이오지를않았다.그런데,",
                    "lemma": "",
                    "pos": "POS_UNK"
                },
                {
                    "revisions": [
                        {
                            "revised": "잠이 오지를않았다.그런데,",
                            "score": 0,
                            "category": "SPACING",
                            "help_id": "띄어쓰기_공통"
                        }
                    ],
                    "nested": [],
                    "origin": {
                        "content": "잠이오지를않았다.그런데,",
                        "begin_offset": 11,
                        "length": 0
                    },
                    "revised": "잠이 오지를않았다.그런데,",
                    "lemma": "",
                    "pos": "POS_UNK"
                },
                {
                    "revisions": [
                        {
                            "revised": "지를 않았다.그런데,",
                            "score": 0,
                            "category": "SPACING",
                            "help_id": "띄어쓰기_공통"
                        }
                    ],
                    "nested": [],
                    "origin": {
                        "content": "지를않았다.그런데,",
                        "begin_offset": 14,
                        "length": 0
                    },
                    "revised": "지를 않았다.그런데,",
                    "lemma": "",
                    "pos": "POS_UNK"
                },
                {
                    "revisions": [
                        {
                            "revised": "다. 그런데,",
                            "score": 0,
                            "category": "SPACING",
                            "help_id": "띄어쓰기_공통"
                        }
                    ],
                    "nested": [],
                    "origin": {
                        "content": "다.그런데,",
                        "begin_offset": 18,
                        "length": 0
                    },
                    "revised": "다. 그런데,",
                    "lemma": "",
                    "pos": "POS_UNK"
                }
            ],
            "origin": {
                "content": "너무더워서잠이오지를않았다.그런데,",
                "begin_offset": 4,
                "length": 18
            },
            "revised": "너무 너무 더워서 잠이 오지를 않았다. 그런데,",
            "lemma": "",
            "pos": "POS_UNK"
        },
        {
            "revisions": [
                {
                    "revised": "더 심하네요.",
                    "score": 0,
                    "category": "SPACING",
                    "help_id": "띄어쓰기_공통"
                }
            ],
            "nested": [],
            "origin": {
                "content": "더심하네요.",
                "begin_offset": 28,
                "length": 0
            },
            "revised": "더 심하네요.",
            "lemma": "",
            "pos": "POS_UNK"
        }
    ],
    "revised_sentences": [
        {
            "origin": "어제도 너무더워서잠이오지를않았다.",
            "revised": "어제도 너무 더워서 잠이 오지를 않았다."
        },
        {
            "origin": "그런데, 오늘은 더심하네요.",
            "revised": "그런데, 오늘은 더 심하네요."
        }
    ],
    "helps": {
        "Merged": {
            "examples": [],
            "id": "Merged",
            "category": "CONFIRM",
            "comment": "여러 개의 수정이 하나로 합쳐져서 표현됩니다. 개별 수정은 확인이 필요합니다.",
            "rule_article": ""
        },
        "띄어쓰기_공통": {
            "examples": [
                "오늘 날씨 좋다."
            ],
            "id": "띄어쓰기_공통",
            "category": "SPACING",
            "comment": "문장의 각 단어는 띄어 씀을 원칙으로 한다.",
            "rule_article": "한글맞춤법, 제1장 총칙, 제2항"
        }
    },
    "language": "ko_KR"
}

from bareunpy import Corrector

# Corrector 초기화
API_KEY = "YOUR-API-KEY"  # 본인의 API 키를 입력하세요
HOST = "localhost"             # 로컬 서버를 사용하는 경우
PORT = 5656                    # 포트 번호
corrector = Corrector(apikey=API_KEY, host=HOST, port=PORT)

# 단일 문장 교정 테스트
print("=== 단일 문장 교정 ===")
single_sentence = "줄기가 얇아서 시들을 것 같은 꽃에물을 주었더니 고은 꽃이 피었다."
response = corrector.correct_error(content=single_sentence, auto_split=True)
print("원문:", response.origin)
print("교정문:", response.revised)

# 여러 문장 교정 테스트
print("\n=== 여러 문장 교정 ===")
multiple_sentences = [
    "줄기가 얇아서 시들을 것 같은 꽃에물을 주었더니 고은 꽃이 피었다.",
    "오늘은 철이네서 알타리무 다듬던데."
]

responses = corrector.correct_error_list(contents=multiple_sentences, auto_split=True)
for i, res in enumerate(responses):
    print(f"\n문장 {i + 1}:")
    print("원문:", res.origin)
    print("교정문:", res.revised)

=== 단일 문장 교정 ===
원문: 줄기가 얇아서 시들을 것 같은 꽃에물을 주었더니 고은 꽃이 피었다.
교정문: 줄기가 얇아서 시들 것 같은 꽃에 물을 주었더니 고운 꽃이 피었다.

=== 여러 문장 교정 ===

문장 1:
원문: 줄기가 얇아서 시들을 것 같은 꽃에물을 주었더니 고은 꽃이 피었다.
교정문: 줄기가 얇아서 시들 것 같은 꽃에 물을 주었더니 고운 꽃이 피었다.

문장 2:
원문: 오늘은 철이네서 알타리무 다듬던데.
교정문: 오늘은 철이네서 총각무 다듬던데.