# ACE-Step 1.5 (음악 모델)

> ACE-Step 1.5 Turbo 음악 모델: 스타일 프롬프트(장르, 분위기, 악기, 템포)와 선택적 가사로 보컬이 있는 곡 또는 연주곡을 50개 언어로 만들 수 있으며, 10초에서 10분까지, 48 kHz 스테레오로 게임 테마와 사운드트랙에 적합합니다. audio.cpp로 GPU에서 로컬 실행됩니다. MIT 라이선스, 상업적 사용 허용.

- Id: `aigd.audio-ace-step-1-5`
- 소스: 공식 (자사 `aigd.*`)
- 카테고리: 오디오
- 게시자: AI Game Dev (`aigd`), 인증됨
- 최신 버전: 1.0.2 (2026-11-22 게시)
- 라이선스: MIT
- AI Game Dev 앱 필요: `>=0.32.0-beta.6`
- 네이티브 코드: 아니요
- 평점: 아직 평가 없음
- HTML 페이지: https://ai-game.dev/ko/packages/aigd.audio-ace-step-1-5

## 설치

gamedev CLI를 사용한다면 프로젝트 폴더에서:

```bash
gamedev pkg add aigd.audio-ace-step-1-5
```

데스크톱 앱에서 Packages 창을 열고(상태 표시줄의 패키지 아이콘) **Browse**를 선택한 뒤 `aigd.audio-ace-step-1-5`를 검색하고 **Add to Project**를 클릭합니다. 자세히: https://ai-game.dev/docs/wiki/app/packages

## 버전

| 버전 | 게시일 | 앱 필요 | 참고 |
|---|---|---|---|
| 1.0.2 | 2026-11-22 | `>=0.32.0-beta.6` | 최신 |
| 1.0.1 | 2026-11-21 | `>=0.32.0-beta.6` | - |

## 설명

````markdown
# ACE-Step 1.5 (`aigd.audio-ace-step-1-5`)

ACE-Step 1.5는 ACE Studio와 StepFun이 만든 공개 음악 생성 모델입니다. 스타일 프롬프트(장르, 분위기, 악기, 템포)와 선택적 가사로 보컬이 있는 노래 또는 연주곡을 50개 언어로 작성합니다: 10초에서 10분, 48 kHz 스테레오. AI Game Dev 앱에서는 **로컬 오디오 생성**(`aigd.audiocpp`, audio.cpp 런타임)을 통해 GPU에서 로컬로 실행되므로 트랙당 음악 제작 비용이 들지 않습니다. 상업적 사용을 허용하는 MIT 라이선스 아래 사운드트랙 곡, 보컬 타이틀 테마 또는 긴 연주곡을 원하는 게임 개발자에게 적합합니다.

## 만들 수 있는 것

- 보컬이 있거나 없는 타이틀 및 메뉴 테마.
- 트레일러, 크레딧, 게임 내 라디오 방송국 또는 스토리 장면을 위한 자작 가사가 있는 노래.
- 레벨용 긴 연주 배경 음악으로, 곡당 10초에서 최대 10분까지.
- 게임의 현지화 버전을 위한 다른 언어의 노래(50개 언어 가사).

## 요청 예시

- "메인 메뉴용 2분 길이의 경쾌한 칩튠 연주곡을 만들어 주세요."
- "엔딩 크레딧용으로 여성 보컬이 있는 우울한 피아노 발라드를 다음 가사로 써 주세요: ..."
- "합창과 묵직한 드럼이 들어간 3분 길이의 오케스트라 전투 테마를 생성해 주세요."
- "게임 내 라디오용으로 약 90초 길이의 일본 시티팝 노래를 만들어 주세요."

## 주요 특징

| 사양 | 값 |
|---|---|
| 출력 | 48 kHz 스테레오 WAV, 프로젝트에 저장됨 |
| 길이 | 10초~10분(기본 30초) |
| 입력 | 스타일 프롬프트(최대 512자) 및 선택적 가사(최대 4,096자) |
| 가사 언어 | 50개 언어(영어, 중국어, 일본어, 한국어, 스페인어, 독일어, 프랑스어, 포르투갈어, 러시아어 포함) |
| 변형 | Turbo: 최대 8회 디노이징 단계(기본 8) |
| 재현 가능 | 시드를 사용하면 결과를 재현할 수 있음 |

- Turbo 변형은 가이던스(CFG)를 무시하므로 앱에서 해당 설정을 제공하지 않습니다.
- 스타일 프롬프트는 최대 256토큰, 가사는 최대 2048토큰까지 읽습니다(업스트림과 audio.cpp 모두). 나머지는 경고 없이 잘립니다. 영어 가사 4096자는 들어가지만, 같은 길이의 중국어, 일본어 또는 한국어 가사는 뒷부분이 잘릴 수 있습니다.

이 패키지는 데이터만 포함합니다. 모델 파일 이름을 지정합니다. 앱은 사용자가 확인한 후 파일을 다운로드하고 sha256으로 검사한 뒤 사용자의 컴퓨터에서 audio.cpp로 실행합니다.

