Guion de Video a MP3
Convierte guiones de video a MP3 para voz en off usando la API MiniMax TTS.
Valores predeterminados
- Modelo:
speech-2.8-hd - Voz:
moss_audio_c56d6120-ef9c-11f0-9649-8ee40147f116 - Velocidad:
1.08 - Idioma: Vietnamita
- Formato: MP3 (32kHz, 128kbps, mono)
Uso rápido
Mediante script Python (recomendado para guiones largos)
uv run .claude/skills/mkt-video-script-to-mp3/scripts/text_to_mp3.py \
--file ruta/al/guion.txt \
-o workspace/content/YYYY-MM-DD/voiceover.mp3
Mediante script con opciones personalizadas
uv run .claude/skills/mkt-video-script-to-mp3/scripts/text_to_mp3.py \
"Xin chào các bạn" \
-o salida.mp3 \
--speed 1.1 \
--language_boost Vietnamese
Mediante la herramienta MCP de MiniMax (solo texto corto)
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: La herramienta MCP usa una versión diferente de la API. Prefiere el script Python para producciones de voz en off, ya que llama a t2a_v2 con soporte completo de parámetros.
Flujo de trabajo
- Leer o recibir el texto del guion de video
- Guardar el guion en un archivo
.txtsi es necesario - Ejecutar
text_to_mp3.pycon la ruta de salida adecuada - El script devuelve: duración, tamaño del archivo, cantidad de caracteres
- Usar el MP3 resultante en el pipeline de producción de video (Remotion, HeyGen, etc.)
Convención de salida
Guardar archivos MP3 en: workspace/content/YYYY-MM-DD/video-short/<proyecto>/voiceover.mp3
Detalles de la API
Consulta references/minimax-tts-api.md para conocer los parámetros completos de la API, incluyendo pronunciation_dict, voice_modify (efectos de eco) y el formato de respuesta.
Requisitos
MINIMAX_API_KEYen el archivo.envdel proyecto- Dependencias de Python gestionadas mediante metadatos en línea PEP 723 (se instalan automáticamente con
uv run)