소개
노래·배경 음악 엔드포인트는 최대 1,024자의 스타일 프롬프트와 최대 5,000자의 가사를 받습니다. 반주 음악에는 가사 없이 instrumental을 사용하고 출력 형식과 받을 버전 수를 고릅니다.
| 항목 | 값 |
|---|---|
| 입력 | 텍스트 |
| 출력 | 오디오 |
| 스타일 입력 | prompt: 최대 1,024자 |
| 가사 입력 | lyrics: 구간 태그 포함 최대 5,000자 |
| 버전 수 |
|
| 파일 선택지 | mp3, wav, flac |
| 배포사 안내 길이 | Mureka 안내 기준 노래 약 5:30, 배경 음악 약 4:30 |
| 관찰한 포크 결과 | 약 2:31, 어쿠스틱 기타와 따뜻한 남성 보컬 |
| 과금 수량 | V9 버전 하나가 과금 대상 1곡이며 보컬·연주 모드의 단가는 동일 |
핵심 기능 및 하이라이트
느린 R&B의 따뜻한 남성 보컬
제공 절·후렴은 늦은 밤이 이어지길 바라는 느린 R&B가 됐습니다. 반환 MP3의 따뜻한 남성 보컬을 이 방향의 구체적인 예시로 들어 봅니다.
2분31초의 포크곡
어쿠스틱 기타 구상과 절·후렴을 제공해 따뜻한 남성 목소리가 해당 가사를 부르는 2:31 트랙을 받았습니다.
학습용 로파이 반주
instrumental을 켜고 가사를 비우자 같은 모델이 배경용 피아노와 느린 로파이 비트를 반환했습니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 최대 1,024자로 장르, 악기 구성, 분위기, 템포와 목소리를 지시합니다. 설명 내용은 곡당 단가를 바꾸지 않습니다. 1자 이상 · 1024자 이하 |
lyrics | 아니요 | [Verse], [Chorus] 등의 태그로 최대 5,000자의 가사를 제공합니다. 연주곡에는 lyrics를 생략하며 별도 가사 요금은 없습니다. 1자 이상 · 5000자 이하 |
instrumental | 아니요 | 켜면 prompt에서 가사나 보컬 없는 배경 음악을 만듭니다. 노래와 배경 음악에는 같은 V9 단가가 적용됩니다. 기본값: |
num_outputs | 아니요 | V9 버전 수를 1–3으로 정합니다. 각 버전마다 요금이 부과되므로 더 많이 요청할수록 청구액이 늘어납니다. |
output_format | 아니요 | 반환 오디오 형식을 mp3, wav 또는 flac으로 고릅니다. V9는 형식 선택이 아닌 곡 수로 과금합니다. |
요금
$0.084 / 곡
V9는 num_outputs로 요청한 각 버전에 노래·배경 음악 공통 단가를 적용합니다. 실패한 요청은 무료이며 V9의 곡당 비용은 V9.5보다 낮습니다.
활용 사례
가사 초안을 실제 노래로
절·후렴을 보컬 데모로 듣고 문구를 수정합니다. 어쿠스틱 포크 테스트는 따뜻한 남성 목소리로 제공 가사를 부른 약 2:31 트랙이었습니다.
차분한 R&B 분위기 탐색
편안한 그루브와 보컬 지시, 직접 쓴 늦은 밤 가사를 결합합니다. 새 예시는 따뜻한 남성 목소리로 제공 절·후렴을 부른 느린 R&B MP3입니다.
조용한 학습 사운드트랙
노랫말이 불필요한 반주는 instrumental을 사용합니다. 예시는 피아노·바이닐 잡음의 느린 로파이 비트이며 직접 결과도 사용할 환경에서 듣습니다.
같은 구상의 테이크 비교
같이 들어 볼 후보가 필요하면 2~3개를 요청합니다. 가사·음악 방향을 같은 요청에서 유지해 같은 기준으로 판단하며 모든 버전은 유료입니다.
프로젝트 인계용 오디오
협업자가 요청한 MP3·WAV·FLAC으로 고릅니다. 내려받은 곡과 원본 가사·스타일 구상을 함께 둬 후속 수정 출발점을 기록합니다.
프롬프트 가이드 및 실전 팁
V9 편곡을 설명합니다
prompt에 어쿠스틱 기타와 모닥불 분위기의 인디 포크처럼 음악 설명을 작성합니다.
노래 가사와 반주 중에서 고릅니다
노래는 lyrics에 태그를 붙인 가사를 넣습니다. 반주 트랙은 instrumental을 켜고 가사를 생략합니다.
버전 수와 내보내기 형식을 정합니다
음악 요청을 제출하기 전에 출력 1–3개와 mp3, wav 또는 flac 형식을 선택합니다.
음악 구상에서 노래·반주로
Mureka V9는 스타일과 제공 가사를 결합해 보컬 트랙을 만듭니다. 같은 노래·배경 음악 엔드포인트에서 instrumental을 켜고 가사를 비우면 연주곡도 받습니다. 가사를 노래로 듣거나 분위기·악기를 설명할 반주에 사용합니다.
한 요청에서 같은 아이디어의 후보 1·2·3개를 만들 수 있고 버전마다 별도 과금합니다. 추가 곡을 무료 대안으로 보지 말고 청취 비교를 계획합니다.
파라미터와 입력
| 필드 | 값 | 참고 |
|---|---|---|
| prompt | 최대 1,024자 | 장르·악기·분위기·템포·목소리 |
| lyrics | 최대 5,000자 | [Verse]·[Chorus] 등과 부를 가사 |
| instrumental | 배경 음악에 활성화 | lyrics를 비우고 prompt에 음악 방향 |
output_format | mp3, wav, flac | 프로젝트 형식 선택 |
num_outputs | 1, 2, 3 | 유료 버전 수 |
보컬은 prompt에 편곡, lyrics에 노랫말을 나눕니다. 장르뿐 아니라 주도 악기·지원 파트를 정하면 결과를 평가하기 쉽습니다. 가사 안에 노래하지 말라는 요청을 쓰기보다 반주에는 instrumental을 사용합니다.
평가할 수 있는 구상 작성
악기 역할
절제된 어쿠스틱 포크, 핑거피킹 기타 주도, 부드러운 타악기, 따뜻한 남성 목소리, 사색적인 저녁 분위기처럼 적을 수 있습니다. 추가 테스트 결과가 아닌 예시이며 관련 없는 형용사보다 들을 수 있는 선택을 줍니다.
로파이는 피아노 등 주도 음색, 비트 속도, 편곡의 밀도를 적습니다. 조용한 학습곡과 전면에 쓰는 노래는 활동량이 다릅니다. instrumental이 작업을 바꾸고 설명은 성격을 정합니다.
읽기 쉬운 가사 초안
[Verse]와 [Chorus]를 별도 줄에 두고 해당 가사를 잇습니다. 줄바꿈으로 초안과 연주를 대조하고 제작 지시를 섞지 말고 부를 문구를 적습니다. 태그가 줄마다 정확한 시간을 정하지 않으므로 표현과 구간 전환은 들어 봅니다.
한 구상으로 후보 비교
가사·음악 방향을 결과와 함께 저장합니다. 여러 출력은 목소리 성격, 명료한 단어, 원하는 악기, 후렴 진입을 같은 기준으로 평가합니다. 후속 요청에서는 음악 지시 하나씩 바꿔 비교 목적을 분명히 합니다.
반환된 예시
- 늦은 밤 R&B: 새 MP3는 밤이 이어지길 바라는 절·후렴을 따뜻한 남성 목소리로 부르는 느린 R&B입니다. 원본 구상은 부드러운 전자피아노와 늦은 밤 베이스 그루브를 지정했지만 관찰 근거는 스타일·보컬이며 악기별 별도 측정은 없습니다.
- 여행 포크: 제공 가사는 어쿠스틱 기타·따뜻한 남성 보컬의 약 2분31초 곡이 됐습니다. 해당 녹음의 길이입니다.
- 학습 로파이: instrumental 설정은 보컬 없이 부드러운 피아노·바이닐 잡음의 느린 로파이를 반환했습니다.
나열한 입력의 특정 결과이며 완료 시간·고정 길이·이후 동일 결과를 입증하지 않습니다. 프로젝트 사용 전에 후렴 뒤 전환과 끝까지 듣습니다.
버전 수와 요금
생성 V9 버전 수로 과금합니다. 보컬곡과 연주 배경 음악의 곡당 요금은 같고 실패는 무료입니다. 2·3개 출력은 해당 수량으로 과금합니다. 고정 통화 금액 대신 Mureka V9 모델 페이지의 현재 가격을 확인합니다.
길이, 보관, 모델 선택
Mureka는 노래 최대 약 5분30초, 배경 음악 약 4분30초를 설명합니다. 배포사 한도이며 각 곡의 목표 길이가 아닙니다. 제어 목록에 길이 설정이 없으므로 시간 요건이 있으면 실제 길이를 검토합니다.
생성 오디오는 14일 뒤 삭제됩니다. 그 전에 테이크를 받고 prompt·lyrics·형식·버전 수를 함께 둡니다.
별도 female·male vocal_gender를 원하고 높은 곡당 요금을 수용하면 Mureka V9.5를 고릅니다. V9는 대신 num_outputs와 낮은 요금을 제공합니다. MiniMax Music 3.0도 직접 자료로 들어 볼 모델이며 결과 음악과 필요한 제어로 비교합니다.
Mureka V9는 생성 버전별로 과금하며 실패한 음악 요청에는 비용이 발생하지 않습니다.
API 빠른 시작
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "mureka/v9/text-to-audio",
"input": {
"prompt": "Calm ambient pads with a slow rising motif",
"num_outputs": 1,
"output_format": "mp3"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
인증, 전체 스키마, 폴링과 오류 처리는 API 레퍼런스에서 확인하세요.

