Mureka 9.5 API 사용법? 5분 만에 첫 곡 완성하기

TL;DR

• 무엇인가: Mureka 9.5는 음악 생성 모델로, HiAPI에서 두 가지 경로를 제공합니다. 가사로 곡 만들기는 전체 가사를 제출하면 리드 보컬, 화음, 반주가 포함된 완성곡을 반환하고, 순수 음악은 설명 한 줄만 제출하면 보컬 없는 기악곡을 반환합니다. Mureka 9.5는 이미 HiAPI에 출시되었으며, 가사로 곡 만들기 모델 페이지 열기에서 온라인으로 미리 듣고 생성할 수 있습니다. 신규 사용자는 가입 시 200 크레딧을 받습니다.
• 얼마인가: 성공할 때마다 $0.3215(643 크레딧)이며 두 경로 모두 동일한 가격입니다. 가사 길이와 출력 길이에 관계없이 동일하고, 실패 시 사전 차감된 금액은 환불됩니다. $10이면 약 31곡입니다.
• 가장 빠르게 실행하는 법: 모델 페이지에서 가사를 붙여넣고 리드 보컬을 선택한 뒤 실행을 누르면 됩니다. 자체 제품에 연동하려면 POST /v1/tasks를 호출하고 model에 mureka-9.5/lyrics-to-song을 입력한 뒤 taskId를 받아 폴링하여 URL을 가져옵니다.

Mureka 9.5란 무엇인가?

가사는 이미 완성되었고 필요한 것은 노래로 불린 완성품입니다. Mureka 9.5의 가사로 곡 만들기 경로는 이 작업을 한 번의 요청으로 압축합니다. 전체 가사를 lyrics에 넣고, 선택 사항인 prompt로 장르, 감정, 악기, 리듬, 보컬 특성을 보충하며, gender로 리드 보컬이 여성인지 남성인지 고정하면 한 번에 믹싱된 곡을 반환합니다. 출력은 MP3, 44.1 kHz 스테레오, 약 256 kbps입니다.

사이트 내 실제 사례 세 곡의 길이는 각각 1:49, 3:02, 3:30이며 모두 같은 경로, 같은 단가에서 나왔습니다. 자동 작사는 제공하지 않으며 참고곡이나 멜로디도 받지 않습니다. 입력의 범위는 가사와 장르 방향입니다.

먼저 실제 완성곡 두 곡 듣기

가사로 곡 만들기 경로의 City Night Drive와 순수 음악 경로의 Wide-screen Overture는 모두 한 번의 요청, $0.3215로 만들어졌습니다.

미리 듣기: City Night Drive, 영어 인디 팝, 1:49

가사로 곡 만들기: City Night Drive · 1:49 · MP3 44.1 kHz 스테레오 256 kbps

미리 듣기: Wide-screen Overture, 영화 같은 오케스트라, 3:12

순수 음악: Wide-screen Overture · 3:12 · MP3 44.1 kHz 스테레오 256 kbps

두 경로의 차이

	가사로 곡 만들기	순수 음악
모델 ID	mureka-9.5/lyrics-to-song	mureka-9.5/instrumental
필수 필드	lyrics(1–5,000자)	prompt(1–1,024자)
선택 필드	prompt(1–2,000자), gender(female / male)	없음
출력	보컬이 포함된 완성곡	보컬 없는 기악곡
길이	모델이 가사 구조에 따라 결정	모델이 결정, 길이 파라미터 없음
단가	$0.3215 / 회	$0.3215 / 회

보컬 곡이 필요하면 왼쪽, 배경 음악이 필요하면 오른쪽을 선택하세요. 양쪽 모두 길이를 입력할 수 없으며, 사이트 내 순수 음악 사례 세 곡은 3:12, 3:08, 3:03입니다.

온라인 체험: 4단계

