응답 필드

POST /detect가 돌려주는 판정 결과의 주요 필드예요.

필드타입설명
is_profanebool욕설 여부 (최종 판단)
labelstring욕설 또는 정상
decisionstringblock(차단) · review(검토) · allow(허용)
decision_labelstringdecision의 한글 표기
scorefloat최종 점수 0~1 (임계값과 비교)
severityint강도 0(없음) ~ 3(강함)
severity_labelstring없음 · 약함 · 중간 · 강함
matchedstring[]사전에 매칭된 표현 목록
reasonstring판정 근거 요약
tierstring이번 요청의 티어 (free / paid)
loadfloat해당 티어의 최근 부하율 (%)

decision과 is_profane의 차이

두 값은 서로 다른 관점이에요.

  • is_profane — 점수가 임계값 이상인지(욕설이냐 아니냐)를 나누는 2단계 판단
  • decision — 점수를 세 구간으로 나눈 게이트: block / review / allow

review는 "애매해서 사람이 한 번 더 볼 만한" 경계 구간이에요. 서비스에서는 자동 차단 대신 검토 대기열로 보내는 식으로 활용하시면 좋습니다.

실제 경계 임계값은 GET /health 응답의 decision_bounds에서 실시간으로 확인하실 수 있어요.