Metadatos de un vídeo
Antes de transcodificar, enrutar, cobrar o rechazar un archivo de video, necesita saber qué es exactamente: cuánto dura, en qué códec viene, con qué resolución y bitrate. Este endpoint lee el contenedor y las pistas del archivo y devuelve esos datos de forma estructurada, sin que su script tenga que adivinar nada.
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 de no saber qué recibió
Un video subido puede resultar ser cualquier cosa: un contenedor distinto al esperado, una resolución que no coincide con el nombre del archivo, un bitrate variable que solo se nota a mitad del video, una pista de audio en un códec que su reproductor no soporta. La api metadatos de video existe para los sistemas que deben tomar una decisión en el momento en que llega un archivo, ya sea 'transcodificar esto', 'rechazar esto' o 'enviar esto a la cola correcta'.
Qué devuelve una llamada
POST /video/metadata recibe un enlace al archivo y, una vez procesado, devuelve duración, formato de contenedor, códec de video y de audio, resolución, cuadros por segundo, bitrate de cada pista y el número de pistas, todo como JSON estructurado y limpio, sin necesidad de analizar un volcado de texto.
Cómo funciona el flujo de la solicitud
Como toda tarea en la plataforma, esta es asíncrona: recibe un task_id apenas envía la solicitud, el archivo se inspecciona en segundo plano y el resultado llega mediante un webhook firmado en cuanto está listo, o mediante un enlace firmado que puede consultar usted mismo, válido por 24 horas.
Un poco de contexto sobre por qué los metadatos son desordenados
Los contenedores de video como MP4 o MKV son envoltorios que pueden alojar pistas codificadas en decenas de códecs distintos, cada uno con su propia manera de guardar duración y bitrate, y algunos archivos son generados por herramientas que escriben campos de encabezado inconsistentes o incompletos; una lectura de metadatos correcta tiene que examinar las pistas de verdad en vez de confiar ciegamente en el encabezado del contenedor, que es justo el trabajo que hace este endpoint por usted.
Dónde encaja dentro de una automatización
Como el resultado es estructurado y predecible, está pensado para ubicarse antes de otros pasos: un pipeline de transcodificación que solo convierte archivos por encima de cierto bitrate, un filtro de subida que rechaza cualquier video más largo de lo permitido, o un sistema de catálogo que necesita campos precisos de resolución y códec para cada archivo sin que nadie tenga que abrirlo manualmente.
Qué puede hacer con ella
Filtro de validación en la subida
Una plataforma revisa resolución y duración de cada archivo subido antes de aceptarlo, rechazando los que no cumplen el mínimo de calidad sin descargar el archivo completo primero.
Enrutamiento inteligente de transcodificación
Un pipeline de medios lee el códec y el bitrate para decidir si un archivo necesita recodificarse o puede servirse tal cual, evitando trabajos de transcodificación innecesarios.
Auditorías de almacenamiento y facturación
Un servicio de hosting extrae metadatos periódicamente de toda su biblioteca para calcular costos de almacenamiento reales según bitrate y duración, en lugar de estimaciones por tamaño de archivo.
Verificación de compatibilidad antes de reproducir
Una aplicación compara el códec de un video con los formatos soportados por el dispositivo de destino antes de intentar reproducirlo, evitando fallos de reproducción en el lado del usuario.
Preguntas frecuentes
¿Cómo obtengo los metadatos de un video con la API?
Envíe una solicitud POST a /video/metadata con un enlace al archivo; recibe un task_id de inmediato y los metadatos estructurados después por webhook o enlace firmado.
¿Qué campos devuelve la api metadatos de video?
Duración, formato del contenedor, códecs de video y audio, resolución, cuadros por segundo, bitrate y número de pistas, entregados como JSON estructurado.
¿Puedo probar la extracción de metadatos 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.
¿Funciona con cualquier formato de video?
Lee los contenedores y códecs habituales en producción de video, como MP4, MOV, MKV, WebM y sus combinaciones estándar de códec de audio y video.
¿Cuánto cuesta una solicitud de metadatos?
Cuesta $0.077 por solicitud más $0.0045 por video, publicado de forma abierta y sin unidades de crédito inventadas.
¿Se cobra si el archivo no se puede leer?
No, una tarea fallida se reintenta hasta tres veces y nunca se cobra si finalmente falla; en su lugar recibe un error claro.
¿Puedo usar esto para auditar una biblioteca de videos grande?
Sí, como cada solicitud se factura de forma individual y se procesa de manera asíncrona, escala de forma natural a corridas por lote mediante scripts sobre todo un catálogo.
¿El endpoint ya está disponible?
Está en despliegue final y todavía no acepta trabajos, con disponibilidad esperada muy pronto bajo el precio y el endpoint 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/metadata \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"input":"…"}'const res = await fetch("https://api.kit.forhosting.com/video/metadata", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"input": "…"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/video/metadata",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"input": "…"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/video/metadata", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"input":"…"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"input":"…"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/video/metadata", 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
{
"input": "…"
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "video.metadata",
"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. |