1. 가사로 곡 만들기 모델 페이지 열기하면 페이지에서 사이트 내 사례 세 곡을 바로 들을 수 있습니다.
2. 가사 상자에 전체 가사를 줄 단위로 붙여넣고 [Verse 1], [Chorus] 같은 구간 표시로 나눕니다.
3. 스타일 방향 상자에 장르, 감정, 악기, 보컬 특성을 작성하고, 리드 보컬 성별을 여성 또는 남성으로 선택합니다.
4. 「실행」을 누르고 작업이 끝나면 재생하고 다운로드할 수 있습니다. 1회당 $0.3215입니다.

순수 음악은 2단계를 기악곡 설명으로 바꾸면 됩니다. 순수 음악 모델 페이지 열기에서 마찬가지로 4단계를 따르세요.

처음 시도할 때 스타일 방향은 이 문장을 그대로 써도 됩니다:

Warm indie-pop song with a bright female lead vocal, chiming guitars, steady live drums and a wide sing-along chorus, hopeful late-night mood.

이 프롬프트로 생성하기 →

클릭하면 스타일 방향 상자에 채워집니다. 그다음 자신의 가사 네 줄을 붙여넣고 리드 보컬을 여성으로 선택하면 첫 곡을 만들 수 있습니다.

API 연동: 4단계

1. 가입 후 콘솔에서 API Key를 생성합니다.
2. POST https://api.hiapi.ai/v1/tasks에 model과 input을 제출합니다.
3. 반환된 data.taskId에서 작업 ID를 받아 GET /v1/tasks/{taskId}를 폴링하거나 콜백을 기다립니다.
4. 상태가 success가 되면 data.output에서 type=audio인 항목을 가져와 MP3를 다운로드합니다.

가사로 곡 만들기: curl

curl -s -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "mureka-9.5/lyrics-to-song",
    "input": {
      "lyrics": "[Verse 1]\nCity lights are waking up\nEvery window starts to glow\n[Chorus]\nWe keep moving through the night\nEvery shadow turns to gold",
      "prompt": "Warm indie-pop song with a bright female lead vocal, chiming guitars, steady live drums and a wide sing-along chorus, hopeful late-night mood.",
      "gender": "female"
    }
  }'

반환값에서 작업 ID를 가져옵니다:

{"code":200,"data":{"taskId":"tk-hiapi-..."},"message":"success"}

순수 음악: curl

curl -s -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "mureka-9.5/instrumental",
    "input": {
      "prompt": "Cinematic orchestral instrumental with a fragile piano ostinato, evolving string swells, low brass and soft timpani, hopeful then resolute, wide film-score reverb."
    }
  }'

상태 조회:

curl -s https://api.hiapi.ai/v1/tasks/YOUR_TASK_ID \
  -H "Authorization: Bearer YOUR_API_KEY"

data.status는 순서대로 queued, handling, success 또는 fail일 수 있습니다.

Python: 작업 생성, 폴링, 링크 가져오기

import time
import requests

BASE = "https://api.hiapi.ai/v1/tasks"
HEADERS = {"Authorization": "Bearer YOUR_API_KEY"}

payload = {
    "model": "mureka-9.5/lyrics-to-song",
    "input": {
        "lyrics": "[Verse 1]\nCity lights are waking up\nEvery window starts to glow\n[Chorus]\nWe keep moving through the night\nEvery shadow turns to gold",
        "prompt": "Warm indie-pop song with a bright female lead vocal, chiming guitars, steady live drums and a wide sing-along chorus, hopeful late-night mood.",
        "gender": "female",
    },
}

resp = requests.post(BASE, headers=HEADERS, json=payload, timeout=30)
task_id = resp.json()["data"]["taskId"]

while True:
    data = requests.get(f"{BASE}/{task_id}", headers=HEADERS, timeout=30).json()["data"]
    if data["status"] in ("success", "fail"):
        break
    time.sleep(10)

if data["status"] == "success":
    audio_url = next(item["url"] for item in data["output"] if item["type"] == "audio")
    print(audio_url)
else:
    print(data.get("error"))

순수 음악은 같은 폴링 로직을 사용하고 제출 내용만 바꾸면 되며, 단독으로도 실행할 수 있습니다:

import time
import requests

