Compruebe la relación de aspecto de un video para cada plataforma
Un video puede ser técnicamente válido y, aun así, encajar mal en su destino. Este comprobador compara la relación entre ancho y alto indicada con el marco fijo de una ubicación concreta en una plataforma social.
Ejecutar — gratis
Le informa si la geometría coincide, si una fuente más estrecha necesitaría bandas laterales o si una fuente más ancha perdería sus bordes por recorte. No carga ni decodifica videos: introduzca la relación, la plataforma y la ubicación para obtener una respuesta determinista útil en la planificación, la validación o un flujo de publicación automatizado.
Elija el destino antes de evaluar el archivo
La conformidad de la relación de aspecto depende de la ubicación, no solo del nombre de la plataforma. Un video normal de YouTube usa un marco horizontal, mientras que Shorts usa uno vertical. Instagram también distingue entre publicación vertical, publicación cuadrada, Reels y Stories. Seleccione el par exacto que represente el destino del recurso e indique la relación visible del video con el formato ancho:alto, por ejemplo 16:9, 9:16, 4:5 o 1:1. Se admiten decimales para formatos menos habituales. El comprobador normaliza los nombres de plataforma y ubicación a minúsculas, consulta el marco declarado y compara ambas proporciones numéricas. No examina nombres de archivo, resoluciones, etiquetas de rotación ni flujos codificados. Si una grabación móvil contiene orientación en sus metadatos, determine las dimensiones después de aplicar esa rotación y envíe la relación visible resultante. Las combinaciones no admitidas se rechazan expresamente, lo que evita aplicar por accidente una regla de publicación a una historia o reutilizar la convención de otra plataforma.
Interprete coincidencia, bandas y recorte
El resultado de coincidencia significa que la fuente y el destino tienen la misma forma matemática dentro de una tolerancia mínima de coma flotante. No hace falta adaptar su geometría. El resultado de bandas significa que la fuente es más estrecha que el marco de destino. Si se conserva la imagen completa, queda espacio sin usar en los lados, fenómeno llamado habitualmente pillarboxing aunque la API emplee la categoría general letterboxed. El resultado de recorte significa que la fuente es más ancha que el destino. Para llenar el marco a toda altura habría que quitar contenido de los bordes izquierdo y derecho. Estas etiquetas describen un ajuste geométrico centrado, no garantizan el comportamiento exacto de cada cargador. Una plataforma puede permitir un reencuadre manual, añadir un fondo difuminado, admitir varias proporciones o cambiar su producto. Use la respuesta para saber si hace falta revisión editorial. Ante un recorte, revise personas, subtítulos y logotipos próximos a los bordes; ante bandas, decida si conviene diseñar un fondo.
Compruebe antes de publicar o transcodificar
Ejecute la comprobación en cuanto asigne un destino, antes de invertir tiempo en el render final, la carga o la revisión multimedia. Un gestor de contenidos puede guardar la plataforma y ubicación previstas junto al recurso, calcular la relación visible a partir de metadatos fiables y llamar a esta capacidad como paso de validación. Las coincidencias pueden continuar automáticamente. Los resultados con bandas o recorte pueden abrir una tarea de revisión, seleccionar una versión alternativa preparada o enviar el recurso a otro cálculo de recorte. Conserve required_ratio en el registro de auditoría para que el editor sepa qué objetivo motivó la decisión. La respuesta también repite la plataforma, la ubicación y la relación normalizadas, lo que aclara los registros cuando una fuente se distribuye por varios canales. Esta capacidad no cambia tamaños, calcula zonas seguras, predice compresión ni afirma que la plataforma rechazará la carga. Por API, cada comprobación determinista cuesta $0.002 y no requiere transferir el archivo multimedia.
Qué puede hacer con ella
Valide recursos antes de programarlos
Detecte un formato incorrecto antes de que la cola publique el video en la ubicación elegida.
Seleccione la versión adecuada
Compare la fuente con el destino y dirija el trabajo a una versión horizontal, cuadrada, vertical o de retrato.
Cree una regla de revisión editorial
Envíe los recortes a revisar sus bordes y las bandas a definir un fondo o una composición.
Preguntas frecuentes
¿Qué significa que coincide?
La relación indicada tiene la misma forma numérica que el requisito almacenado para esa plataforma y ubicación.
¿Por qué indica que habrá bandas?
La fuente es más estrecha que el marco, por lo que conservarla completa dejaría bandas u otro fondo en los lados.
¿Qué significa recortado en este caso?
La fuente es más ancha que el destino, por lo que un ajuste centrado eliminaría parte de sus lados izquierdo y derecho.
¿La herramienta carga o edita el video?
No. Solo compara proporciones; no recibe, decodifica, almacena, redimensiona, recorta ni transcodifica archivos.
¿Cuánto cuesta una comprobación por API?
Cada solicitud API cuesta $0.002. No hay un cargo variable de procesamiento porque no se transfiere el video.
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, por email y desde Telegram — y pronto también desde nuestra app.
Llámela desde su stack
curl -X POST https://api.kit.forhosting.com/video/video-aspect-platform-check \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"ratio":"16:9","platform":"youtube","placement":"video"}'const res = await fetch("https://api.kit.forhosting.com/video/video-aspect-platform-check", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"ratio": "16:9",
"platform": "youtube",
"placement": "video"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/video/video-aspect-platform-check",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"ratio": "16:9",
"platform": "youtube",
"placement": "video"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/video/video-aspect-platform-check", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"ratio":"16:9","platform":"youtube","placement":"video"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"ratio":"16:9","platform":"youtube","placement":"video"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/video/video-aspect-platform-check", 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
{
"ratio": "16:9",
"platform": "youtube",
"placement": "video"
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "video.video_aspect_platform_check",
"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. |