coconut / OPENAI_API_KEY_GUIDE.md
alohaboy
feat: Add LLM-based chat mode and integrate YJ pipeline
caf53ab
# 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 키 설정 가이드 완료*