yyert123/shorts-voiceover

Shorts voiceover

Guion dentro, Short listo para subir. A diferencia de herramientas que adivinan la sincronización de los subtítulos a partir de la longitud del texto, esta skill transcribe la pista de voz final, por lo que cada subtítulo aparece exactamente cuando se pronuncia la palabra.

Cuándo usarla

• "Convierte este guion / estos consejos / esta publicación en un Short (o Reel, o TikTok)."
• "Haz un short sin rostro con locución y subtítulos." "Usa mi voz."
• "Haz 5 shorts a partir de estos guiones" -> ejecutar una vez por archivo de guion.

Pasos

1. Verifica que MIRAGEA_API_KEY esté configurada (nunca la imprimas). Voz: el ID de voz del usuario en Miragea, o una URL pública de un clip de su voz junto con las palabras exactas. Sugiere export MIRAGEA_VOICE_ID=.... Solo clona una voz que el usuario posea o tenga permiso de usar.

2. Escribe el guion: un párrafo corto por escena, línea en blanco entre escenas, 120-170 palabras en total para un Short de 45-60 s. Comienza con un gancho en la escena 1. Opcionalmente, @archivo al inicio de una escena elige su fondo:

   Tres consejos rápidos para que cualquier locución suene profesional.
   
   @broll/escritorio.mp4
   Primero, graba en una habitación pequeña con muebles blandos. El eco es más difícil de corregir que el ruido.
   

3. Renderiza:

   python3 scripts/short.py consejos.txt --voice ID_DE_VOZ                       # fondos degradados
   python3 scripts/short.py consejos.txt --media ./broll --music pista.mp3        # imágenes/clips del usuario + música
   

4. Entrega al usuario video y srt del JSON impreso. Ofrece ediciones: cambiar el texto de una escena y volver a ejecutar; solo esa escena se vuelve a locutar y el resto proviene de la caché.

Lo que es automático

Paso	Cómo
Voz	Cada escena locutada con Miragea; 0,18 s de respiro entre escenas
Sincronización de subtítulos	La pista de voz final la transcribe Miragea; indicaciones en MAYÚSCULAS de 1-3 palabras, tercio inferior
Imágenes	Recortadas a 9:16, zoom lento de entrada/salida alternando por escena
Clips	Recortados a 9:16, en bucle o recortados a la duración de la escena, sonido original eliminado
Sin medios	Degradado animado (4 paletas, rotando)
Música	En bucle, al 30 %, con reducción lateral bajo la voz
Sonoridad	-14 LUFS integrada, -1 dBTP (objetivo de Shorts/TikTok/Reels)
Re-ejecuciones	Locución por escena y transcripción en caché; las escenas sin cambios son gratuitas

Opciones

Banderas	Valor por defecto	Qué hace
--voice ID / --ref-url URL --ref-text TEXTO	env	Voz guardada de Miragea, o clonar a partir de un clip público
--media DIR	ninguna	Imágenes/clips para escenas sin @archivo, en orden de nombre
--music ARCHIVO	ninguna	Música de fondo, con reducción automática
--lowercase	desactivado	Subtítulos en minúsculas
--no-captions	desactivado	Omitir subtítulos (sin costo de transcripción)
--model	expressive	o standard
-o ARCHIVO	GUION.short.mp4	Ruta de salida

Costos y límites

Voz: por carácter (un Short de 150 palabras son ~850 caracteres). Sincronización de subtítulos: 3 puntos por segundo de la voz final (~75 puntos para 25 s); después en caché. Tarifas vigentes: GET https://miragea.ai/v1/capabilities. Las escenas deben tener menos de 2000 caracteres. Se imprime una advertencia por encima de 3 minutos (límite de Shorts de YouTube).

Solución de problemas

• archivo de medios no encontrado -> las rutas después de @ son relativas al guion o a la carpeta --media.
• No such filter: gradients -> ffmpeg es anterior a 6.1; actualiza, o pasa --media con imágenes.
• 401 clave incorrecta, 402 recarga en miragea.ai, 429 espera y vuelve a ejecutar (nada en caché se cobra de nuevo).

Usa solo música y material audiovisual para los que tengas derechos. Consulta examples/ para ver un guion real y su resultado.