텍스트 판정
문장을 판정하는 기본 엔드포인트는 POST /detect예요.
요청
엔드포인트: POST https://harm-api.rhu.kr/detect
| 필드 | 타입 | 필수 | 설명 |
|---|---|---|---|
text | string | ✔ | 판정할 문장 (최대 4000자) |
operating_point | string | 민감도 프리셋 (기본 balanced) |
curl -s -X POST https://harm-api.rhu.kr/detect \
-H 'Content-Type: application/json' \
-d '{"text":"니 수준을 아세요","operating_point":"balanced"}'
{
"text": "니 수준을 아세요",
"is_profane": true,
"label": "욕설",
"decision": "review",
"decision_label": "검토",
"score": 0.8975,
"severity": 2,
"tier": "free"
}
운용점 (operating_point)
같은 모델이지만 임계값만 다른 세 가지 프리셋으로 민감도를 조절하실 수 있어요.
| 운용점 | 성향 | 언제 쓰나요 |
|---|---|---|
balanced | 정밀도·재현율 균형 (기본) | 대부분의 경우 |
high_precision | 확실할 때만 욕설로 판정 | 오탐을 최소화하고 싶을 때 |
high_recall | 의심되면 욕설로 판정 | 놓치는 걸 최소화하고 싶을 때 |
여러 문장 한 번에
POST /detect/batch에 texts 배열(최대 256건)을 보내시면 한 번에 판정해요. 요청·과금상 1회로 계산됩니다.
curl -s -X POST https://harm-api.rhu.kr/detect/batch \
-H 'Content-Type: application/json' \
-d '{"texts":["안녕","씨발"]}'
응답 안 각 항목의 스키마는 응답 필드와 동일합니다.