ffmpeg -i video.mp4 -vf subtitles=subtitulos.srt dibuja un SRT en la imagen. En vertical, FontSize=12 sale a 80 píxeles y un SRT en Windows-1252 necesita charenc=CP1252. ReelSDK lo ejecuta a 0,02 USD por minuto de cómputo, y probarlo es gratis.

Subtítulos con FFmpeg

El filtro subtitles pinta el SRT con libass sobre un lienzo de 384x288 y lo escala al vídeo: en vertical, un margen de 60 son 400 píxeles. ReelSDK ejecuta el mismo comando en POST /v1/ffmpeg, y force_style elige fuente, tamaño y márgenes.

En españolActualizado

incrustar
ffmpeg -i video.mp4 -vf "subtitles=subtitulos.srt:fontsdir=fonts:\
force_style='FontName=Montserrat Black,FontSize=12,PrimaryColour=&H00FFFFFF,OutlineColour=&H00000000,BorderStyle=1,Outline=1.2,Shadow=0,MarginV=60'" \
  -c:v libx264 -crf 20 -c:a copy subtitulado.mp4

Montserrat Black, blanco con un contorno negro fino, a 400 px del borde inferior. El vídeo se vuelve a codificar; el audio se copia.

Variantes

Otros comandos que vas a necesitar

  1. Si el SRT viene de Windows

    Un SRT guardado en Windows-1252 en lugar de UTF-8 necesita charenc; sin él, las frases con tildes desaparecen.

    charenc
    ffmpeg -i video.mp4 -vf "subtitles=subtitulos.srt:charenc=CP1252:fontsdir=fonts:\
    force_style='FontName=Montserrat Black,FontSize=12,PrimaryColour=&H00FFFFFF,OutlineColour=&H00000000,BorderStyle=1,Outline=1.2,Shadow=0,MarginV=60'" \
      -c:v libx264 -crf 20 -c:a copy subtitulado.mp4
  2. Subtítulos que se pueden desactivar

    El SRT entra como pista aparte, marcada en español. No se vuelve a codificar nada: el archivo crece menos de 1 KB.

    pista
    ffmpeg -i video.mp4 -i subtitulos.srt -map 0 -map 1 -c copy -c:s mov_text \
      -metadata:s:s:0 language=spa suave.mp4

Las opciones

Las opciones de estos comandos

Las opciones de estos comandos
OpciónQué haceDónde
subtitles=subtitulos.srtDibuja el archivo de subtítulos en cada fotograma con libassIncrustar
fontsdir=fontsCarpeta de la que cargar fuentes; en la API, /usr/share/fonts/reelsdkIncrustar
force_style='...'Cambia el estilo por defecto, con valores separados por comasIncrustar
FontName=Montserrat BlackNombre de la familia, no del archivoIncrustar
FontSize=12Tamaño en unidades de estilo: 80 px en este vídeo de 1920 px de altoIncrustar
PrimaryColour=&H00FFFFFFColor del texto en &HAABBGGRR; alfa 00 es opacoIncrustar
MarginV=60Distancia al borde inferior en unidades de estilo: 400 px aquíIncrustar
charenc=CP1252Codificación del SRT cuando no es UTF-8Windows
-c:s mov_textEl códec de subtítulos que admite MP4Pista
-metadata:s:s:0 language=spaMarca la pista como español para el menú del reproductorPista

Fuente: Filtros de ffmpeg: subtitles, revisado en noviembre de 2026.

Tildes y eñes: UTF-8 o charenc

libass espera texto en UTF-8. Guardamos el mismo SRT en Windows-1252, la codificación que siguen usando muchos programas en Windows, y lo incrustamos sin más. ffmpeg avisó con "Invalid UTF-8 in decoded subtitles text; maybe missing -sub_charenc option" y siguió adelante, pero las dos frases con tildes y eñes no salieron: en la zona del subtítulo casi no quedó ni un píxel blanco, frente al texto completo con el archivo en UTF-8. La tercera frase, sin tildes, salió igual en los dos casos.

Hay dos arreglos. Guarda el SRT como UTF-8, o indica la codificación con charenc=CP1252. Con charenc el resultado fue idéntico byte a byte al de la versión UTF-8, tanto en local como en la API.

Por qué FontSize=12 son 80 píxeles

