로컬 음성 인식·합성

최종 업데이트

VoxCPM2로 한국어 음성 만들기: 30개 언어 TTS

한국어를 포함한 30개 언어를 생성하는 2B TTS 모델이에요.

VoxCPM2는 텍스트를 48 kHz 음성으로 만드는 2B 모델로 한국어·일본어를 포함한 30개 언어를 지원해요. 공식 저장소의 Web Demo는 CPU1, Apple MPS, CUDA2를 지원하며 Apple Silicon에서 --device auto는 MPS를 선택해요. 아래 Python 예제는 패키지 API3로 첫 WAV를 만드는 경로예요.

실행 조건과 핵심 내용
  • 한국어를 포함한 30개 언어와 48 kHz 오디오를 지원해요.
  • 공식 안내는 Python 3.10+, PyTorch 2.5+, CUDA 12+와 약 8GB VRAM을 제시해요.
  • 공개 모델과 코드의 Apache 2.0 조건을 확인해요.

텍스트에서 한국어 음성을 생성해요

VoxCPM2는 OpenBMB의 2B 파라미터 TTS4 모델이에요. 모델 카드에 따르면 한국어·영어·일본어 등을 포함한 30개 언어의 음성을 만들고, 출력은 48 kHz예요. 문장을 넣어 재생 가능한 오디오 파일을 만들 때 사용할 수 있어요. VoxCPM2 모델 카드

펼쳐진 책과 작은 컴퓨터, 스피커가 놓인 책상
합성할 한국어 문장을 정하고 화자 음색을 들어봐요.

CUDA와 VRAM 요구 조건을 먼저 맞춰요

모델 카드의 예제는 Python 3.10 이상, PyTorch5 2.5 이상, CUDA 12 이상과 약 8GB VRAM6을 기준으로 안내해요. 가상환경7에 패키지를 설치하고 CUDA를 쓸 경우 PyTorch 페이지에서 CUDA 버전에 맞는 wheel을 고르세요.

공식 패키지 설치
python -m pip install voxcpm soundfile

첫 문장을 생성하고 WAV를 저장해요

짧은 한국어 문장을 합성해 korean.wav로 저장해요. 아래 코드를 작업 폴더의 generate.py로 저장하고 python generate.py로 실행하세요. 출력 파일은 같은 폴더에 생깁니다.

generate.py에서 한국어 WAV 합성
import soundfile as sf
from voxcpm import VoxCPM

model = VoxCPM.from_pretrained("openbmb/VoxCPM2")
audio = model.generate(text="오늘 회의는 오후 두 시에 시작합니다.")
sf.write("korean.wav", audio, model.tts_model.sample_rate)
generate.py 실행
python generate.py
마이크와 헤드폰, 파형이 표시된 모니터가 있는 작업대
WAV 출력에서 발음과 문장 끝을 확인해요.

공개 RTF와 내 작업 시간을 따로 봐요

카드의 실측 속도는 RTX 4090이나 Nano-VLLM처럼 구체적인 장비와 실행 설정에 한정돼요. 모델을 처음 불러오는 시간, 첫 문장 지연, 긴 글 처리 시간은 각각 다르게 체감될 수 있어요. 길이가 일정한 원고를 두세 개 준비해 장비에서 직접 재고, 결과 음질과 시간을 함께 비교하세요.

라이선스와 사용 목적을 확인해요

모델 카드와 저장소는 Apache 2.0 라이선스를 표시해요. 배포하려는 코드와 가중치의 사용 조건을 확인하고, 생성 음성을 공개·상업적으로 사용할 때는 관련 정책과 음성 권리를 별도로 점검하세요. 개인 목소리 복제나 타인의 음성 사용은 명시적인 허가가 있는 경우에만 진행하세요.

헤드폰과 오디오 플레이어, 펼쳐진 노트가 놓인 책상
설치 전에 VRAM과 CUDA 조건을 맞춰요.

용어 각주

  1. CPU — 운영체제와 일반 프로그램 명령을 실행하고, AI에서는 전처리·데이터 이동 등 범용 연산을 맡는 중앙 처리 장치입니다.

    본문으로 돌아가기
  2. CUDA — NVIDIA GPU에서 범용 계산을 실행하기 위한 소프트웨어 플랫폼입니다.

    본문으로 돌아가기
  3. API — 프로그램의 기능을 다른 코드에서 호출하기 위한 약속된 인터페이스입니다.

    본문으로 돌아가기
  4. 음성 합성 — 텍스트를 발음과 운율을 가진 음성 신호로 변환하는 기술입니다.

    본문으로 돌아가기
  5. PyTorch — AI 모델을 만들고 실행하는 소프트웨어 프레임워크입니다. 모델과 함께 호환되는 PyTorch 버전 및 하드웨어 지원도 확인해야 합니다.

    본문으로 돌아가기
  6. VRAM — 그래픽카드의 GPU가 사용하는 메모리입니다. 모델 가중치와 계산 중간값을 저장합니다.

    본문으로 돌아가기
  7. Python 가상환경 — 프로젝트별로 Python 패키지를 분리해 설치하는 공간입니다. 패키지 버전 충돌을 줄이는 데 쓰입니다.

    본문으로 돌아가기

자주 묻는 질문

이 글에서 가장 먼저 확인할 것은 무엇인가요?
VoxCPM2는 텍스트를 48 kHz 음성으로 만드는 2B 모델로 한국어·일본어를 포함한 30개 언어를 지원해요. 공식 저장소의 Web Demo는 CPU, Apple MPS, CUDA를 지원하며 Apple Silicon에서 `--device auto`는 MPS를 선택해요. 아래 Python 예제는 패키지 API로 첫 WAV를 만드는 경로예요.
필요한 메모리는 어느 정도인가요?
모델 카드의 예제는 Python 3.10 이상, PyTorch 2.5 이상, CUDA 12 이상과 약 8GB VRAM을 기준으로 안내해요. 가상환경에 패키지를 설치하고 CUDA를 쓸 경우 PyTorch 페이지에서 CUDA 버전에 맞는 wheel을 고르세요.
조건과 출처는 어디서 확인하나요?
VoxCPM2는 OpenBMB의 2B 파라미터 TTS 모델이에요. 모델 카드에 따르면 한국어·영어·일본어 등을 포함한 30개 언어의 음성을 만들고, 출력은 48 kHz예요. 문장을 넣어 재생 가능한 오디오 파일을 만들 때 사용할 수 있어요. [VoxCPM2 모델 카드](https://huggingface.co/openbmb/VoxCPM2)