Vídeo en vertical
Un video grabado en horizontal no se reduce sin más a un feed vertical, necesita reencuadrarse para que el sujeto principal siga dentro del cuadro. Este endpoint toma un origen 16:9 y entrega una versión 9:16 recortada para mantener la acción centrada, lista para las plataformas que solo hablan en vertical.
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.
Por qué recortar un video es más difícil de lo que parece
Recortar los costados de un video panorámico sin criterio suele eliminar justo lo que importa: el rostro de quien habla, un producto sobre una mesa, los subtítulos que corren en la parte inferior. El endpoint de api convertir video a vertical está pensado para equipos que reutilizan la misma grabación en una plataforma horizontal y otra vertical, y necesitan que el corte vertical tenga sentido por sí solo, no que sea solo una franja más angosta del original.
Cómo se decide el recorte
POST /video/social-crop toma el origen en 16:9 y lo reencuadra a 9:16 siguiendo dónde se ubica el contenido relevante a lo largo del tiempo, en lugar de aplicar una sola ventana de recorte fija a todo el clip; la salida desplaza el recorte según haga falta para que un sujeto que se mueve dentro del cuadro no termine fuera de él a mitad del video.
Qué devuelve la tarea
El trabajo se ejecuta de forma asíncrona: envía el origen, recibe un task_id de inmediato, y obtiene el archivo vertical terminado mediante un webhook firmado en cuanto está listo, o mediante un enlace firmado válido por 24 horas si prefiere consultarlo por su cuenta.
Una breve historia del problema de formato
El video vertical se volvió el formato de consumo por defecto recién cuando los feeds de formato corto como Reels, Shorts y TikTok acostumbraron a la audiencia a sostener el teléfono en vertical mientras miran, lo que dejó una década de grabaciones horizontales, desde webinars hasta demos de producto, con la forma equivocada para las plataformas que generan más vistas hoy; el reencuadre automático es la respuesta práctica para una biblioteca que nunca se filmó pensando en 9:16.
Cómo encaja en un flujo de publicación
Al ser una sola llamada asíncrona, encaja de forma natural al final de un pipeline de contenido: se renderiza o recibe el máster horizontal, se llama a este endpoint, y el archivo vertical resultante se entrega directamente al programador o script de publicación que lo sube a redes sociales, sin reencuadre manual en un editor para cada clip.
Qué puede hacer con ella
Reaprovechar grabaciones de webinars
Una empresa toma sus grabaciones de webinars en 16:9 y produce automáticamente clips destacados en vertical para Reels y Shorts sin reeditar cada uno a mano.
Clips de video para podcast
Un estudio de podcast convierte episodios completos de video horizontal en clips verticales centrados en quien esté hablando, listos para publicar en formato corto.
Videos de producto para e-commerce
Una tienda en línea reencuadra sus videos horizontales de demostración de producto a formato vertical para usarlos en anuncios comprables en redes, sin volver a grabar.
Conversión por lotes de un archivo de contenido
Un equipo de medios procesa durante la noche todo su catálogo histórico de videos horizontales a través del endpoint para construir una biblioteca lista en vertical para futuras campañas.
Preguntas frecuentes
¿Cómo convierto un video a formato vertical con la API?
Envíe una solicitud POST a /video/social-crop con su origen en 16:9; recibe un task_id de inmediato y el resultado 9:16 después por webhook o enlace firmado.
¿El recorte mantiene al sujeto dentro del cuadro automáticamente?
Sí, el reencuadre sigue dónde se ubica el contenido relevante a lo largo del tiempo en lugar de aplicar un solo recorte fijo, así un sujeto en movimiento permanece dentro del cuadro vertical.
¿Hay una prueba gratuita para el endpoint de recorte vertical?
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.
¿Qué relación de aspecto entrega la salida?
Entrega un archivo vertical estándar 9:16, adecuado para Reels, Shorts, TikTok y otros feeds pensados primero para vertical.
¿Cómo se factura el recorte vertical?
Cuesta $0.077 por solicitud más $0.0045 por minuto de video procesado, publicado como una tarifa base más un cargo por unidad, sin sorpresas.
¿Qué pasa si falla el trabajo de reencuadre?
Se reintenta automáticamente hasta tres veces, y si aun así falla nunca se cobra y recibe un error claro que explica el motivo.
¿Puedo ejecutar esto sobre un lote completo de videos a la vez?
Sí, como cada llamada es una tarea asíncrona independiente que se cobra solo si tiene éxito, puede automatizarla sobre toda una biblioteca de clips en paralelo.
¿El endpoint de recorte para redes ya funciona?
Está en despliegue final y todavía no acepta trabajos; estará disponible muy pronto en el mismo endpoint y precio indicados 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/social-crop \
-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/social-crop", {
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/social-crop",
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/social-crop", 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/social-crop", 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.social_crop",
"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. |