# Qwen3-TTS 1.7B CustomVoice (음성 모델)

> Qwen3-TTS 1.7B CustomVoice: 10개 언어에서 9가지 내장 음성과 감정·말투 지시("Excited, fast", "Whispering, sad")를 지원하는 텍스트 음성 변환으로, NPC 대사와 내레이션에 알맞습니다. audio.cpp로 여러분의 GPU에서 로컬로 실행됩니다. Apache-2.0, 상업적 사용 가능.

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

## 설치

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

```bash
gamedev pkg add aigd.audio-qwen3-tts-1-7b-customvoice
```

데스크톱 앱에서 Packages 창을 열고(상태 표시줄의 패키지 아이콘) **Browse**를 선택한 뒤 `aigd.audio-qwen3-tts-1-7b-customvoice`를 검색하고 **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
# Qwen3-TTS 1.7B CustomVoice (`aigd.audio-qwen3-tts-1-7b-customvoice`)

Qwen3-TTS 1.7B CustomVoice는 Alibaba Cloud의 Qwen3-TTS 계열 가운데 내장 음성 모델입니다. 10개 언어로 된 9가지 음성이 준비되어 있고, "Excited, fast"나 "Whispering, sad" 같은 감정 및 말투 지시를 쓸 수 있습니다. 녹음은 필요 없습니다. AI Game Dev 앱에서는 **Local audio generation**(`aigd.audiocpp`, audio.cpp 런타임)을 통해 GPU에서 로컬로 실행되므로 대사 한 줄에 비용이 들지 않습니다. 상업적 사용이 허용되는 Apache-2.0 조건에서, 표현력 있는 NPC 음성을 빠르게 만들고 싶은 게임 개발자에게 적합합니다.

## 무엇을 만들 수 있나요

- 캐릭터마다 다른 내장 음성으로 하는 NPC 대사.
- 스토리 장면을 위한 감정 표현: 흥분, 기쁨, 슬픔, 속삭임, 빠르게 또는 느리게.
- 내레이션, 튜토리얼 음성 안내, 아나운서 대사.
- 현지화 빌드를 위한 10개 언어 대사.

## 요청 예시

- "Ryan이 '당장 여기서 나가야 해!'라고 겁먹고 빠르게 말하게 해줘."
- "Serena가 `dialogue/intro.txt`의 인트로 내레이션을 차분하고 따뜻하게 읽게 해줘."
- "Ono_Anna가 일본어로 명랑하게 플레이어에게 인사하게 해줘."
- "악당 대사 '너는 너무 늦었어'를 Aiden에게 — 속삭이듯, 위협적으로."

## 주요 특징

| 항목 | 값 |
|---|---|
| 음성 | Vivian, Serena, Uncle_Fu, Dylan, Eric, Ryan, Aiden, Ono_Anna, Sohee (기본값 Ryan) |
| 감정 및 말투 | "Very happy", "Whispering, sad", "Fast and excited" 같은 지시 |
| 언어 | 중국어, 영어, 일본어, 한국어, 독일어, 프랑스어, 러시아어, 포르투갈어, 스페인어, 이탈리아어 |
| 출력 | 24 kHz 모노 WAV, 프로젝트에 저장됨 |
| 요청당 텍스트 | 최대 600자(영어 음성 기준 약 40초). 더 긴 텍스트는 순서대로 나눈 세그먼트로 처리합니다. |
| 재현 가능 | 시드를 지정하면 같은 결과가 나옵니다 |

Dylan은 중국어에서 베이징 억양으로, Eric은 쓰촨 억양으로 말합니다. 모델이 텍스트의 언어를 스스로 감지하며, 언어 설정은 참고용입니다.

이 패키지는 데이터만 담고 있습니다. 모델 파일 이름을 지정할 뿐입니다. 앱이 확인을 받은 뒤 파일을 다운로드하고, sha256으로 검증한 다음, 여러분의 컴퓨터에서 audio.cpp로 실행합니다.

## 어떤 Qwen3-TTS 패키지를 골라야 할까요

