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
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.mp4Montserrat 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
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.mp4Subtí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
| Opción | Qué hace | Dónde |
|---|---|---|
subtitles=subtitulos.srt | Dibuja el archivo de subtítulos en cada fotograma con libass | Incrustar |
fontsdir=fonts | Carpeta de la que cargar fuentes; en la API, /usr/share/fonts/reelsdk | Incrustar |
force_style='...' | Cambia el estilo por defecto, con valores separados por comas | Incrustar |
FontName=Montserrat Black | Nombre de la familia, no del archivo | Incrustar |
FontSize=12 | Tamaño en unidades de estilo: 80 px en este vídeo de 1920 px de alto | Incrustar |
PrimaryColour=&H00FFFFFF | Color del texto en &HAABBGGRR; alfa 00 es opaco | Incrustar |
MarginV=60 | Distancia al borde inferior en unidades de estilo: 400 px aquí | Incrustar |
charenc=CP1252 | Codificación del SRT cuando no es UTF-8 | Windows |
-c:s mov_text | El códec de subtítulos que admite MP4 | Pista |
-metadata:s:s:0 language=spa | Marca la pista como español para el menú del reproductor | Pista |
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.
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"]
}'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.
- Burn subtitles into a video with ffmpegHardcode an SRT into the picture with the subtitles filter and force_style, or add it as a soft track players can switch off.
- Subtítulos automáticosEnvías la URL de un vídeo en español y recibes el MP4 con los subtítulos incrustados, más SRT, VTT y ASS, a 0,03 USD por minuto.
- Auto captions API: word-by-word captions for $0.03 a minuteSend a video URL, get an MP4 with word-by-word captions burned in plus SRT, VTT, ASS and a word-timed transcript. $0.03 per output minute with transcription included; a 30-second clip renders in 30 to 43 seconds.
- Add text to a video with ffmpeg drawtextDraw a title or a running clock on video with drawtext: font, size, a box behind it, position, timing and the colon you have to escape.
- Add captions to a videoBurn word-by-word captions into a video for TikTok, Reels or Shorts and get SRT and VTT files back: free here, or one POST /v1/captions call.
- Burn subtitlesHard-code an SRT, ASS or VTT file into a video with one ffmpeg call and 10 bundled fonts, for well under a cent a clip.
- ReelSDK en españolPáginas en español de ReelSDK, la API de vídeo: subtítulos automáticos y vídeos con fotos a 0,03 USD por minuto de vídeo, y shorts a 0,30 USD.
Fuentes, revisadas en noviembre de 2026
¿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.