CorrectError API 옵션

CorrectError API 옵션(disable_/enable_) 완전 정리

바른의 맞춤법 검사 API(RevisionService의 CorrectError)는 RevisionConfig를 통해 교정 동작을 세밀하게 켜고 끌 수 있습니다. 이 글은 RevisionConfig의 모든 옵션과 의미, 기본값을 한 표로 정리합니다.

요청 구조

CorrectErrorRequest는 다음 필드를 가집니다.

필드	설명
document	교정할 텍스트(content, language)
encoding_type	위치 오프셋 인코딩(NONE/UTF8/UTF16/UTF32)
custom_dict_names	적용할 사용자 사전 이름들(먼저 지정한 사전이 우선)
config	교정 동작 옵션(RevisionConfig)

RevisionConfig 옵션 9가지

모든 옵션은 불리언이며 기본값은 false 입니다. 즉 기본 상태에서는 모든 교정 기능이 켜져 있고, disable_*은 끄는 스위치, enable_*은 추가 기능을 켜는 스위치입니다.

옵션	의미	기본값
disable_split_sentence	문장 분할 비활성화	false
disable_caret_spacing	복합명사 분리 사전 적용 비활성화	false
disable_vx_spacing	보조용언 띄어쓰기 비활성화	false
treat_as_title	문장을 제목으로 취급	false
enable_limited_punctuation	제약된 구두점 사용	false
disable_confusion	혼동(혼동어) 모델 비활성화	false
enable_cleanup_whitespace	공백 제거 활성화	false
disable_typo_correction	오타 교정 비활성화	false
enable_sentence_check	문장 단위 점검 활성화	false

disable_과 enable_의 차이

disable_* 옵션은 기본으로 켜진 교정을 끄는 스위치입니다(켜면 그 교정을 안 함). enable_* 옵션은 기본으로 꺼진 부가 기능을 켜는 스위치입니다(켜야 동작함). 둘 다 기본값이 false이므로, config를 비우면 표준 교정(문장 분할·띄어쓰기·오타·혼동어 등)이 모두 동작합니다.

옵션을 끄면 무엇이 달라지나

graph TD
  A[CorrectError 요청] --> B{config 옵션};
  B -- disable_typo_correction --> C[빈도 기반 오타 교정 끔];
  B -- disable_confusion --> D[혼동어 교정 끔];
  B -- disable_caret_spacing --> E[복합명사 분리 끔];
  B -- disable_vx_spacing --> F[보조용언 띄어쓰기 끔];
  B -- enable_cleanup_whitespace --> G[불필요 공백 제거];
  B -- enable_sentence_check --> H[문장 단위 점검 추가];

• 특정 교정이 원문을 의도와 다르게 바꾼다면 해당 disable_*로 끄세요.
• 부가 점검이 필요하면 enable_sentence_check(문장 단위)·enable_cleanup_whitespace(공백 정리)를 켜세요.

사용 예시

{
  "document": { "content": "벼르고 벼러 왔던 그다음 날", "language": "ko_KR" },
  "encoding_type": "UTF8",
  "config": {
    "disable_typo_correction": false,
    "disable_confusion": false,
    "enable_cleanup_whitespace": true
  }
}

기본값은 모두 false

모든 옵션의 기본값이 false이므로, config를 지정하지 않으면 표준 교정이 그대로 동작합니다. 원하는 동작만 골라 켜고 끄려면 필요한 옵션만 명시하세요.

자주 묻는 질문

Q. RevisionConfig 옵션의 기본값은 무엇인가요?

9개 옵션 모두 불리언이며 기본값은 false입니다. 따라서 config를 비우면 문장 분할·띄어쓰기·오타·혼동어 교정 등 표준 교정 기능이 모두 동작합니다.

Q. 오타 교정이나 혼동어 교정만 끄려면 어떻게 하나요?

disable_typo_correction을 true로 하면 빈도 기반 오타 교정이, disable_confusion을 true로 하면 혼동어 교정이 꺼집니다.

Q. 문장 단위 점검은 어떻게 켜나요?

enable_sentence_check를 true로 하면 문장 단위 점검이 추가됩니다. 기본값은 false라 켜야 동작하며, 문장 전체 관점에서 보는 교정(SENTENCE 카테고리)을 활성화합니다.

도움이 되었나요?

의견 보내기