OPENAI_API_KEY_GUIDE.md

# OpenAI API 키 설정 가이드

## 🔑 권한 설정

### ✅ 권장: **All (전체 권한)**

이 서비스는 **쓰기 작업**이 필수이므로 **All 권한**이 필요합니다.

---

## 📊 사용 중인 API 기능

### 1. Chat Completions (필수)
```
용도: 텍스트 생성
예시: 
- detect_echo_ai()
- shape_echolalia()
- generate_context_analysis()

필요 권한: Write
```

### 2. Audio Transcriptions (Whisper) (필수)
```
용도: 음성 인식
예시: client.audio.transcriptions.create()

필요 권한: Write
```

### 3. Audio Speech (TTS) (필수)
```
용도: 음성 합성
예시: client.audio.speech.create()

필요 권한: Write
```

---

## ❌ 권한별 작동 가능 여부

### Read Only
```
Chat Completions: ❌ 작동 불가
Whisper: ❌ 작동 불가
TTS: ❌ 작동 불가

결과: 모든 기능 작동 불가!
```

### Restricted
```
Chat Completions: ⚠️ 제한적
Whisper: ⚠️ 제한적
TTS: ⚠️ 제한적

결과: 불안정한 동작, 오류 빈번
```

### All ✅
```
Chat Completions: ✅ 완벽 작동
Whisper: ✅ 완벽 작동
TTS: ✅ 완벽 작동

결과: 모든 기능 정상 작동!
```

---

## ✅ 최종 권장사항

**"All" 권한 설정 필수**

이유:
- Chat Completions는 텍스트 생성 (쓰기)
- Whisper는 음성 전사 (쓰기)
- TTS는 음성 합성 (쓰기)

→ 읽기만으로는 **100% 작동 불가능**!

---

*API 키 설정 가이드 완료*