ビデオスクリプトから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を実行する - スクリプトが返す：再生時間、ファイルサイズ、文字数
- 出力MP3を動画制作パイプライン（Remotion、HeyGenなど）で使用する
出力規則
MP3ファイルの保存先：workspace/content/YYYY-MM-DD/video-short/<project>/voiceover.mp3
APIの詳細
pronunciation_dict、voice_modify（エコー効果）、およびレスポンスフォーマットを含む完全なAPIパラメータについては、references/minimax-tts-api.mdを参照してください。
必要条件
- プロジェクトの
.envファイルにMINIMAX_API_KEYを設定 - Python依存関係はPEP 723インラインメタデータで管理（
uv runで自動インストール）