Quickstart

You can try KPD without an API key (free tier). A single request is enough to get your first result.

1. Send your first request

Let's judge one sentence with curl from your terminal.

curl -s -X POST https://harm-api.rhu.kr/detect \
  -H 'Content-Type: application/json' \
  -d '{"text":"안녕하세요 반갑습니다","operating_point":"balanced"}'

2. Read the response

{
  "is_profane": false,
  "label": "정상",
  "decision": "allow",
  "decision_label": "허용",
  "score": 0.0332,
  "severity": 0,
  "tier": "free"
}

The most important value here is decision. It comes back as one of allow, review, or block. See Response Fields for what every field means.

3. Next steps

  • Sending a lot of requests, or need to go past the free IP limit? → Authentication
  • Want to tune request options (operating points, etc.)? → Detecting Text

The free tier is limited to 7 requests per minute per IP. We recommend issuing an API key before wiring KPD into a real service.