Guide
|
por Hunt Team

Livestreams e VODs de GTA VI: clipping em escala com a API Hunt

A semana de lançamento de GTA VI significa livestreams sem fim: reações ao reveal, maratonas de criadores, scrims de esports e análises de patches depois do lançamento. Times de produto, redações e canais de clipes querem a mesma coisa: transformar uma transmissão em arquivos (VOD completo, destaques de 30 segundos, áudio para transcrição) sem rodar uma lógica pesada de download nos próprios servidores.

Este guia mostra um fluxo prático: quando chamar a API, como esperar um VOD finalizado, como cortar clipes com max_duration e como automatizar com jobs e webhooks. O foco é em livestreams e VODs, não na marca de uma plataforma específica.

Primeiro a live, depois o VOD

Uma URL ao vivo é um alvo em movimento. Até o streamer encerrar a transmissão e a plataforma terminar de processar o replay, em geral você não consegue baixar um arquivo estável e completo. Pipelines que disparam um download assim que alguém entra ao vivo falham ou retornam dados parciais.

Ajuste seus fluxos:

  1. Acompanhe o evento ao vivo (CMS, planilha ou bot).
  2. Quando a stream terminar, troque a URL pelo link do replay / VOD (ou pela mesma URL canônica, quando a plataforma exibir uma duração e uma gravação finalizada).
  3. Só então chame o Video Download ou consulte os metadados antes (veja abaixo).

Repetir a mesma URL ao vivo em loop desperdiça créditos e tempo de fila. Agende uma única tentativa depois do fim da stream, ou consulte os metadados até a duração aparecer.

Etapa 0: metadados (1 crédito, síncrono)

Antes de gastar um job de download, inspecione a URL com o Media Metadata:

GET https://api.huntapi.com/v1/media/metadata?query=https://www.twitch.tv/videos/1234567890
x-api-key: YOUR_API_KEY

Use a resposta para decidir:

  • Título e thumbnail: catalogar a cobertura de GTA VI de dezenas de criadores
  • Duração: pular downloads acima do seu limite e definir max_duration para os clipes
  • Live ou replay: se a duração estiver ausente ou a transmissão ainda estiver ativa, não inicie o download completo do VOD ainda
{
  "metadata": {
    "title": "GTA VI launch night — full stream",
    "duration": 14422,
    "thumbnail": "https://…",
    "channel": "CreatorName",
    "webpage_url": "https://…"
  }
}

Para monitorar um lançamento com muito volume, os metadados são o filtro mais barato.

Etapa 1: iniciar um download (assíncrono)

Replay completo para um editor ou arquivo:

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

Resposta:

{
  "job_id": "019bd4a1-7c3e-7f2a-9d11-88a0c4e91f02"
}

Clipe de destaque (apenas os primeiros N segundos, útil para automatizar o “melhor momento” quando você já conhece a janela de tempo):

GET https://api.huntapi.com/v1/video/download?query=…&max_duration=45&video_quality=720p&download_type=video
x-api-key: YOUR_API_KEY

Somente áudio para transcrição (notas de patch, trechos de entrevistas):

GET https://api.huntapi.com/v1/video/download?query=…&download_type=audio
x-api-key: YOUR_API_KEY

Os downloads rodam na infraestrutura da Hunt: sua aplicação só guarda o job_id.

Etapa 2: acompanhar o progresso ou usar um webhook

Enquanto o job roda:

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"
}

Consulte a cada 1–2 segundos, ou passe webhook_url na requisição inicial para que a Hunt envie por POST o link da CDN quando o arquivo estiver pronto:

GET https://api.huntapi.com/v1/video/download?query=…&webhook_url=https://your.app/hooks/hunt-video

O modelo de progresso 0–100 está explicado em metadados e progresso de jobs.

Exemplo: pipeline de clipes 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("Ainda ao vivo ou VOD não está pronto, tentar mais 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;
}

Coloque isso atrás de uma fila (SQS, Bull, Windmill, n8n): um job por URL de VOD depois que a stream termina e, com o arquivo principal em mãos, gere os clipes do seu lado com diferentes max_duration ou offsets.

Para que os times usam isso na temporada de GTA VI

Caso de usoPadrão de API
Arquivo de replays para redaçõesDownload audio_video completo quando o VOD estiver no ar
Clipes para redes sociaismax_duration + somente video, 720p
Podcast / garimpo de citaçõesdownload_type=audio
Painel de monitoramento de criadoresSó metadados até a duração aparecer
Lote noturnowebhook_url, sem polling

Limites para planejar

  • URLs ao vivo: espere o replay finalizado; não transforme “ainda ao vivo” em um loop de tentativas.
  • Maratonas muito longas: a qualidade pode ficar limitada a 720p em vídeos com mais de uma hora (veja Video Download).
  • Direitos: a API Hunt busca o que a URL expõe; seu produto ainda precisa do consentimento dos criadores e de respeitar os termos das plataformas.

Comece agora

  1. Crie uma chave em app.huntapi.com.
  2. Teste os metadados em uma URL de VOD finalizado.
  3. Dispare um download com webhook.
  4. Adicione max_duration quando o download do arquivo completo estiver funcionando.

Para fluxos conduzidos por agentes, os mesmos endpoints estão disponíveis pelo MCP da Hunt API: seu assistente dispara os jobs e você mantém a mesma ordem assíncrona (metadados → VOD → clipe).

VIDEO API

Discover why Hunt is the preferred API provider for developers.