Communitygithub.com

ai-video-voice

Locución y subtítulos para un video corto: síntesis TTS de una sola toma, sincronía audio-imagen por duración real, temporización de subtítulos a partir del audio, mezcla normalizada a -14 LUFS. Se ejecuta después de ai-video-render y antes de la revisión.

¿Qué es ai-video-voice?

Este skill, ai-video-voice, se encarga de agregar locución y subtítulos a un video silente ya renderizado. Utiliza síntesis de texto a voz (TTS) en una sola toma completa, evitando la costura de frases que genera costuras audibles y desviaciones de sincronía. La sincronización entre el audio y el video se basa en la duración real de la locución, sin estirar el audio para ajustarlo a la duración del metraje. Los subtítulos se temporizan a partir del audio, ya sea mediante reconocimiento de voz o detección de silencios con un margen de error documentado. Finalmente, la mezcla de audio se normaliza a -14 LUFS, y se generan archivos de salida como voiceover.wav, captions.srt y un informe de mezcla (mix-report.md). El skill está diseñado para integración en flujos de trabajo de IA como Cursor o Codex, y garantiza que los problemas de configuración de voz solo afecten la locución, sin bloquear otras tareas.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/LaomaiAI/ai-video-skills/tree/HEAD/skills/04-voice

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

ai-video-voice: 配音

Cuándo usarlo

El video silente (film.mp4) existe. Este skill añade locución, subtítulos y la mezcla final. Nunca modifica la imagen.

1. Verificar primero la configuración de voz

Ejecuta la verificación de configuración TTS antes de sintetizar (por ejemplo, un comando doctor si la herramienta TTS lo proporciona). Informa al usuario sobre la configuración faltante; no cambies silenciosamente a una voz diferente.

  • Si el usuario solicitó una voz personal y su configuración falta o está dañada, pausa solo la locución afectada. No sustituyas silenciosamente por otra voz.
  • Las configuraciones de voz personal, grabaciones, clips de referencia y pesos del modelo permanecen en un directorio privado. Nunca ingresan a este repositorio.

2. Sintetizar en una sola toma completa

  • Sintetiza la locución en una sola toma completa, no cosiendo frase por frase. Coser crea costuras audibles y desviaciones.
  • Si el modelo de voz o el clip de referencia cambia, genera una nueva versión de la locución. Nunca sobrescribas el archivo de audio anterior.

3. Sincronía audio-imagen usando la duración real

  • Sincroniza según la duración real de la locución. Nunca estires el audio para que encaje en un plano.
  • Si el metraje es corto, mantén el último fotograma para llenar el espacio. Si el metraje es largo, corta el segmento con menos información.
  • Coloca las acciones fuertes en los beats marcados. Mueve los efectos de sonido desde el movimiento mismo.

4. Los subtítulos siguen al audio

  • La temporización de los subtítulos proviene del audio, no de la estimación del guion. Transcribe con un reconocedor de voz cuando esté disponible; sin él, usa el guion más detección de silencio (el error puede alcanzar 0.4 segundos).
  • Corrige los errores de reconocimiento contra el guion. Corta las oraciones iniciales y finales que pertenezcan a vecinos.
  • Entrega captions.srt junto con el video. Si el video se vuelve a cortar para un editor que añade sus propios subtítulos, entrega también un video sin subtítulos más el archivo .srt.

5. Mezcla

  • Normaliza el audio mezclado a -14 LUFS.
  • Mantén música, locución y efectos de sonido en una sola línea de tiempo con la imagen.
  • Verifica el pico de audio y la decodificación completa antes de pasar a revisión.

Contrato de salida

  • voiceover.wav (o .mp3), una sola toma completa.
  • captions.srt.
  • mix-report.md (duración, pico, LUFS, fuente de subtítulos y margen de error).

Reglas

  • Una configuración de voz faltante bloquea solo la locución. Nunca bloquea el trabajo de guion o imagen.
  • Nunca afirmes que un archivo de subtítulos es exacto cuando provino de detección de silencio; escribe el margen de error en el informe de mezcla.
  • No subir ni desplegar audio sin autorización de publicación.

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

Skills relacionados