Subtítulos (pantalla verde, sincronizados con la voz, seguros para Shorts)
El usuario edita los subtítulos posteriormente en After Effects, por lo que NUNCA se queman en el video. Entregue un clip separado sobre verde puro (#00FF00), del mismo tamaño, fps y número de fotogramas que el video, que se pueda extraer con Keylight.
Aspecto (acordado el 2026-11-11, según el fotograma de referencia "BLOQUEADO" del usuario)
- Posición: centrado horizontalmente; el centro de las mayúsculas al 71,5 % de la altura del fotograma (debajo del pecho del personaje). El centro de las mayúsculas es el ancla, así que una coma o una Q nunca mueven un subtítulo.
- Blanco, MAYÚSCULAS, Arial Black, 3,2 % de la altura del fotograma (82 px a 2560). Al principio era 4 %, y el usuario pidió más pequeño para que la interfaz de Shorts nunca lo cubra. Contorno negro; sombra paralela dura hacia abajo a la derecha. La sombra es sólida a propósito: una sombra borrosa/semitransparente al hacer keying produce un borde verde-gris.
- Se conserva la puntuación tal como aparece en el guion (MONA LISA. / PARIS, / 1911.). El usuario lo pidió.
--strip-punctelimina los puntos, comas, punto y coma y dos puntos finales. - Máximo 2-3 palabras por subtítulo. Un subtítulo nunca cruza una oración/comma o una pausa en la voz, nunca termina en una palabra conectora (the, of, with, yang, di, dengan ...), nunca divide un nombre (Mona | Lisa) y evita palabras sueltas.
- Cada subtítulo aparece en el fotograma en el que se pronuncia su primera palabra (un pop de 5 fotogramas 0.85 -> 1.06 -> 1) y se mantiene hasta el siguiente. Después de una pausa en la voz, desaparece 0.25 s después de su última palabra.
Zona segura de YouTube Shorts (debe cumplirse para cada subtítulo, en el pico 1.06 del pop)
Áreas de superposición conservadoras:
- botones de acción: 16 % derecho del ancho
- título/canal/música: 25 % inferior de la altura
- barra superior: 8 % superior de la altura
El script mide la tinta de cada subtítulo, imprime ADVERTENCIA: fuera de la zona segura de Shorts: <texto> para cualquier subtítulo que cruce una
zona, e imprime el alcance (debe ser aproximadamente "83.8 % del ancho, 69.8-74.0 % de la altura"). Los fragmentos se dividen para que quepan
en --max-width 0.68. Una palabra larga solitaria se reduce para que quepa. Nunca entregue con una ADVERTENCIA: reduzca --size, o suba
un poco --y.
Modelo (ahorro de tokens, aprobado el 2026-11-12)
Ejecute subtítulos en Haiku 5.5 (agente remotion-renderer con model: "haiku", o una sesión de Haiku): el script realiza la
sincronización, división y comprobaciones de zona segura y las imprime como texto. Use Sonnet solo para evaluar un nuevo aspecto de subtítulos; Opus solo para
cambiar la lógica de scripts/captions.py.
Pasos
- Tiempos de palabra: el archivo
stories/<slug>/voice/words.jsondel video corto. Es creado porscripts/words_from_voice.py(faster-whisper alineado con la ortografía del guion). Si falta, créelo primero:python scripts/words_from_voice.py <voice.wav> <SCRIPT.md> <words.json> [en|id]. Los tiempos deben coincidir con el audio del video (la voz del video final comienza en 0 s). - Pruebe un fragmento primero (el usuario quiere VER una prueba corta antes de un renderizado completo):
Esto imprime cada subtítulo con sus tiempos y la comprobación de zona segura, y escribe:python scripts/captions.py stories/<slug>/voice/words.json out/<slug>/captions --start 0 --dur 10 \ --preview "out/<slug>/final/<Título>.mp4" --alphacaptions_green.mp4captions_alpha.movcaptions.jsoncaptions_preview.mp4(video + subtítulos extraídos + sonido, solo para verificar)
- Verifique:
- Extraiga fotogramas de los subtítulos más anchos de la vista previa con las zonas de Shorts dibujadas en rojo (ffmpeg
drawbox: x=iw0.84 desde y=ih0.45, y=ih0.75 hasta el fondo, la parte superior ih0.08), apílelos conhstacken una sola hoja y observe. - Observe un recorte a resolución completa en busca de bordes verdes.
- Envíe al usuario
captions_preview.mp4,captions_green.mp4y la lista impresa de subtítulos.
- Extraiga fotogramas de los subtítulos más anchos de la vista previa con las zonas de Shorts dibujadas en rojo (ffmpeg
- Después de la aprobación del usuario, renderice la duración completa con
--dur <fotogramas del video / fps>para que el clip tenga exactamente el número de fotogramas del video (verifique conffprobe -count_packets).
Parámetros (scripts/captions.py)
--y 0.715: posición--size 0.032: tamaño de fuente--max-width 0.68: subtítulo más ancho--font <ttf>--max-words 3--gap 0.30: pausa que rompe una frase--hold 0.25--lead 0: fotogramas adelantados--no-pop--lower: conservar mayúsculas/minúsculas--strip-punct--alpha: ProRes 4444
Notas para After Effects (para el usuario)
- Clip verde: use Keylight con Color de Pantalla = verde puro. Está en yuv444 crf 8, por lo que los bordes se mantienen limpios.
- Alpha .mov: no necesita keying en absoluto (colóquelo encima).
- captions.json: lista el texto de cada subtítulo y los segundos de entrada/salida, para reconstruirlos como capas de texto.