사용자가 곡을 업로드할 수 있는 제품이라면 같은 오디오로 여러 편곡과 보컬 스타일을 시도하게 할 수 있습니다. 서버에서 오디오 ID를 저장하고 편곡 방향별로 작업을 요청한 다음, 상태를 조회해 완성된 버전을 플레이어에 전달합니다.

연동 방법

항목

설명

엔드포인트

POST /v1/song/remix

모델 매개변수

model=mureka-9.5

오디오 소스

purpose=remix로 업로드해 upload_audio_id를 받거나 최근 한 달 이내 Mureka에서 생성한 곡의 song_id를 사용합니다.

길이

10–480 s

요청당 생성 수

n 기본값 2, 최대 3

가격

새 버전: 곡당 $0.5 (이전 버전 V8은 곡당 $0.2로 유지).

문서

API 문서

생성 결과는 원곡을 새롭게 해석하므로 원곡 가수의 음색은 유지되지 않습니다. 특정 가수의 음색을 지정하거나 스타일 참고용 오디오를 추가로 업로드하는 기능은 현재 지원되지 않습니다.

모델 선택: 요청의 model을 mureka-9.5로 설정하면 Remix V9.5를, mureka-8로 설정하면 V8을 사용합니다.

활용 사례

  • 커버·리믹스 앱: 무반주 보컬을 업로드해 여러 스타일의 완성된 편곡을 생성합니다.
  • 쇼트폼·콘텐츠 플랫폼: 하나의 배경 음악을 록, 일렉트로닉, 재즈 등으로 편곡해 장면 분위기에 맞춥니다.
  • 뮤지션·제작 도구: 연주하며 부르거나 허밍한 데모를 완성된 편곡으로 빠르게 확장해 스타일을 탐색합니다.
  • 게임·광고 음악: 같은 테마 멜로디를 장면마다 다른 강도로 변주합니다. Demo B를 참고하세요.

API 호출 흐름

원본 오디오 준비하기

이 예시는 보컬이 있는 곡을 사용합니다. POST /v1/files/upload를 호출하면서 purpose를 remix로 설정하고 반환된 파일 ID를 저장합니다. V9.5는 10~480초의 MP3와 M4A를 지원합니다. API 키는 서버에 보관하고 Bearer 인증을 사용하세요.

curl --fail-with-body https://api.mureka.ai/v1/files/upload \
  -H "Authorization: Bearer ${MUREKA_API_KEY}" \
  -F "purpose=remix" \
  -F "file=@./original.mp3"

Mureka의 곡 생성 API로 만든 곡은 조건에 맞는 song_id도 사용할 수 있습니다. 업로드한 파일에는 upload_audio_id, 기존 곡에는 song_id를 지정하고, 요청마다 하나만 사용합니다. 각 입력 방식의 제한은 API 문서를 참고하세요.

편곡 방향 하나에 대한 작업 요청하기

업로드 ID와 목표 스타일을 설명하는 prompt를 POST /v1/song/remix로 보냅니다. 예시는 mureka-9.5를 지정하고 보컬이 있는 록 버전을 요청합니다. 자리표시자를 업로드 응답의 ID와 실제 가사로 바꾸세요.

curl --fail-with-body https://api.mureka.ai/v1/song/remix \
  -H "Authorization: Bearer ${MUREKA_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "upload_audio_id": "<UPLOAD_AUDIO_ID>",
    "model": "mureka-9.5",
    "lyrics": "<LYRICS_FOR_THIS_VERSION>",
    "prompt": "Keep the chorus melody. Use distorted guitars and live rock drums, with a restrained verse and a bigger chorus.",
    "n": 1
  }'

동일한 prompt에서 여러 후보를 얻으려면 n을 사용합니다. 록, EDM, 여성 보컬 버전은 같은 업로드 ID를 재사용해 각각 다른 방향의 요청을 보냅니다. 앱에서 각 작업에 원본 오디오 ID, 버전 이름, 작업 ID를 연결하면 결과를 구분할 수 있습니다.

작업 상태를 확인하고 결과 재생하기

응답의 작업 ID를 저장한 뒤 GET /v1/song/query/{task_id}로 상태를 조회합니다. 생성 중에는 대기 상태를 표시하면서 계속 조회합니다. 성공하면 오디오 URL로 미리 듣기를 제공하고, 실패하면 작업 ID와 오류를 기록합니다.

curl --fail-with-body \
  "https://api.mureka.ai/v1/song/query/${TASK_ID}" \
  -H "Authorization: Bearer ${MUREKA_API_KEY}"

미리 듣기 페이지에서 원곡과 리믹스에 같은 곡 제목을 쓰고 버전 이름으로 구분할 수 있습니다. 사용자는 원곡으로 쉽게 돌아가고 현재 재생 중인 버전도 확인할 수 있습니다.

API 문서