---
title: Korean Privacy AI Assistant 백앤드 API
emoji: 🧠
colorFrom: green
colorTo: blue
sdk: gradio
sdk_version: "5.20.0"
app_file: app.py
pinned: false
short_description: 경량 AI 모델 사용
hardware: zero-a10g
license: mit
---

# KPAA Backend

한국 개인정보보호법 RAG 백엔드. **OpenAI 호환 API**를 노출합니다.

이 Space는 **추론 백엔드 전용**입니다. UI는 별도 Space([scvcoder/korean-privacy-ai-assistant](https://huggingface.co/spaces/scvcoder/korean-privacy-ai-assistant))에서 Open WebUI로 제공됩니다.

## 아키텍처

```
사용자 브라우저
    ↓ (UI 접속)
[Open WebUI Space]
    ↓ (OpenAI API 호출)
[이 Space — KPAA Backend]
    ↓ (RAG 검색 + Gemma 4 추론)
법제처 OPEN API + 상담사례 SQLite + ZeroGPU
```

## Endpoints

| Method | Path | 설명 |
|---|---|---|
| POST | `/v1/chat/completions` | OpenAI 호환 chat (`stream=true` 지원) |
| GET | `/v1/models` | 사용 가능 모델 (`kpaa-privacy-ko`) |
| GET | `/healthz` | liveness check |
| GET | `/info` | 상세 정보 + Swagger UI |
| GET | `/gradio` | Gradio 상태 페이지 |

## Open WebUI 연결 (UI Space에서 자동 설정)

```bash
OPENAI_API_BASE_URL=https://scvcoder-kpaa-backend.hf.space/v1
OPENAI_API_KEY=any-value
DEFAULT_MODELS=kpaa-privacy-ko
```

## Secrets / Hardware
- **Secret** `LAW_OC` — 법제처 OPEN API ID (필수)
- **Hardware** ZeroGPU (zero-a10g) — Pro 무료

## 라이선스
MIT (코드) · 답변 데이터는 PIPC/privacy.go.kr 출처표시