From ad939dde40a714a0740f6a780ed9b3bf6ced0b7c Mon Sep 17 00:00:00 2001 From: gahusb Date: Wed, 8 Apr 2026 09:15:19 +0900 Subject: [PATCH] =?UTF-8?q?docs:=20music-lab=20API=20=EB=AA=A9=EB=A1=9D=20?= =?UTF-8?q?=EC=97=85=EB=8D=B0=EC=9D=B4=ED=8A=B8=20=E2=80=94=20Phase=201~3?= =?UTF-8?q?=20=EC=8B=A0=EA=B7=9C=20=EC=97=94=EB=93=9C=ED=8F=AC=EC=9D=B8?= =?UTF-8?q?=ED=8A=B8=20=EB=B0=98=EC=98=81?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 4.6 --- CLAUDE.md | 33 ++++++++++++++++++++++++++++----- 1 file changed, 28 insertions(+), 5 deletions(-) diff --git a/CLAUDE.md b/CLAUDE.md index 6cf6a46..8d3758e 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -259,12 +259,30 @@ docker compose up -d | 메서드 | 경로 | 설명 | |--------|------|------| | GET | `/api/music/providers` | 사용 가능한 프로바이더 목록 | -| POST | `/api/music/generate` | 음악 생성 시작 (provider, lyrics, instrumental 지원) | -| GET | `/api/music/status/{task_id}` | 생성 상태 폴링 (queued→processing→succeeded/failed) | -| POST | `/api/music/lyrics` | Suno AI 가사 생성 (곡 생성 전 미리보기용) | +| GET | `/api/music/models` | Suno 모델 목록 (V4~V5.5) | +| GET | `/api/music/credits` | Suno 크레딧 조회 | +| 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) | -| DELETE | `/api/music/library/{id}` | 트랙 삭제 (로컬 파일 포함) | +| POST | `/api/music/library` | 트랙 수동 추가 | +| 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) 반환 → 둘 다 라이브러리에 저장