네 가지 모두 같은 런타임으로 실행되고, 같은 10개 언어를 말하며, 24 kHz 모노 WAV로 출력합니다. 차이는 음성을 고르는 방식입니다:

| 패키지 | 음성 선택 방식 | 감정 지시 | 다운로드 | GPU 메모리 (추정) |
|---|---|---|---:|---|
| [Qwen3-TTS 0.6B Base](https://ai-game.dev/packages/aigd.audio-qwen3-tts-0-6b-base) | 참조 클립 (복제) | 없음 | 1.99 GB | 약 4 GB |
| [Qwen3-TTS 1.7B Base](https://ai-game.dev/packages/aigd.audio-qwen3-tts-1-7b-base) | 참조 클립 (복제) | 없음 | 2.70 GB | 약 6 GB |
| [Qwen3-TTS 1.7B CustomVoice](https://ai-game.dev/packages/aigd.audio-qwen3-tts-1-7b-customvoice) | 내장 음성 9가지 | yes | 2.82 GB | 약 6 GB |
| [Qwen3-TTS 1.7B VoiceDesign](https://ai-game.dev/packages/aigd.audio-qwen3-tts-1-7b-voicedesign) | 음성에 대한 텍스트 설명 | 있음, 설명에 포함 | 2.82 GB | 약 6 GB |

- 실제 음성 복제(본인 또는 동의를 받은 성우): GPU가 작으면 **0.6B Base**, GPU 메모리가 약 6 GB라면 **1.7B Base**.
- 준비된 음성을 쓰고 감정을 조절: **1.7B CustomVoice**.
- 말로만 새로운 캐릭터 음성을 만들기: **1.7B VoiceDesign**.

## 다운로드

2.82 GB, 파일 1개, Hugging Face 커밋에 고정:

| 파일 | 출처 | 크기 |
|---|---|---:|
| `qwen3-tts-12hz-1.7b-customvoice-q8_0.gguf` (talker와 12 Hz 음성 코덱이 한 파일에) | [`audio-cpp/audio.cpp-gguf`](https://huggingface.co/audio-cpp/audio.cpp-gguf/tree/b7b9aa1f16c819c3b2d69a602b51786bdfb361a3/Qwen3-TTS-12Hz-1.7B-CustomVoice-GGUF) @ `b7b9aa1f` | 2.82 GB |

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

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

메모리 수치는 파일 크기와 Qwen의 원본 모델 수치를 바탕으로 한 추정치이며, 출시 전에 실제 GPU에서 확인합니다.

## 라이선스

Apache-2.0. 모델과 모델이 생성한 음성의 상업적 사용이 허용됩니다.

- Qwen3-TTS-12Hz-1.7B-CustomVoice © Qwen team, Alibaba Cloud — [모델 카드](https://huggingface.co/Qwen/Qwen3-TTS-12Hz-1.7B-CustomVoice) (`license: apache-2.0`), [라이선스 전문](https://www.apache.org/licenses/LICENSE-2.0).
- Qwen3-TTS-Tokenizer-12Hz (GGUF 파일 안에 포함된 음성 코덱) © Qwen team — [모델 카드](https://huggingface.co/Qwen/Qwen3-TTS-Tokenizer-12Hz), Apache-2.0.
- GGUF 패키징: [`audio-cpp/audio.cpp-gguf`](https://huggingface.co/audio-cpp/audio.cpp-gguf) — 저장소 카드에는 Qwen3-TTS GGUF 패키지가 Apache-2.0으로 명시되어 있으며, 원본 모델 라이선스의 적용을 받습니다.

가중치를 재배포할 때 필요한 저작자 표시: Qwen3-TTS의 Apache-2.0 라이선스 전문과 그 고지 사항을 유지해야 합니다. 생성한 음성에는 저작자 표시가 필요하지 않습니다.

제한 사항을 분명히 하면: 위의 고지 요구 사항 외에 라이선스상 제한은 없습니다 — 지역 제한도, 매출 상한도, 워터마크도 없습니다. 생성한 결과에 대한 책임은 사용자에게 있습니다.

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