Hailuo 음성 합성 (Text-to-Speech)¶

1. 개요 (Overview)¶

Hailuo AI는 중국의 Minimax에서 개발한
고품질 클라우드 기반 음성 합성(TTS) 서비스입니다.
자연스러운 발음, 다국어 지원, 감정 표현이 특징이며
VoiceScriptPlayer에서는 AI 캐릭터 음성 생성, 자막 동기화 등
창작 중심의 음성 제작 환경을 제공합니다.

⚠️ 중요:
Hailuo의 API 요금제와 일반 웹 요금제는 별도로 운영됩니다.
API 기능은 무료로 이용할 수 없으며,
반드시 Minimax의 API 플랜을 별도로 구독해야 합니다.
구독 후에는 Hailuo 구독 관리 페이지에서
남은 코인(사용량) 을 확인할 수 있습니다.

📘 구독이 처음이신가요?
➡ Hailuo 구독 및 결제 가이드 보기

2. VoiceScriptPlayer에서의 사용 방법¶

hailuo-editor

VoiceScriptPlayer의 Audio Editor에서는
Hailuo 엔진을 이용해 텍스트를 바로 음성으로 합성할 수 있습니다.
COEIROINK와 동일한 UI 구조를 가지며, 여러 문장을 동시에 합성하거나
각 문장의 길이·타이밍을 타임라인에서 조정할 수 있습니다.

🗣️ 기본 사용 흐름¶

TextToSpeech 엔진 선택
상단 드롭다운에서 Hailuo AI를 선택합니다.
API 키가 올바르게 등록되어 있다면 자동으로 연결됩니다.
문장 입력
상단의 타임라인 또는 텍스트 입력창에 여러 문장을 입력합니다.
각 문장은 독립된 블록으로 표시되며, 순서 및 길이를 자유롭게 조정할 수 있습니다.

기본 음성 설정

항목	설명
언어	사용할 언어를 선택합니다. (한국어, 일본어, 영어 등)
음성	사용할 보이스 프로필 (예: Thoughtful Woman, Gentle Male 등)
감정	말투 또는 톤 (일반, 부드러움, 활기참 등)
배속	말하는 속도 (기본값 1.0)
피치	목소리의 높낮이
볼륨	전체 음성 크기 조절

후처리 옵션 (선택 사항)
피치, 강도, 음색 등을 미세 조정할 수 있습니다.
발음 사전 기능을 통해 특정 단어나 이름의 발음을 커스터마이징할 수 있습니다.
“효과” 항목에서는 에코나 필터 같은 간단한 효과를 적용할 수 있습니다.
합성 및 미리보기
▶ 재생 버튼을 누르면 즉시 합성된 음성이 재생됩니다.
수정 사항이 있을 경우, 자동으로 다시 합성되어 미리보기에 반영됩니다.
합성된 결과는 Asset/Sound/ 폴더에 자동 저장됩니다.

💬 자막 설정¶

항목	설명
X / Y	자막의 화면 내 위치
FontSize / OutlineSize	글자 크기와 외곽선 두께
Dock	자막의 기준 위치 (Top / Center / Bottom)
Fill / Outline	글자 및 외곽선 색상 설정
미리보기	합성된 음성과 자막의 싱크를 실시간 확인 가능

🧩 타임라인 제어¶

각 문장은 타임라인 상의 개별 블록으로 표시됩니다.
블록을 드래그하여 위치를 이동하거나, 양쪽 끝을 드래그하여 길이를 조정할 수 있습니다.
타임라인 구조는 COEIROINK나 비디오 트랙과 동일하게 작동합니다.
여러 문장을 순차적으로 배치하여 대화형 씬을 구성할 수 있습니다.

3. 출력 위치¶

항목	경로
생성된 음성 파일	`Asset/Sound/` 폴더에 자동 저장
자막 데이터	동일 경로 내 `.srt` 또는 프로젝트 메타 데이터로 저장

4. 주의사항 (Notes & Limitations)¶

Hailuo API는 무료로 사용할 수 없습니다.
웹 요금제와 API 요금제는 별도이며,
웹사이트의 음성 합성 기능을 사용하더라도 API 호출에는 별도의 과금이 발생합니다.
클라우드 기반이므로 인터넷 연결이 필수입니다.
일부 음성은 감정 설정을 지원하지 않습니다.
API 호출 한도가 있으므로 짧은 문장 단위로 합성하는 것을 권장합니다.
응답이 지연될 경우, Hailuo 서버 상태나 트래픽을 확인하세요.

5. 라이선스 및 출처 (License & Credits)¶

공식 사이트: https://www.minimax.io/audio
상업적 사용 가능 (단, Minimax 서비스 약관을 반드시 준수해야 합니다.)