로컬 음성 인식·합성
최종 업데이트
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를 만드는 경로예요.
텍스트에서 한국어 음성을 생성해요
VoxCPM2는 OpenBMB의 2B 파라미터 TTS4 모델이에요. 모델 카드에 따르면 한국어·영어·일본어 등을 포함한 30개 언어의 음성을 만들고, 출력은 48 kHz예요. 문장을 넣어 재생 가능한 오디오 파일을 만들 때 사용할 수 있어요. VoxCPM2 모델 카드

CUDA와 VRAM 요구 조건을 먼저 맞춰요
첫 문장을 생성하고 WAV를 저장해요
짧은 한국어 문장을 합성해 korean.wav로 저장해요. 아래 코드를 작업 폴더의 generate.py로 저장하고 python generate.py로 실행하세요. 출력 파일은 같은 폴더에 생깁니다.
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)python generate.py
공개 RTF와 내 작업 시간을 따로 봐요
카드의 실측 속도는 RTX 4090이나 Nano-VLLM처럼 구체적인 장비와 실행 설정에 한정돼요. 모델을 처음 불러오는 시간, 첫 문장 지연, 긴 글 처리 시간은 각각 다르게 체감될 수 있어요. 길이가 일정한 원고를 두세 개 준비해 장비에서 직접 재고, 결과 음질과 시간을 함께 비교하세요.
라이선스와 사용 목적을 확인해요
모델 카드와 저장소는 Apache 2.0 라이선스를 표시해요. 배포하려는 코드와 가중치의 사용 조건을 확인하고, 생성 음성을 공개·상업적으로 사용할 때는 관련 정책과 음성 권리를 별도로 점검하세요. 개인 목소리 복제나 타인의 음성 사용은 명시적인 허가가 있는 경우에만 진행하세요.

용어 각주
CPU — 운영체제와 일반 프로그램 명령을 실행하고, AI에서는 전처리·데이터 이동 등 범용 연산을 맡는 중앙 처리 장치입니다.
본문으로 돌아가기CUDA — NVIDIA GPU에서 범용 계산을 실행하기 위한 소프트웨어 플랫폼입니다.
본문으로 돌아가기API — 프로그램의 기능을 다른 코드에서 호출하기 위한 약속된 인터페이스입니다.
본문으로 돌아가기음성 합성 — 텍스트를 발음과 운율을 가진 음성 신호로 변환하는 기술입니다.
본문으로 돌아가기PyTorch — AI 모델을 만들고 실행하는 소프트웨어 프레임워크입니다. 모델과 함께 호환되는 PyTorch 버전 및 하드웨어 지원도 확인해야 합니다.
본문으로 돌아가기VRAM — 그래픽카드의 GPU가 사용하는 메모리입니다. 모델 가중치와 계산 중간값을 저장합니다.
본문으로 돌아가기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)