BASE = "https://api.hiapi.ai/v1/tasks"
HEADERS = {"Authorization": "Bearer YOUR_API_KEY"}

payload = {
    "model": "mureka-9.5/instrumental",
    "input": {
        "prompt": "Cinematic orchestral instrumental with a fragile piano ostinato, evolving string swells, low brass and soft timpani, hopeful then resolute, wide film-score reverb.",
    },
}

task_id = requests.post(BASE, headers=HEADERS, json=payload, timeout=30).json()["data"]["taskId"]

while True:
    data = requests.get(f"{BASE}/{task_id}", headers=HEADERS, timeout=30).json()["data"]
    if data["status"] in ("success", "fail"):
        break
    time.sleep(10)

print(next((item["url"] for item in data.get("output", []) if item["type"] == "audio"), data.get("error")))

출력 및 형식

요청마다 MP3 한 곡을 반환하며 44.1 kHz, 스테레오, 약 256 kbps입니다. 다운로드할 때는 data.output에서 type이 audio인 항목을 찾으면 되며, 응답 최상위에서 문자열을 찾지 마세요.

반환된 url은 만료되므로 DB에 저장하기 전에 파일을 자체 스토리지로 먼저 이전하세요.

출시 전 유의사항

1. 콜백과 폴링을 함께 쓰세요. 요청 본문에 "callback": {"url": "https://yourapp.com/webhook", "when": "final"}을 넣으면 작업이 최종 상태에 들어갈 때 알림을 받습니다. 알림이 유실될 수 있으므로 정기 조회를 함께 구성하세요.
2. taskId를 먼저 저장하고 POST를 반복하지 마세요. 작업을 생성할 때마다 1회 과금되며, 클라이언트가 타임아웃될 때 작업이 이미 생성되었을 수 있습니다. taskId를 DB에 저장하고 재시도 전에 상태를 먼저 확인하세요.
3. 가사를 줄 단위로 나누세요. 한 줄에 한 문장씩, 절과 후렴 순서를 유지하고 구간 표시를 명확히 하면 구조가 훨씬 안정적입니다. 최대 5,000자입니다.
4. 리드 보컬 성별을 명시하세요. 전달하지 않으면 모델이 결정합니다. 시리즈 곡이나 브랜드 곡을 만들 때는 female 또는 male을 고정해야 같은 소재로 만든 곡의 목소리가 일관됩니다.

FAQ

가사를 비워 두고 모델이 자동으로 쓰게 할 수 있나요? 아니요. lyrics는 필수이며 1–5,000자입니다. 자동 작사가 필요하면 자동 가사를 지원하는 음악 모델을 사용하세요.

한 곡의 최대 길이는 얼마인가요? 길이 파라미터는 없으며 모델이 가사 구조에 따라 결정합니다. 사이트 내 가사로 곡 만들기 사례 세 곡은 1:49, 3:02, 3:30이고, 순수 음악 세 곡은 3:12, 3:08, 3:03입니다.

순수 음악에서 보컬이 나오나요? 아니요. 순수 음악 경로는 노래 보컬을 생성하지 않으며 설명에 리드 보컬을 적어도 마찬가지입니다. 보컬이 필요하면 가사로 곡 만들기 경로로 바꾸세요.

생성 실패 시 요금이 차감되나요? 차감되지 않습니다. 실패한 작업의 사전 차감 금액은 자동으로 환불됩니다.

지금 첫 곡 완성하기

위의 curl을 터미널에 붙여넣고 YOUR_API_KEY를 자신의 key로, 가사를 자신의 것으로 바꾸면 첫 taskId를 얻을 수 있습니다. 먼저 결과를 보고 싶다면 가사로 곡 만들기 모델 페이지 열기에서 실행을 누르세요. 전체 문서는 가사로 곡 만들기 연동 문서와 순수 음악 연동 문서를 참고하세요.

관련 글: Mureka 9.5 가격: 한 곡 $0.3215 · Mureka 9.5 vs MiniMax Music 2.6 · Mureka 9.5 프롬프트 모음: 실제 사례 6가지