## 다운로드

10.09 GB, 파일 하나, Hugging Face 커밋에 고정:

| 파일 | 출처 | 크기 |
|---|---|---:|
| `ace-step-1.5-turbo-bf16.gguf` (DiT, 5 Hz LM 플래너, 텍스트 인코더 및 VAE가 하나의 파일에 포함) | [`audio-cpp/audio.cpp-gguf`](https://huggingface.co/audio-cpp/audio.cpp-gguf/tree/b7b9aa1f16c819c3b2d69a602b51786bdfb361a3/ACE-Step1.5-GGUF/turbo) @ `b7b9aa1f` | 10.09 GB |

bf16 파일은 의도적으로 사용합니다: audio.cpp는 완전히 양자화된 q8_0 ACE-Step 패키지를 "플래너 샘플링이 실패할 수 있음"으로 평가하며(해당 `docs/gguf.md`), 따라서 q8_0 파일은 관련 없는 곡을 반환할 수 있습니다.

## 지원 컴퓨터

| 컴퓨터 | 필요 사양 | 속도 |
|---|---|---|
| NVIDIA GPU(CUDA) 또는 다른 GPU(Vulkan) | GPU 메모리 약 16 GB(추정) | 아직 측정되지 않음 |
| Apple silicon Mac(Metal) | 메모리 약 24 GB(추정) | 아직 측정되지 않음 |

메모리 수치는 추정치이며 출시 전에 실제 GPU에서 확인합니다. 가중치만 9.4 GiB이고, audio.cpp 자체 보고서에서는 같은 가중치 크기의 XL 패키지를 5초 클립으로 실행할 때 최대 14.4–15.8 GiB로 측정합니다. Mac GPU는 통합 메모리의 일부만 사용할 수 있어 수치가 더 큽니다. audio.cpp는 Metal에서 ACE-Step을 검증하지 않았습니다. ACE-Step 자체의 "4 GB 미만" 수치는 CPU 오프로드를 사용하는 공식 PyTorch 파이프라인에 대한 것이며, 이 런타임에 대한 것이 아닙니다.

더 큰 ACE-Step 1.5 XL(4B)은 이 패키지에 없습니다: 공식 `audio-cpp` 저장소는 고정된 리비전에서 XL GGUF를 게시하지 않습니다(audio.cpp 설치 프로그램은 타사 저장소에서 XL을 가져옵니다).

## 라이선스

MIT. 모델과 모델이 생성한 음악의 상업적 사용이 허용됩니다.

- ACE-Step 1.5 (DiT, 5 Hz LM 플래너, VAE) © 2026 ACEStep — [MIT 라이선스](https://github.com/ace-step/ACE-Step-1.5/blob/910a4dd82aa663925451d0b161a32d21d92ac297/LICENSE); [모델 카드](https://huggingface.co/ACE-Step/Ace-Step1.5) (`license: mit`), ACE Studio와 StepFun이 공동 주도.
- 5 Hz LM 플래너는 Qwen3-1.7B © Alibaba Cloud(Qwen 팀)에서 파인튜닝되었습니다 — [모델 카드](https://huggingface.co/Qwen/Qwen3-1.7B), Apache-2.0.
- 텍스트 인코더 Qwen3-Embedding-0.6B © Alibaba Cloud(Qwen 팀) — [모델 카드](https://huggingface.co/Qwen/Qwen3-Embedding-0.6B), Apache-2.0.
- GGUF 변환: [`audio-cpp/audio.cpp-gguf`](https://huggingface.co/audio-cpp/audio.cpp-gguf) — 해당 카드(`license: other`)에 따르면 각 GGUF는 원본 모델의 라이선스를 따릅니다. `ACE-Step1.5-GGUF`의 경우 MIT입니다.

네 부분 모두 하나의 GGUF 파일 안에 포함되어 있습니다.

가중치를 재배포할 때 필요한 저작자 표시: MIT 저작권 고지 "Copyright (c) 2026 ACEStep"와 Qwen3-1.7B 및 Qwen3-Embedding-0.6B의 Apache-2.0 라이선스와 고지를 유지하십시오. 생성한 음악에는 저작자 표시가 필요하지 않습니다.

제한 사항을 분명히 말하면:

- 두 라이선스 모두 지역 제한, 매출 상한, 워터마크가 없습니다.
- ACE-Step의 README("라이선스 및 면책 고지")는 사용 약관을 추가합니다: ACE-Step을 사용함으로써 생성물이 독창적인지 확인하고, AI가 관여했음을 명확히 밝히며, 보호된 스타일이나 자료를 각색하기 전에 허가를 받는 데 동의하게 됩니다.
- 생성하는 것에 대한 책임은 사용자에게 있습니다(예: 실제 아티스트를 모방한 가사나 스타일).

모든 파일은 Hugging Face에서 다운로드됩니다. AI Game Dev는 파일을 호스팅하지 않습니다.
````
