Unir vídeos
Unir varios clips en un solo archivo normalmente implica abrir un editor solo para arrastrar piezas en orden sobre una línea de tiempo. Este endpoint hace lo mismo con una sola llamada a la API: envíe los clips en secuencia y reciba un único archivo continuo, sin línea de tiempo de por medio.
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.
Quién necesita unir videos, y por qué
Cualquiera que arme un video final a partir de piezas separadas, intro más contenido principal más cierre, distintos ángulos de cámara grabados como archivos independientes, o clips diarios que deben convertirse en un resumen semanal, se topa con la misma tarea repetitiva. El endpoint de api unir videos saca ese paso de ensamblaje de un editor manual y lo convierte en algo que un script puede disparar en cuanto existen todos los clips de origen.
Cómo funciona la concatenación
POST /video/merge recibe una lista ordenada de fuentes de video y las une en un solo archivo de salida en la secuencia exacta indicada; el orden en el arreglo de la solicitud es el orden en el video final, así que armar un video de varios clips se reduce a ordenar bien los enlaces antes de enviar la solicitud.
Qué esperar de la respuesta
Al enviar la solicitud de unión se recibe un task_id de inmediato mientras la concatenación ocurre en segundo plano; el archivo unido se entrega mediante un webhook firmado en cuanto está listo, o mediante un enlace firmado que puede consultar usted mismo dentro de una ventana de 24 horas.
Una nota sobre por qué unir videos no siempre es trivial
Dos clips que se ven compatibles en pantalla pueden diferir por dentro en resolución, cuadros por segundo o códec, y unirlos sin manejar esas diferencias produce un archivo que se traba o no reproduce bien en algunos reproductores; un paso de unión correcto normaliza lo que hay que normalizar para que el archivo final se comporte como un solo video continuo y no como un empalme frágil de partes distintas.
Dónde encaja la unión dentro de una automatización
Al ser asíncrono y cobrarse solo si tiene éxito, este endpoint encaja de forma natural en pipelines que ensamblan video a partir de piezas de manera programada: un resumen diario armado a partir de segmentos separados, un video de curso unido a partir de lecciones grabadas de forma individual, o un video destacado ensamblado a partir de clips seleccionados por un paso automatizado previo.
Qué puede hacer con ella
Ensamblaje de intro, contenido y cierre
Un creador mantiene un clip fijo de intro y otro de cierre, y los une automáticamente con el video principal cada vez que sube un episodio nuevo.
Videos de curso con varios segmentos
Una plataforma de cursos en línea une los segmentos de lecciones grabados por separado en un solo video de módulo continuo antes de publicarlo a los estudiantes.
Compilaciones diarias que se vuelven semanales
Un equipo de medios une automáticamente los clips cortos de cada día en un único video de resumen semanal cada domingo, sin edición manual.
Grabación de eventos con varias cámaras
Un flujo de producción de eventos une clips secuenciales de distintos ángulos de cámara grabados por separado durante una transmisión en vivo, en un solo archivo de archivo continuo.
Preguntas frecuentes
¿Cómo uno varios videos con la API?
Envíe una solicitud POST a /video/merge con una lista ordenada de fuentes de video; recibe un task_id de inmediato y el archivo unido después por webhook o enlace firmado.
¿Importa el orden de los clips en mi solicitud?
Sí, los clips se unen exactamente en el orden en que los lista, así que ordenar bien su arreglo de fuentes determina la secuencia del video final.
¿Puedo unir videos con distinta resolución o códec?
Sí, el endpoint normaliza las diferencias necesarias para producir un solo archivo de salida continuo y que se reproduzca correctamente, sin exigir formatos de origen idénticos.
¿Puedo probar la unión de videos 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.
¿Cuánto cuesta el endpoint de unión?
Cuesta $0.077 por solicitud más $0.0045 por minuto de video unido, sin sistema de créditos inventado, solo una tarifa base más un cargo por unidad, publicados de antemano.
¿Cuántos clips puedo unir en una sola solicitud?
Puede enviar tantos clips de origen como necesite su flujo de trabajo en la lista ordenada; cada solicitud se factura según los minutos totales del resultado unido.
¿Qué pasa si falla un trabajo de unión?
Se reintenta automáticamente hasta tres veces, y un trabajo que finalmente falla nunca se cobra, devolviendo en su lugar un error claro.
¿El endpoint de unión ya está disponible?
Está en despliegue final y todavía no acepta trabajos; estará disponible muy pronto bajo el endpoint y el precio descritos aquí.
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/merge \
-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/merge", {
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/merge",
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/merge", 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/merge", 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.merge",
"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. |