어떤 파일이 필요한가요?
| 자료 | 용도 |
|---|---|
| 공식 YuE 저장소 | Python 추론, 예제 요청, 악보 편집 도구와 코드. |
| m-a-p/YuE2-3B | Python 파이프라인의 핵심 생성 모델. |
| m-a-p/YuE2-Vae | 일반 생성과 감상에 사용하는 기본 디코더. |
| Comfy-Org/YuE2 | ComfyUI 기본 템플릿에 맞춘 모델 파일. |
YuE2-Vae-legacy는 발표된 벤치마크를 재현할 때 사용합니다. 일반적인 첫 생성에는 현재 기본 VAE를 사용하세요. 표준 생성 과정에 별도의 MERT2 다운로드는 필요하지 않습니다.
공식 Python 파이프라인 설치
문서의 시작 환경은 Linux, Python 3.12, BF16을 지원하는 VRAM 24GB NVIDIA GPU입니다. 준비가 되었다면 다음 명령을 실행합니다.
git clone https://github.com/multimodal-art-projection/YuE.git
cd YuE
python3.12 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install .
python examples/generate.py --output outputs/first-song첫 실행에서 Hugging Face 모델 파일을 받습니다. 이 다운로드 시간과 추론 시간은 구분해서 보세요. 명령은 공식 빠른 시작 문서를 따르며, 이 사이트에서 추론 성능을 직접 측정한 것은 아닙니다.
오디오와 생성 기록 함께 확인하기
outputs/first-song/audio.flac를 열어 들어 보세요. 악보, 설정, 중간 파일이 들어 있는 나머지 출력 폴더도 보관해야 나중에 비교하거나 편집할 수 있습니다.
result.json의 잘림 여부를 확인하세요. 재생 가능한 파일도 토큰 한도에 도달해 중간에 끝난 결과일 수 있습니다. 요청을 바꿀 때마다 새 출력 폴더를 사용하세요.
버전을 맞춰 두기
재현 가능한 실험을 원한다면 저장소와 모델 리비전을 고정하세요. 런타임, 디코더, 샘플링 설정이 바뀌면 같은 시드에서도 결과가 달라질 수 있습니다.
초기 YuE의 코드와 문서는 YuE-v1 브랜치에 있습니다. 해당 버전의 설명이나 라이선스를 YuE2에 그대로 적용하지 마세요. 시각적인 인터페이스를 원한다면 ComfyUI 가이드로 이어가세요.
출처와 참고 자료
연결된 공식 문서를 기준으로 작성했습니다. 자체 하드웨어 추론 벤치마크는 진행하지 않았습니다.