Video Script to MP3
Convert video scripts to MP3 voiceover using MiniMax TTS API.
Defaults
- Model:
speech-2.8-hd - Voice:
moss_audio_c56d6120-ef9c-11f0-9649-8ee40147f116 - Speed:
1.08 - Language: Vietnamese
- Format: MP3 (32kHz, 128kbps, mono)
Quick Usage
Via Python script (recommended for long scripts)
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
Via script with custom options
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
Via MiniMax MCP tool (short text only)
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/"
)
Note: MCP tool uses different API version. Prefer the Python script for production voiceovers as it calls t2a_v2 with full parameter support.
Workflow
- Read or receive video script text
- Save script to a
.txtfile if needed - Run
text_to_mp3.pywith appropriate output path - Script returns: duration, file size, character count
- Use output MP3 in video production pipeline (Remotion, HeyGen, etc.)
Output Convention
Save MP3 files to: workspace/content/YYYY-MM-DD/video-short/<project>/voiceover.mp3
API Details
See references/minimax-tts-api.md for full API parameters including pronunciation_dict, voice_modify (echo effects), and response format.
Requirements
MINIMAX_API_KEYin project.envfile- Python dependencies managed via PEP 723 inline metadata (auto-installed by
uv run)