비디오 스크립트에서 MP3로
비디오 스크립트를 MiniMax TTS API를 사용하여 MP3 음성으로 변환합니다.
기본 설정
- 모델:
speech-2.8-hd - 음성:
moss_audio_c56d6120-ef9c-11f0-9649-8ee40147f116 - 속도:
1.08 - 언어: 베트남어
- 형식: MP3 (32kHz, 128kbps, 모노)
빠른 사용법
Python 스크립트 사용 (긴 스크립트 권장)
uv run .claude/skills/mkt-video-script-to-mp3/scripts/text_to_mp3.py \
--file path/to/script.txt \
-o workspace/content/YYYY-MM-DD/voiceover.mp3
사용자 정의 옵션과 함께 스크립트 사용
uv run .claude/skills/mkt-video-script-to-mp3/scripts/text_to_mp3.py \
"Xin chào các bạn" \
-o output.mp3 \
--speed 1.1 \
--language_boost Vietnamese
MiniMax MCP 도구 사용 (짧은 텍스트만)
mcp__minimax__text_to_audio(
text="...",
voice_id="moss_audio_c56d6120-ef9c-11f0-9649-8ee40147f116",
model="speech-2.8-hd",
speed=1.08,
language_boost="Vietnamese",
output_directory="workspace/assets/minimax/"
)
참고: MCP 도구는 다른 API 버전을 사용합니다. 프로덕션 음성의 경우 전체 매개변수를 지원하는 t2a_v2를 호출하는 Python 스크립트를 선호하세요.
워크플로우
- 비디오 스크립트 텍스트를 읽거나 수신합니다.
- 필요한 경우 스크립트를
.txt파일로 저장합니다. - 적절한 출력 경로로
text_to_mp3.py를 실행합니다. - 스크립트가 반환하는 값: 길이, 파일 크기, 문자 수
- 비디오 제작 파이프라인(Remotion, HeyGen 등)에서 출력 MP3를 사용합니다.
출력 규칙
MP3 파일을 workspace/content/YYYY-MM-DD/video-short/<project>/voiceover.mp3 경로에 저장합니다.
API 세부 정보
전체 API 매개변수(pronunciation_dict, voice_modify(에코 효과), 응답 형식 등)는 references/minimax-tts-api.md를 참조하세요.
요구 사항
- 프로젝트
.env파일에MINIMAX_API_KEY가 설정되어 있어야 함 - Python 종속성은 PEP 723 인라인 메타데이터를 통해 관리됨 (
uv run에 의해 자동 설치)