응답 필드
POST /detect가 돌려주는 판정 결과의 주요 필드예요.
| 필드 | 타입 | 설명 |
|---|---|---|
is_profane | bool | 욕설 여부 (최종 판단) |
label | string | 욕설 또는 정상 |
decision | string | block(차단) · review(검토) · allow(허용) |
decision_label | string | decision의 한글 표기 |
score | float | 최종 점수 0~1 (임계값과 비교) |
severity | int | 강도 0(없음) ~ 3(강함) |
severity_label | string | 없음 · 약함 · 중간 · 강함 |
matched | string[] | 사전에 매칭된 표현 목록 |
reason | string | 판정 근거 요약 |
tier | string | 이번 요청의 티어 (free / paid) |
load | float | 해당 티어의 최근 부하율 (%) |
decision과 is_profane의 차이
두 값은 서로 다른 관점이에요.
is_profane— 점수가 임계값 이상인지(욕설이냐 아니냐)를 나누는 2단계 판단decision— 점수를 세 구간으로 나눈 게이트:block/review/allow
review는 "애매해서 사람이 한 번 더 볼 만한" 경계 구간이에요. 서비스에서는 자동 차단 대신 검토 대기열로 보내는 식으로 활용하시면 좋습니다.
실제 경계 임계값은
GET /health응답의decision_bounds에서 실시간으로 확인하실 수 있어요.