Mureka api tutorial

reAPI에서 Mureka API를 요청하려면 모델 ID mureka-v9-song과 가사 lyrics가 필요합니다. 문서에 따르면 먼저 작업 ID를 받고, 완료 후 노래 URL을 받습니다. 요청당 최대 3곡을 지정할 수 있으며 출력 형식은 mp3, wav, flac입니다.^[1]

이 튜토리얼은 2026년 10월 22일 확인한 공개 문서와 구현을 바탕으로 해당 reAPI 인터페이스만 설명합니다. 예제를 실제로 제출해 오디오를 생성하지 않았습니다. 요청 구성과 결과 처리를 설명하며 생성 속도, 음악 품질, 참조 충실도 또는 최신 Mureka 모델이라는 주장을 하지 않습니다. 표지는 개념 이미지이며 오디오 생성 결과가 아닙니다.

핵심 내용

부를 단어는 lyrics에, 음악 방향은 선택 항목인 prompt에 넣습니다.^[1]
number_of_songs: 1부터 시작합니다. 문서상 범위는 1–3이며 수량은 요금에 영향을 줍니다.^[1]
제출 후 반환된 id를 저장하고 해당 작업이 끝날 때까지 조회합니다.^[2]
completed 이후 output.audio_urls를 읽습니다. 장기 보관이 필요하면 자체 저장소에 복사합니다.^[2]

mureka api key

아래 요청의 대상은 reapi.ai이며 reAPI API 키가 필요합니다. reAPI 대시보드의 API Keys에서 키를 만들고 표시될 때 저장하세요. 요청마다 Authorization: Bearer ...로 전달합니다. 인증 가이드에 키 생성과 인증 오류가 설명되어 있습니다.^[3]

키는 서버나 비밀 관리 서비스에 보관합니다. 아래 셸 변수 REAPI_API_KEY는 해당 비밀값을 뜻하며 튜토리얼에서 키를 제공하는 것은 아닙니다. 실제 키를 브라우저용 JavaScript, 스크린샷, 공개 저장소에 넣지 마세요. 다른 서비스의 계정이나 키는 reAPI에서 발급한 인증 정보를 대신할 수 없습니다.

mureka api docs

Mureka V9 Song 레퍼런스는 노래할 텍스트와 음악 지시를 구분합니다. lyrics는 필수이며 최대 3000자입니다. 선택 항목인 prompt는 최대 1024자로 장르, 분위기, 악기, 보컬 음색, 템포 등을 설명할 수 있습니다.^[1]

예를 들어 절과 후렴의 가사는 lyrics에, “부드러운 피아노 팝과 절제된 타악기” 같은 방향은 prompt에 넣습니다. 이는 입력 예시이며 검증된 제작법이 아닙니다. 부를 내용을 스타일 프롬프트에만 넣으면 필수 가사 필드를 충족하지 못합니다.

필드	문서상 입력	첫 요청 권장 설정
`model`	`mureka-v9-song`	정확한 식별자를 사용합니다.
`lyrics`	필수, 최대 3000자	자신의 가사를 입력합니다.
`prompt`	선택, 최대 1024자	원하는 음악 스타일을 설명합니다.
`number_of_songs`	정수 1–3, 기본값 1	한 곡을 요청하려면 1을 사용합니다.
`output_format`	`mp3`, `wav`, `flac`, 기본값 `mp3`	앱에 필요한 형식을 선택합니다.
`reference_id`, `vocal_id`, `melody_id`	선택적인 기존 참조 ID	유효한 ID가 없다면 생략합니다.

참조 필드는 ID를 받으며 로컬 파일 이름, 오디오 URL, 자유 형식 설명을 받는 필드가 아닙니다. 이 튜토리얼은 업로드 엔드포인트나 ID 발급 절차를 제공하지 않습니다. 기본 가사와 스타일 작업에서는 생략하고, 해당 필드에 맞는 유효한 기존 ID가 있을 때만 추가하세요. 참조 제어 항목이 있다는 사실만으로 결과가 참조를 얼마나 따르는지 입증되지는 않습니다.^[1]

Mureka api tutorial

