README.md

---
license: mit
language:
  - ko
tags:
  - tts
  - melotts
  - onnx
  - korean
  - on-device
  - android
library_name: onnxruntime
pipeline_tag: text-to-speech
base_model: myshell-ai/MeloTTS-Korean
---

# MeloTTS Korean — ONNX

[MeloTTS](https://github.com/myshell-ai/MeloTTS) Korean 체크포인트를 ONNX 로 변환하고 양자화한 배포본입니다. Android/iOS/서버 ONNX Runtime 환경에서 바로 사용할 수 있도록 FP32 / FP16 / INT8 세 가지를 제공합니다.

## 파일

| 파일 | dtype | 용도 | 크기 (참고) |
|---|---|---|---|
| `melotts_kr_fp32.onnx` | FP32 | 기준 정확도, 서버 | ~ 170 MB |
| `melotts_kr_fp16.onnx` | FP16 | GPU / NPU | ~ 85 MB |
| `melotts_kr_int8.onnx` | INT8 (dynamic) | CPU / Android 온디바이스 | ~ 45 MB |

## 입력 스펙

| 이름 | shape | dtype | 비고 |
|---|---|---|---|
| `x` | `[1, T]` | int64 | g2p 토큰 시퀀스 |
| `x_lengths` | `[1]` | int64 | 실제 토큰 길이 |
| `sid` | `[1]` | int64 | 화자 ID (KR 기본 0) |
| `tone` | `[1, T]` | int64 | tone ID (KR 은 0) |
| `language` | `[1, T]` | int64 | language ID |
| `bert` | `[1, 1024, T]` | float32 | KR 은 zero tensor |
| `ja_bert` | `[1, 768, T]` | float32 | KR 은 zero tensor |
| `noise_scale` | scalar | float32 | 기본 0.6 |
| `length_scale` | scalar | float32 | 기본 1.0 |
| `noise_scale_w` | scalar | float32 | 기본 0.8 |
| `sdp_ratio` | scalar | float32 | 기본 0.2 |

## 출력

| 이름 | shape | dtype |
|---|---|---|
| `audio` | `[audio_length]` | float32 (waveform, sr=44100) |

## 빠른 시작

```python
import onnxruntime as ort
import numpy as np

sess = ort.InferenceSession("melotts_kr_int8.onnx", providers=["CPUExecutionProvider"])
# 전처리 (g2p) 는 MeloTTS 원본 파이프라인 재사용 필요
audio = sess.run(None, {
    "x": x,
    "x_lengths": x_lengths,
    "sid": np.array([0], dtype=np.int64),
    ...
})[0]
```

## 라이선스

원본 MeloTTS 라이선스(MIT) 를 따릅니다.

## 변환 스크립트

[github.com/geunyong-dev/... (업로드 후 링크 교체)](#)