Roteiro de Vídeo para MP3
Converte roteiros de vídeo em MP3 narrado usando a API MiniMax TTS.
Padrões
- Modelo:
speech-2.8-hd - Voz:
moss_audio_c56d6120-ef9c-11f0-9649-8ee40147f116 - Velocidade:
1.08 - Idioma: Vietnamita
- Formato: MP3 (32kHz, 128kbps, mono)
Uso Rápido
Via script Python (recomendado para roteiros longos)
uv run .claude/skills/mkt-video-script-to-mp3/scripts/text_to_mp3.py \
--file caminho/para/roteiro.txt \
-o workspace/content/AAAA-MM-DD/voiceover.mp3
Via script com opções personalizadas
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 ferramenta MCP MiniMax (apenas texto curto)
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/"
)
Nota: A ferramenta MCP usa uma versão diferente da API. Prefira o script Python para narrações em produção, pois ele chama a t2a_v2 com suporte completo de parâmetros.
Fluxo de Trabalho
- Leia ou receba o texto do roteiro do vídeo
- Salve o roteiro em um arquivo
.txtse necessário - Execute
text_to_mp3.pycom o caminho de saída apropriado - O script retorna: duração, tamanho do arquivo, quantidade de caracteres
- Use o MP3 gerado na pipeline de produção de vídeo (Remotion, HeyGen, etc.)
Convenção de Saída
Salve os arquivos MP3 em: workspace/content/AAAA-MM-DD/video-short/<projeto>/voiceover.mp3
Detalhes da API
Consulte references/minimax-tts-api.md para parâmetros completos da API, incluindo pronunciation_dict, voice_modify (efeitos de eco) e formato de resposta.
Requisitos
MINIMAX_API_KEYno arquivo.envdo projeto- Dependências Python gerenciadas via metadados inline PEP 723 (instaladas automaticamente pelo
uv run)