문서를 바탕으로 구성한 요청 예제입니다. 짧은 가사는 설명용 텍스트입니다. 실행을 결정했다면 자신의 자료로 바꾸고 서버 환경에 키를 설정하세요. 생성 요청을 제출하면 요금이 발생할 수 있습니다.

curl https://reapi.ai/api/v1/audio/generations \
  -H "Authorization: Bearer $REAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "mureka-v9-song",
    "lyrics": "Morning light across the floor\nI leave a note beside the door",
    "prompt": "Soft piano pop with restrained percussion",
    "number_of_songs": 1,
    "output_format": "mp3"
  }'

POST에서 받은 id를 제출 설정과 함께 저장합니다. 이를 TASK_ID에 넣고 같은 인증 방식으로 상태를 조회합니다.

curl "https://reapi.ai/api/v1/tasks/$TASK_ID" \
  -H "Authorization: Bearer $REAPI_API_KEY"

앱의 다음 동작은 조회 응답에 따라 결정합니다.^[2]

`status`	앱 동작
`processing`	대기 상태를 유지합니다. 작업 ID를 완성된 오디오 파일로 취급하지 않습니다.
`completed`	`output.audio_urls`를 읽고 반환된 파일을 사용자에게 제공합니다.
`failed`	`error`와 `usage.credits`를 읽고 성공 결과를 기다리는 동작을 종료합니다.

앱의 폴링 시간이 초과되었다고 생성 실패가 입증되는 것은 아닙니다. 자동으로 새 생성 요청을 보내지 말고 작업 ID를 보관해 다시 조회하세요. 작업 레퍼런스에 폴링과 오류가 설명되어 있습니다. HTTP 429에서는 Retry-After를 따르고 간격 없이 같은 요청을 반복하지 마세요.

mureka api pricing

문서의 과금 단위는 생성된 곡입니다. number_of_songs가 수량을 제어하며 prompt, 출력 형식, 선택 참조 필드는 이 모델의 문서 계약에서 별도의 가격 기준이 아닙니다.^[1] Mureka V9 Song 모델 페이지에서 원하는 곡 수를 설정해 현재 견적을 확인하세요.

폴링 자체는 크레딧을 소비하지 않습니다. usage.credits는 정산된 정수 크레딧 요약이므로 status와 함께 읽어야 합니다. processing 중 0이라고 무료 생성은 아닙니다. 실패한 작업에는 0 또는 유지된 요금이 표시될 수 있으므로 모든 실패가 전액 환불이라고 가정하면 안 됩니다.^[2] 다른 변형을 만들기 위한 새 POST는 상태 조회가 아니라 새 생성 요청입니다.

Mureka api download

completed 이후에는 한 곡만 요청했어도 output.audio_urls를 배열로 처리합니다. 문서상 생성된 곡마다 URL 하나가 지정한 형식으로 반환됩니다. 여러 곡 요청을 허용하는 앱에서는 첫 결과만 저장하지 않도록 하세요.^[1]

보관이 필요하면 반환된 파일을 다운로드하고 자체 보존 정책에 따라 저장하세요. 작업 계약은 결과 URL의 영구 보관을 보장하지 않습니다.^[2] 작업 ID, 요청 설정, 상태, 저장 위치를 함께 관리하면 진행 중인 작업과 완료되었지만 아직 복사하지 않은 곡을 구별할 수 있습니다.

Mureka API를 처음 연동할 때는 위의 최소 요청부터 시작해 세 가지 작업 상태를 처리하고, 실제 오디오를 확인한 후 운영 흐름에 사용하세요. 모델 페이지는 현재 견적을, API 레퍼런스는 전체 필드 계약을 제공합니다.

관련 API 검색

[1] Mureka V9 Song API. 확인일: 2026년 10월 22일.

[2] 작업. 확인일: 2026년 10월 22일.

[3] 인증. 확인일: 2026년 10월 22일.

Mureka api tutorial

mureka api key

mureka api docs

Mureka api tutorial

mureka api pricing

Mureka api download

mureka v9 api

mureka api documentation

mureka api cost

mureka api platform