인증과 API 키
KPD는 요청에 유효한 API 키가 있는지에 따라 두 티어로 나뉘어요.
| 티어 | 조건 | 제한 |
|---|---|---|
| 무료 (free) | 키 없음 (또는 무효·만료·크레딧 부족) | IP당 분당 7회 |
| 유료 (paid) | 유효한 키 + 크레딧 잔액 | 키별 높은 한도, 요청당 크레딧 차감 |
키 발급받기
API 키는 대시보드에서 계정당 하나 발급하실 수 있어요. 발급하는 순간 kpd_live_… 형태의 키가 딱 한 번만 표시되니, 안전한 곳에 꼭 복사해 두세요(서버에는 해시만 저장되어 다시 볼 수 없습니다).
키 전달하기
발급받은 키는 요청 헤더에 담아 보냅니다. 아래 두 방식 중 편한 쪽을 쓰시면 돼요.
X-API-Key: kpd_live_xxxxxxxxxxxx
또는
Authorization: Bearer kpd_live_xxxxxxxxxxxx
예시:
curl -s -X POST https://harm-api.rhu.kr/detect \
-H 'Content-Type: application/json' \
-H 'X-API-Key: kpd_live_xxxxxxxxxxxx' \
-d '{"text":"판정할 문장"}'
크레딧과 과금
새로 발급한 키는 잔액이 0이라 무료 티어처럼 동작해요. 대시보드에서 크레딧을 충전하시면 유료 티어로 전환되고, 요청 1회마다 0.0135 크레딧이 차감됩니다.
- 잔액이 1회 비용보다 적어지면 자동으로 무료 티어로 폴백해요(요청이 막히지는 않습니다).
- 만료되거나 폐기된 키도 조용히 무료로 강등되며, 요청 자체는 계속 처리됩니다.
키와 크레딧 관리, 그리고 최근 90일 사용량은 대시보드에서 확인하실 수 있어요.