---

🎵 Mureka API 사용 가이드 & 파인튜닝 워크플로우

---

📌 개요

Mureka는 AI 기반 음악 생성 플랫폼으로, 사용자 입력에 따라 노래, BGM, 가사, TTS 등을 생성할 수 있습니다. 특히, 사용자의 음악 데이터를 기반으로 **커스텀 AI 음악 생성 모델(Fine-Tuning)**도 구축할 수 있습니다.

---

🧩 주요 기능 정리

기능	설명	과금
🎶 곡 생성	가사 + 스타일 지정 → 보컬 포함 전체 곡 생성	✅ $0.03/곡
🎧 BGM 생성	프롬프트 또는 샘플 기반 배경음악 생성	✅ $0.03/BGM
📝 가사 생성	전체 가사 또는 한 줄씩 생성	✅ $0.009/곡, $0.002/줄
🎙 TTS 생성	AI 음성으로 낭독, 보이스 클로닝 등	✅ $4.9/시간 ($6.9/팟캐스트)
🎚 스템 오디오 다운로드	보컬, 반주, 드럼 등 파트별 추출	✅ $0.06/곡
🧠 Fine-Tuning 모델 생성	나만의 스타일 학습된 음악 생성 모델 생성	✅ $99 (또는 $199) 1회 요금

---

🔄 생성 방식별 차이: Reference vs Fine-Tuning

항목	Reference 방식	Fine-Tuning 방식
사용 목적	특정 곡 스타일 흉내내기	나만의 스타일 모델 생성
입력	reference_id	upload_id + suffix
데이터 양	1곡	100~200곡 권장
일관성	낮음 (샘플 하나 기준)	높음 (전체 스타일 학습)
유지성	매 요청마다 ID 입력	모델 이름만 유지
비용	$0.03/곡	$99~199 + $0.03/곡

---

🛠️ 곡 생성 API 구조 (/v1/song/generate)

🔹 필수 입력

• lyrics: 가사 (필수)

🔸 선택 입력 (아래 중 1개만 사용 가능)

• prompt: 텍스트로 스타일 지정
• reference_id: 업로드한 곡 참고
• vocal_id: 보이스 클론용 음성 참고
• melody_id: 멜로디 아이디어로 사용

🧾 예시 요청 (프롬프트 기반)

{
  "lyrics": "In the stormy night, I wander alone...",
  "prompt": "r&b, slow, passionate, male vocal",
  "model": "auto"
}

---

📂 업로드 → 파인튜닝 전체 흐름

1. upload/create – 업로드 세션 생성

{
  "upload_name": "my_training_set",
  "purpose": "fine-tuning"
}

2. upload/parts – 오디오 조각 업로드 (mp3, 최대 10MB)

• multipart/form-data 방식 사용
• 오디오 길이: 30초 ~ 4분 30초

3. upload/complete – 업로드 완료 처리

{
  "upload_id": "upload_abc123"
}

✅ 업로드는 무료입니다 (과금 ❌)

---

🧠 파인튜닝 모델 생성 (/v1/fine-tuning/create)

{
  "upload_id": "upload_abc123",
  "suffix": "lofi-style"
}

응답 예시

{
  "fine_tuned_model": "lora:mureka-6:4354198:lofi-style"
}

📌 주의사항

• suffix: 소문자, 숫자, 하이픈만 허용, 32자 이내
• 과금: $99~$199 1회 + 생성 이후엔 곡당 $0.03

---

🎶 파인튜닝 모델로 곡 생성하기

{
  "lyrics": "Here in silence, I find peace...",
  "model": "lora:mureka-6:4354198:lofi-style"
}

---

💰 과금 요약

항목	과금 여부	요율
업로드	❌ 무료	–
곡 생성	✅ 과금	$0.03/곡
스템 다운로드	✅ 과금	$0.06/곡
가사 생성	✅ 과금	$0.009/곡 or $0.002/줄
TTS 생성	✅ 과금	$4.9~$6.9/시간
Fine-Tuning	✅ 과금	$99~199 (1회)

---

📌 마무리 요약

• Reference 방식: 특정 곡 스타일 따라 생성 (빠름, 단기적)
• Fine-Tuning 방식: 내 스타일을 AI가 학습해 일관된 결과 제공 (장기적, 브랜딩 가능)
• 업로드 및 모델 생성은 분리된 과정이며, 업로드는 무료, 생성/파인튜닝 단계에서 과금됨
• 원하는 방식에 따라 적절한 API 사용 전략 필요