视频脚本转 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 版本。生产环境下的旁白音频建议优先使用 Python 脚本，因为它调用的是 t2a_v2 接口，支持完整的参数。
工作流程
- 读取或接收视频脚本文本
- 如有需要，将脚本保存为
.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自动安装）