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 옵션 12가지

모든 옵션은 불리언이며 기본값은 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`
`enable_public_term_refine`	공공 용어 순화 제안 활성화(확인 블록)	`false`
`enable_contested_fix`	지침에 기댄 고침 활성화(되세요·의미 중첩·복수 '-들' 남용 등)	`false`
`disable_bias_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[문장 단위 점검 추가];
  B -- enable_public_term_refine --> I[공공 용어 순화 제안];
  B -- enable_contested_fix --> J[지침에 기댄 고침];
  B -- disable_bias_check --> K[낮잡는 말 확인 끔];

특정 교정이 원문을 의도와 다르게 바꾼다면 해당 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 옵션의 기본값은 무엇인가요?

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

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

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

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

enable_sentence_check를 true로 하면 문장 단위 점검이 추가됩니다. 기본값은 false라 켜야 동작하며, 주어와 서술어의 호응·번역투 피동처럼 문장 전체를 보는 교정을 켭니다.