# MOSS-SoundEffect v2 (효과음 모델)

> OpenMOSS의 MOSS-SoundEffect v2: 영어 또는 중국어 설명으로 자연, 도시, 생물, 사람 행동 등의 효과음과 앰비언스를 1~30초, 48 kHz 모노로 만들어 게임 레벨과 장면에 씁니다. audio.cpp로 로컬 GPU에서 실행됩니다. Apache-2.0(모델 카드 기준), 상업적 사용 가능.

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

## 설치

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

```bash
gamedev pkg add aigd.audio-moss-soundeffect-v2
```

데스크톱 앱에서 Packages 창을 열고(상태 표시줄의 패키지 아이콘) **Browse**를 선택한 뒤 `aigd.audio-moss-soundeffect-v2`를 검색하고 **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
# MOSS-SoundEffect v2 (`aigd.audio-moss-soundeffect-v2`)

MOSS-SoundEffect v2.0은 OpenMOSS 팀이 2026-05-26에 공개한 효과음 모델입니다. 영어 또는 중국어 설명으로 앰비언스, 자연, 도시, 생물, 사람 행동 소리를 만듭니다: 48 kHz 모노 오디오로 1~30초 분량입니다. AI Game Dev 앱에서는 **Local audio generation**(`aigd.audiocpp`, audio.cpp 런타임)을 통해 로컬 GPU에서 실행되므로 사운드 하나에 비용이 들지 않습니다. 환경음과 생물 또는 캐릭터 소리가 필요한 게임 개발자에게 적합하며, Apache-2.0(게시자가 태그한 기준)으로 상업적 사용이 허용됩니다.

## 무엇을 만들 수 있나요

- 레벨용 앰비언스 베드. 숲, 비, 번화가 같은 것입니다.
- 오픈 월드와 도시를 위한 자연 환경과 도심 장면.
- 동물과 생물 소리. 개 짖는 소리나 몬스터의 으르렁거림 같은 것입니다.
- 사람의 행동. 발소리나 문 열리는 소리 같은 것입니다.

짧은 임팩트, UI 사운드, 스테레오 폴리 사운드는 [Stable Audio 3 Small SFX](https://ai-game.dev/packages/aigd.audio-stable-audio-3-small-sfx)를 참고하세요.

## 요청 예시

- "귀뚜라미 소리와 멀리서 우는 부엉이가 있는 밤 숲 앰비언스를 30초 만들어 주세요."
- "깊은 몬스터의 으르렁거림을 3초 정도 생성해 주세요."
- "젖은 자갈 위 발소리를 5초, 음악 없이 만들어 주세요."
- "마을 광장을 위한 번화한 중세 시장 군중 앰비언스를 만들어 주세요."

## 주요 특징

| 항목 | 값 |
|---|---|
| 출력 | 48 kHz 모노 WAV, 프로젝트에 저장됨 |
| 길이 | 1~30초 (기본 10초) |
| 입력 | 영어 또는 중국어 설명, 최대 1,000자 |
| 부정 프롬프트 | 피해야 할 내용에 대한 설명, 최대 1,000자 (선택) |
| 스텝 | 기본 100, 최대 200 |
| 가이던스 | 기본 4 |
| 시드 | 기본 0, 시드로 결과를 반복할 수 있습니다 |

이 패키지는 데이터만 담고 있습니다. 파일 하나를 지정합니다. 앱이 확인을 받은 뒤 내려받고, sha256으로 검증한 다음, 사용자의 컴퓨터에서 audio.cpp로 실행합니다.

## 다운로드

4.00 GB, 파일 하나, Hugging Face 커밋 `b7b9aa1f`에 고정:

| 파일 | 출처 | 크기 |
|---|---|---:|
| `moss-soundeffect-v2-q8_0.gguf` (Qwen3 텍스트 인코더, DiT, DAC 디코더가 한 파일에 포함) | [`audio-cpp/audio.cpp-gguf`](https://huggingface.co/audio-cpp/audio.cpp-gguf/tree/b7b9aa1f16c819c3b2d69a602b51786bdfb361a3/MOSS-SoundEffect-v2-GGUF) | 4.00 GB |

`e35df4d`에서 [`OpenMOSS-Team/MOSS-SoundEffect-v2.0`](https://huggingface.co/OpenMOSS-Team/MOSS-SoundEffect-v2.0/tree/e35df4d82fbe87fcd5d14e5d100e349c0c3c076d)에서 변환했습니다.

## 어떤 컴퓨터에서 실행되나요

| 컴퓨터 | 필요 사양 | 속도 |
|---|---|---|
| NVIDIA GPU (CUDA) | 약 10 GB의 GPU 메모리 (업스트림: 최대 8.6 GiB) | 약 실시간 (RTX 5090에서 RTF 0.85, 업스트림 기준) |
| 다른 GPU (Vulkan) | 약 10 GB (추정) | 아직 측정되지 않음 |
| Apple silicon Mac (Metal) | 약 16 GB의 메모리 (추정) | 아직 측정되지 않음 |

모든 요청이 모델의 30초 전체 윈도우를 실행하므로, 짧은 소리도 긴 소리와 비슷한 시간이 걸립니다.

## 라이선스

Apache-2.0, **게시자가 태그한 기준**. 상업적 사용이 허용됩니다.

- MOSS-SoundEffect v2.0 © OpenMOSS team — [모델 카드](https://huggingface.co/OpenMOSS-Team/MOSS-SoundEffect-v2.0) (`license: apache-2.0`). 모델 저장소에는 **LICENSE 파일이 없습니다**: 라이선스는 카드의 태그에만 명시되어 있습니다. Apache-2.0 전문은 [OpenMOSS/MOSS-TTS 코드 저장소](https://github.com/OpenMOSS/MOSS-TTS/blob/main/LICENSE)에 있습니다.
- 텍스트 인코더는 Qwen3 모델(Apache-2.0)이며, GGUF 파일 안에 포함되어 있습니다.
- GGUF 변환: audio.cpp — [`audio-cpp/audio.cpp-gguf`](https://huggingface.co/audio-cpp/audio.cpp-gguf), Apache-2.0.

가중치를 재배포할 때 필요한 저작자 표시: Apache-2.0 라이선스 전문과 고지 사항.

제한 사항을 분명히 하면: 고지 사항 외에 라이선스에 제한은 없으며, LICENSE 파일이 없다는 점이 유일한 유의 사항입니다.

모든 파일은 Hugging Face에서 내려받습니다. AI Game Dev는 파일을 호스팅하지 않습니다.
````