Un SRT no tiene tamaño de lienzo. Al convertirlo para libass, ffmpeg usa un lienzo de 384x288 y escala cada tamaño y cada margen al fotograma real. En un vídeo de 1920 píxeles de alto una unidad son unos 6,7 px, así que FontSize=12 pide 80 px y MarginV=60 sube el texto 400 px. Por eso los tamaños que funcionan en un reproductor de escritorio salen enormes en vídeo vertical.

El español ocupa más

Las frases en español suelen ser más largas que en inglés, y libass parte las líneas que no caben. Nuestra primera versión llevaba el segundo subtítulo en una sola línea y salió partido en 3 líneas. Con un salto de línea a mano después de la primera coma cabe en 2. Mira un fotograma antes de procesar el vídeo entero.

Recortar e incrustar a la vez

Con -ss 3 antes de -i, el vídeo vuelve a empezar en 0 pero el SRT sigue empezando en su propio 0. En el fotograma de los 3 s salió el primer subtítulo, que termina antes de los 2 s. Con -ss después de -i, o con -copyts, aparece el subtítulo correcto. También puedes recortar primero e incrustar después; lo explicamos en la guía de recortar vídeo con ffmpeg, en inglés.

Incrustados o desactivables

Los subtítulos incrustados forman parte de la imagen: se ven en cualquier reproductor y en cualquier red social, pero nadie puede quitarlos ni corregir una errata después. Una pista mov_text va aparte: el reproductor tiene que admitirla y el espectador tiene que activarla. Para redes sociales, incrústalos. Para una videoteca en varios idiomas, usa pistas.

Sin instalar ffmpeg

El mismo comando como una llamada a la API

Envía los mismos argumentos a POST /v1/ffmpeg con las URL del vídeo y del SRT en inputs. El filtro subtitles está permitido y las fuentes incluidas están en /usr/share/fonts/reelsdk. Cada trabajo ejecuta ffmpeg 8.1 en una máquina nueva a 0,02 USD por minuto de cómputo, cobrado por segundos; este terminó en unos 12 segundos y costó menos de 0,004 USD. ¿Aún no tienes el SRT? POST /v1/captions transcribe la voz e incrusta los subtítulos en una sola llamada.

terminalTry it
curl "https://api.reelsdk.com/v1/ffmpeg?wait=60" \
  -H "Authorization: Bearer $REELSDK_KEY" \
  --json '{
    "inputs": {
      "video.mp4": "https://api.reelsdk.com/f/lib/demo/clip.mp4",
      "subtitulos.srt": "https://api.reelsdk.com/f/lib/in/guides/sevilla-subtitulos.srt"
    },
    "args": [
      "-i", "video.mp4", "-vf",
      "subtitles=subtitulos.srt:fontsdir=/usr/share/fonts/reelsdk:force_style='\''FontName=Montserrat Black,FontSize=12,PrimaryColour=&H00FFFFFF,OutlineColour=&H00000000,BorderStyle=1,Outline=1.2,Shadow=0,MarginV=60'\''",
      "-c:v", "libx264", "-crf", "20", "-c:a", "copy", "subtitulado.mp4"
    ],
    "outputs": ["subtitulado.mp4"]
  }'
El SRT en español incrustado con el estilo de arriba y vuelto a codificar con libx264.Entrada: subtitulos.srtcon charenc=CP1252

FAQ

Preguntas frecuentes

¿Cómo incrusto subtítulos en un vídeo con FFmpeg?

Usa ffmpeg -i video.mp4 -vf subtitles=subtitulos.srt -c:v libx264 -c:a copy salida.mp4. Añade force_style='FontName=...,FontSize=...' para cambiar el aspecto.

¿Por qué desaparecen los subtítulos con tildes?

El SRT no está en UTF-8. Guárdalo como UTF-8 o añade charenc=CP1252 al filtro subtitles si viene de Windows.

¿Por qué los subtítulos salen tan grandes?

Los tamaños se escalan desde un lienzo de 384x288 a tu vídeo. En un vídeo de 1920 px de alto, FontSize=12 son 80 px, así que usa números más pequeños que en un reproductor.

¿Puedo incrustar subtítulos con una API?

Sí. Envía los mismos argumentos a https://api.reelsdk.com/v1/ffmpeg con las URL del vídeo y del SRT en inputs. Para sacar los subtítulos de la voz, usa POST /v1/captions.

¿Listo para empezar?

Genera vídeo desde tu app hoy

Tus primeros 0,50 USD son gratis y una sola clave sirve para todos los endpoints.