docs: music-lab API 목록 업데이트 — Phase 1~3 신규 엔드포인트 반영

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

CLAUDE.md

@@ -259,12 +259,30 @@ docker compose up -d
 | 메서드 | 경로 | 설명 |
 |--------|------|------|
 | GET | `/api/music/providers` | 사용 가능한 프로바이더 목록 |
-| POST | `/api/music/generate` | 음악 생성 시작 (provider, lyrics, instrumental 지원) |
+| GET | `/api/music/models` | Suno 모델 목록 (V4~V5.5) |
-| GET | `/api/music/status/{task_id}` | 생성 상태 폴링 (queued→processing→succeeded/failed) |
+| GET | `/api/music/credits` | Suno 크레딧 조회 |
-| POST | `/api/music/lyrics` | Suno AI 가사 생성 (곡 생성 전 미리보기용) |
+| POST | `/api/music/generate` | 음악 생성 (provider, model, vocal_gender, negative_tags, style_weight, audio_weight) |
+| GET | `/api/music/status/{task_id}` | 생성 상태 폴링 |
+| POST | `/api/music/lyrics` | Suno AI 가사 생성 |
 | GET | `/api/music/library` | 라이브러리 전체 조회 |
-| POST | `/api/music/library` | 트랙 수동 추가 (201) |
+| POST | `/api/music/library` | 트랙 수동 추가 |
-| DELETE | `/api/music/library/{id}` | 트랙 삭제 (로컬 파일 포함) |
+| DELETE | `/api/music/library/{id}` | 트랙 삭제 |
+| POST | `/api/music/extend` | 곡 연장 |
+| POST | `/api/music/vocal-removal` | 보컬/인스트 분리 (2트랙) |
+| POST | `/api/music/cover-image` | 커버 이미지 2장 생성 |
+| POST | `/api/music/wav` | WAV 고음질 변환 |
+| POST | `/api/music/stem-split` | 12스템 분리 (50cr) |
+| GET | `/api/music/timestamped-lyrics` | 타임스탬프 가사 (가라오케) |
+| POST | `/api/music/style-boost` | AI 스타일 프롬프트 생성 |
+| POST | `/api/music/upload-cover` | 외부 음원 AI Cover |
+| POST | `/api/music/upload-extend` | 외부 음원 확장 |
+| POST | `/api/music/add-vocals` | 인스트에 AI 보컬 추가 |
+| POST | `/api/music/add-instrumental` | 보컬에 AI 반주 추가 |
+| POST | `/api/music/video` | 뮤직비디오 MP4 생성 |
+| GET | `/api/music/lyrics/library` | 저장된 가사 목록 |
+| POST | `/api/music/lyrics/library` | 가사 저장 |
+| PUT | `/api/music/lyrics/library/{id}` | 가사 수정 |
+| DELETE | `/api/music/lyrics/library/{id}` | 가사 삭제 |
 
 **환경변수**
 - `SUNO_API_KEY`: Suno API 키 (미설정 시 Suno provider 비활성화)
@@ -277,6 +295,11 @@ docker compose up -d
 - `lyrics`: Suno 생성 가사 텍스트
 - `image_url`: Suno 생성 커버 이미지 URL
 - `suno_id`: Suno 곡 ID (CDN 참조용)
+- `file_hash`: MD5 해시 (rename 감지용)
+- `cover_images`: JSON 배열 — 커버 이미지 URL 목록
+- `wav_url`: WAV 변환 URL
+- `video_url`: 뮤직비디오 URL
+- `stem_urls`: JSON 객체 — 12스템 URL 맵
 
 **Suno 생성 특이사항**
 - 1회 생성 시 2개 변형(variation) 반환 → 둘 다 라이브러리에 저장