Livestreams y VOD de GTA VI: clipping a escala con la API de Hunt
La semana de lanzamiento de GTA VI significa livestreams sin fin: reacciones al reveal, maratones de creadores, scrims de esports y análisis de parches tras el lanzamiento. Equipos de producto, redacciones y canales de clips quieren lo mismo: convertir una emisión en archivos (VOD completo, highlights de 30 segundos, audio para transcribir) sin ejecutar una lógica de descarga pesada en sus propios servidores.
Esta guía describe un flujo práctico: cuándo llamar a la API, cómo esperar a un VOD terminado, cómo recortar clips con max_duration y cómo automatizar con jobs y webhooks. Nos centramos en livestreams y VOD, no en la marca de una plataforma concreta.
Primero el directo, después el VOD
Una URL en directo es un objetivo móvil. Hasta que el streamer termina la emisión y la plataforma acaba de procesar el replay, normalmente no puedes descargar un archivo estable y completo. Los pipelines que lanzan una descarga en cuanto alguien empieza el directo fallan o devuelven datos parciales.
Corrige tus flujos:
- Sigue el evento en directo (CMS, hoja de cálculo o bot).
- Cuando el stream termine, cambia la URL por el enlace del replay / VOD (o la misma URL canónica, cuando la plataforma muestre una duración y una grabación terminada).
- Solo entonces llama a Video Download o consulta primero los metadatos (ver abajo).
Reintentar la misma URL en directo en bucle desperdicia créditos y tiempo de cola. Programa un único intento después de que termine el stream, o consulta los metadatos hasta que aparezca la duración.
Paso 0: metadatos (1 crédito, síncrono)
Antes de gastar un job de descarga, inspecciona la URL con Media Metadata:
GET https://api.huntapi.com/v1/media/metadata?query=https://www.twitch.tv/videos/1234567890
x-api-key: YOUR_API_KEY
Usa la respuesta para decidir:
- Título y miniatura: catalogar la cobertura de GTA VI de decenas de creadores
- Duración: saltar descargas por encima de tu límite y fijar
max_durationpara los clips - Directo o replay: si falta la duración o la emisión sigue activa, no lances todavía la descarga completa del VOD
{
"metadata": {
"title": "GTA VI launch night — full stream",
"duration": 14422,
"thumbnail": "https://…",
"channel": "CreatorName",
"webpage_url": "https://…"
}
}
Para vigilar un lanzamiento con mucho volumen, los metadatos son el filtro más barato.
Paso 1: lanzar una descarga (asíncrona)
Replay completo para un editor o un archivo:
GET https://api.huntapi.com/v1/video/download?query=https://www.twitch.tv/videos/1234567890&video_quality=720p&download_type=audio_video&video_format=mp4
x-api-key: YOUR_API_KEY
Respuesta:
{
"job_id": "019bd4a1-7c3e-7f2a-9d11-88a0c4e91f02"
}
Clip destacado (solo los primeros N segundos, útil para automatizar el “mejor momento” cuando ya conoces la ventana de tiempo):
GET https://api.huntapi.com/v1/video/download?query=…&max_duration=45&video_quality=720p&download_type=video
x-api-key: YOUR_API_KEY
Solo audio para transcripción (notas de parche, fragmentos de entrevistas):
GET https://api.huntapi.com/v1/video/download?query=…&download_type=audio
x-api-key: YOUR_API_KEY
Las descargas se ejecutan en la infraestructura de Hunt: tu aplicación solo guarda el job_id.
Paso 2: consultar el progreso o usar un webhook
Mientras el job se ejecuta:
GET https://api.huntapi.com/v1/jobs/019bd4a1-7c3e-7f2a-9d11-88a0c4e91f02
x-api-key: YOUR_API_KEY
{
"status": "Running",
"progress": 64,
"endpoint": "/api/video/download"
}
Consulta cada 1–2 segundos, o pasa webhook_url en la petición inicial para que Hunt envíe por POST el enlace CDN cuando el archivo esté listo:
GET https://api.huntapi.com/v1/video/download?query=…&webhook_url=https://your.app/hooks/hunt-video
El modelo de progreso 0–100 se explica en metadatos y progreso de jobs.
Ejemplo: pipeline de clips de GTA VI (pseudocódigo)
async function archiveSegment(vodUrl: string, maxSeconds = 60) {
const meta = await hunt.get("/v1/media/metadata", { query: vodUrl });
if (!meta.metadata?.duration) {
throw new Error("Sigue en directo o el VOD no está listo, reintentar más tarde");
}
const { job_id } = await hunt.get("/v1/video/download", {
query: vodUrl,
max_duration: maxSeconds,
video_quality: "720p",
download_type: "video",
webhook_url: process.env.HUNT_WEBHOOK,
});
return job_id;
}
Ponlo detrás de una cola (SQS, Bull, Windmill, n8n): un job por URL de VOD cuando termina el stream y, una vez tengas el archivo maestro, genera los clips por tu lado con distintos max_duration u offsets.
Para qué lo usan los equipos durante la temporada de GTA VI
| Caso de uso | Patrón de API |
|---|---|
| Archivo de replays para redacciones | Descarga audio_video completa cuando el VOD está publicado |
| Clips para redes sociales | max_duration + solo video, 720p |
| Podcast / extracción de citas | download_type=audio |
| Panel de seguimiento de creadores | Solo metadatos hasta que aparezca la duración |
| Lote nocturno | webhook_url, sin polling |
Límites a tener en cuenta
- URLs en directo: espera al replay terminado; no conviertas un “sigue en directo” en un bucle de reintentos.
- Maratones muy largos: la calidad puede limitarse a 720p en vídeos de más de una hora (ver Video Download).
- Derechos: la API de Hunt obtiene lo que expone la URL; tu producto sigue necesitando el consentimiento de los creadores y cumplir los términos de las plataformas.
Empezar
- Crea una clave en app.huntapi.com.
- Prueba los metadatos con una URL de VOD terminado.
- Lanza una descarga con un webhook.
- Añade
max_durationcuando la descarga del archivo completo funcione.
Para flujos guiados por agentes, los mismos endpoints están disponibles mediante el MCP de Hunt API: tu asistente lanza los jobs y tú mantienes el mismo orden asíncrono (metadatos → VOD → clip).