음악 생성 스킬
개요
이 스킬은 MiniMax 음악 생성 API(/v1/music_generation)를 사용하여 구조화된 JSON 명세로부터 노래(보컬 또는 악기 연주곡)를 생성합니다. prompt에 스타일/분위기/장면을 설명하고, 선택적으로 lyrics를 제공하면 스크립트가 MP3 파일을 반환합니다.
워크플로우
1단계: 요구 사항 파악
원하는 스타일, 분위기, 장면, 언어를 파악하고 사용자가 보컬을 원하는지 순수 악기 연주곡을 원하는지 결정합니다. 가사를 제공할지 모델이 자동으로 작성하게 할지 결정합니다.
2단계: 명세 JSON 생성
/mnt/user-data/workspace/ 디렉토리에 {설명적-이름}.json 형식의 JSON 파일을 작성합니다:
{
"title": "비 오는 밤 카페",
"prompt": "인디 포크, 우울한, 내성적인, 혼자 걷기, 카페",
"lyrics": "[verse]\n가로등이 빛나고 밤바람이 한숨 쉬네\n[chorus]\n나무 문을 밀면 따뜻한 공기가 들어와"
}
필드:
title(선택 사항): 사람이 읽을 수 있는 이름.prompt(필수): 스타일, 분위기, 장면. 음악적 특성을 결정합니다.lyrics(선택 사항): 노래 가사. 줄 사이에\n을 사용하고[Intro],[Verse],[Pre Chorus],[Chorus],[Bridge],[Outro]와 같은 구조 태그를 포함합니다.is_instrumental(선택 사항, 불리언): 순수 악기 연주곡(가사 필요 없음)의 경우true로 설정합니다.
동작 방식:
lyrics가 제공되면 → 해당 가사가 노래됩니다.is_instrumental: true→ 악기 연주곡, 보컬 없음.- 둘 다 없으면 → 모델이
prompt로부터 자동으로 가사를 작성합니다(lyrics_optimizer).
3단계: 생성 실행
python /mnt/skills/public/music-generation/scripts/generate.py \
--prompt-file /mnt/user-data/workspace/rainy-night-cafe.json \
--output-file /mnt/user-data/outputs/rainy-night-cafe.mp3
매개변수:
--prompt-file: JSON 명세의 절대 경로 (필수).--output-file: 출력 MP3의 절대 경로 (필수).
[!NOTE] 파이썬 파일을 읽지 말고, 매개변수와 함께 호출만 하세요.
환경 변수
MINIMAX_API_KEY(필수): MiniMax 인터페이스 키.MINIMAX_API_HOST(선택 사항): 기본값https://api.minimaxi.com.MINIMAX_MUSIC_MODEL(선택 사항): 기본값music-2.6-free(모든 API 키 사용자에게 작동); 유료/토큰 플랜 사용자는 더 높은 한도를 위해music-2.6을 설정할 수 있습니다.
출력 처리
- 음악은 MP3로 저장됩니다 (일반적으로
/mnt/user-data/outputs/디렉토리). present_files도구를 사용하여 생성된 파일을 사용자와 공유합니다.- 필요한 경우 스타일이나 가사에 대한 수정을 제안합니다.
참고 사항
prompt는 스타일/분위기/장면에 집중하고, 실제로 노래되는 단어는lyrics에 넣으세요.- 비영어권 노래의 경우
lyrics를 해당 언어로 작성하세요.