Incrustar subtítulos
Hay subtítulos que necesitan ser parte de la imagen, no una opción que el espectador tal vez ni encuentre: este endpoint vuelve a renderizar el video con el texto de los subtítulos dibujado directamente sobre cada fotograma. Es la solución para todas las plataformas y reproductores que silenciosamente descartan las pistas de subtítulos externas en cuanto el archivo cambia de manos.
Ejecútela online
Ejecute esto en nuestros servidores con su cuenta. Las herramientas gratuitas corren en su navegador; esta cobra de su saldo del KIT según el precio de arriba.
El problema que resuelve
Los subtítulos externos son elegantes en teoría —un archivo aparte, activable, traducible—, pero muchos destinos reales no cooperan: apps de video corto, reproductores embebidos en sitios de marketing, reenvíos por WhatsApp, pantallas y quioscos en tiendas físicas suelen ignorar o descartar las pistas de subtítulos externas. Quien administra la publicación en esos canales termina necesitando el texto pintado físicamente sobre el video, lo cual es una tarea de renderizado, no de metadatos, y no vale la pena hacerla a mano en un editor en cada exportación.
Cómo corre la tarea
Se envía el video de origen junto con los cortes de subtítulo a POST /video/burn-subtitles y se recibe un task_id mientras el render entra en cola. El servicio compone el texto sobre cada fotograma correspondiente con el tiempo correcto, vuelve a codificar el video y entrega un solo archivo donde los subtítulos son simplemente parte de la imagen: sin pista externa, sin depender de que el reproductor la soporte, sin riesgo de que se pierdan en el camino.
Por qué se llama 'incrustar'
El término viene del mundo del cine y la transmisión, donde los subtítulos abiertos se exponían literalmente sobre la copia durante la impresión óptica, permanentes e imposibles de apagar, a diferencia de los subtítulos cerrados, que el receptor decodificaba solo si elegía hacerlo. El video digital heredó esa misma división, y grabar subtítulos hoy hace exactamente lo que siempre hizo: cambia flexibilidad por visibilidad garantizada, justo el intercambio que suelen exigir la entrega social y de transmisión.
Lo que se sacrifica, a propósito
El texto incrustado no se puede apagar, ni traducir después, ni lo lee un lector de pantalla, así que es la herramienta equivocada cuando importan las opciones de accesibilidad; para eso está el generador de subtítulos externos. Este endpoint sirve específicamente para la última etapa: exportaciones finales que van a plataformas y reproductores que no controla, donde la única garantía real es lo que quedó grabado en los píxeles.
Dónde encaja en un flujo
En un proceso automatizado, este endpoint suele ir después de la transcripción y antes de la entrega final: se generan los cortes de subtítulo, se revisan o traducen si hace falta, y luego se incrusta la versión elegida como último paso antes de publicar. Como es asíncrono igual que cada etapa de la cadena, procesar decenas de exportaciones terminadas durante la noche es solo cuestión de repetir la llamada. Este endpoint está terminando su despliegue final; la forma de la solicitud y el precio aquí descritos son los definitivos, y los renders fallidos nunca se cobran.
Qué puede hacer con ella
Video corto para apps sociales
Una marca exporta video vertical con subtítulos incrustados porque las apps de destino no renderizan de forma confiable los archivos de subtítulos externos, así que el texto ya debe estar en el fotograma.
Pantallas y quioscos en tiendas
Un comercio reproduce videos de producto en pantallas sin atención humana y sin soporte alguno de pistas de subtítulos, así que el texto se incrusta durante la exportación en lugar de depender del reproductor.
Clips reenviados y compartidos
Una redacción incrusta subtítulos en clips de última hora sabiendo que el video se volverá a descargar y compartir en apps de mensajería que eliminan los metadatos de subtítulos externos.
Variantes multilingües de campaña
Un equipo de marketing genera una pista de idioma por mercado e incrusta cada una en su propia exportación, produciendo varios archivos listos para publicar a partir de un solo video de origen.
Preguntas frecuentes
¿Qué cambia realmente en el archivo la api incrustar subtitulos en video?
Vuelve a renderizar el video para que el texto de los subtítulos sea parte de la imagen en cada fotograma, a diferencia de un archivo de subtítulos externo que el reproductor puede activar o desactivar.
¿Puedo quitar después los subtítulos incrustados?
No, esa es la naturaleza de los subtítulos grabados en la imagen. Si necesita una pista removible y traducible, conviene usar el endpoint independiente que genera subtítulos externos.
¿Se puede probar esta API gratis?
No hay capa gratuita: las capas gratis se abusan y ralentizan a todos. El acceso funciona con un saldo prepago de ForHosting KIT: se recarga desde $10.00 (no caduca) y cada solicitud se cobra a su precio publicado, así que una llamada sin saldo devuelve HTTP 402. Sin suscripción, sin tokens ni créditos inventados, y una tarea fallida no se cobra.
¿Cómo se envía el texto de los subtítulos a incrustar?
Se entregan los cortes de subtítulo junto con el video de origen en la solicitud; el servicio compone ese texto sobre los fotogramas correspondientes durante el render.
¿Cómo recibo el video terminado?
Mediante un webhook firmado cuando el render se completa, o a través de un enlace firmado que permanece válido por 24 horas tras finalizar la tarea.
¿Incrustar subtítulos afecta la calidad del video?
El video se vuelve a codificar para añadir el texto, así que la configuración de salida y el bitrate importan igual que en cualquier render; el proceso en sí no degrada la calidad más allá de esa codificación.
¿Puedo incrustar subtítulos en varios videos a la vez?
Sí, cada llamada es una tarea asíncrona independiente con su propio task_id, así que procesar un lote es solo cuestión de enviar varias solicitudes.
¿Ya está disponible el endpoint?
Está en su fase final de despliegue; el endpoint, el precio y el formato de trabajo aquí documentados son definitivos y pronto comenzará a aceptar solicitudes.
Para desarrolladores — acceso por API
Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.
Endpoint de API
¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, y pronto desde nuestra app, el email y Telegram.
Llámela desde su stack
curl -X POST https://api.kit.forhosting.com/video/burn-subtitles \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"audio":"https://ejemplo.com/audio.mp3"}'const res = await fetch("https://api.kit.forhosting.com/video/burn-subtitles", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"audio": "https://ejemplo.com/audio.mp3"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/video/burn-subtitles",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"audio": "https://ejemplo.com/audio.mp3"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/video/burn-subtitles", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"audio":"https://ejemplo.com/audio.mp3"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"audio":"https://ejemplo.com/audio.mp3"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/video/burn-subtitles", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Ejemplo de solicitud
{
"audio": "https://ejemplo.com/audio.mp3"
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "video.burn_subtitles",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.
Precio
Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.
Límites
max_mb | 500 |
max_minutes | 60 |
max_megapixels | 3.9 |
Errores
| HTTP | Código | Significado |
|---|---|---|
401 | unauthorized | API key ausente o inválida. |
402 | insufficient_balance | El saldo no cubre el precio de la tarea. |
404 | unknown_type | El tipo de tarea no existe. |
429 | rate_limited | Demasiadas peticiones. Use el webhook en vez de sondear. |