影片腳本轉 MP3
將影片腳本轉換為 MP3 語音旁白，使用 MiniMax TTS API。
預設值
- 模型：
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 版本。建議在正式語音旁白製作中優先使用 Python 腳本，因為它呼叫 t2a_v2 並支援完整的參數。
工作流程
- 讀取或接收影片腳本文字
- 如有需要，將腳本儲存為
.txt檔案 - 使用適當的輸出路徑執行
text_to_mp3.py - 腳本回傳：持續時間、檔案大小、字元數
- 在影片製作流程中使用輸出的 MP3（Remotion、HeyGen 等）
輸出慣例
將 MP3 檔案儲存至：workspace/content/YYYY-MM-DD/video-short/<project>/voiceover.mp3
API 詳細資訊
請參閱 references/minimax-tts-api.md 以取得完整的 API 參數，包括 pronunciation_dict、voice_modify（回音效果）以及回應格式。
需求
- 專案
.env檔案中需有MINIMAX_API_KEY - Python 依賴項目透過 PEP 723 內嵌中繼資料管理（由
uv run自動安裝）