Guide
|
av Hunt Team

GTA VI-livestreams och VOD:er: klippning i stor skala med Hunt API

Lanseringsveckan för GTA VI betyder oändliga livestreams: reaktioner på reveal, kreatörsmaraton, esport-scrims och patchgenomgångar efter släppet. Produktteam, redaktioner och klippkanaler vill samma sak: göra en sändning till filer (hel VOD, 30-sekunders höjdpunkter, ljud för transkribering) utan att köra tung nedladdningslogik på sina egna servrar.

Den här guiden beskriver ett praktiskt arbetsflöde: när du ska anropa API:et, hur du väntar på en färdig VOD, hur du klipper med max_duration och hur du automatiserar med jobb och webhooks. Fokus ligger på livestreams och VOD:er, inte på en enskild plattform.

Först live, sedan VOD

En live-URL är ett rörligt mål. Tills streamern har avslutat sändningen och plattformen har bearbetat reprisen klart kan du oftast inte ladda ner en stabil, komplett fil. Pipelines som startar en nedladdning så fort någon går live misslyckas eller returnerar ofullständig data.

Justera dina arbetsflöden:

  1. Följ live-eventet (CMS, kalkylark eller bot).
  2. När streamen slutar byter du URL:en mot länken till reprisen / VOD:en (eller samma kanoniska URL, när plattformen visar en längd och en färdig inspelning).
  3. Först då anropar du Video Download, eller kontrollerar metadata först (se nedan).

Att försöka igen med samma live-URL i en loop slösar krediter och kötid. Schemalägg ett enda försök efter att streamen har slutat, eller fråga metadata tills längden är satt.

Steg 0: metadata (1 kredit, synkront)

Innan du använder ett nedladdningsjobb, kontrollera URL:en med Media Metadata:

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

Utifrån svaret bestämmer du:

  • Titel och miniatyr: katalogisera GTA VI-bevakning från dussintals kreatörer
  • Längd: hoppa över nedladdningar över din gräns och sätt max_duration för klipp
  • Live eller repris: om längden saknas eller sändningen pågår, starta inte den fullständiga VOD-nedladdningen än
{
  "metadata": {
    "title": "GTA VI launch night — full stream",
    "duration": 14422,
    "thumbnail": "https://…",
    "channel": "CreatorName",
    "webpage_url": "https://…"
  }
}

När du bevakar en lansering med stor volym är metadata det billigaste filtret.

Steg 1: starta en nedladdning (asynkront)

Hel repris för en redigerare eller ett arkiv:

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

Svar:

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

Höjdpunktsklipp (bara de första N sekunderna, användbart för ”bästa ögonblicket”-automationer när du redan vet tidsfönstret):

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

Endast ljud för transkribering (patchnoteringar, intervjuutdrag):

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

Nedladdningarna körs på Hunts infrastruktur, din app behåller bara job_id.

Steg 2: följ förloppet eller använd en webhook

Medan jobbet körs:

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

Fråga var 1–2 sekund, eller skicka med webhook_url i den första förfrågan så att Hunt skickar CDN-länken via POST när filen är klar:

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

Förloppsmodellen 0–100 förklaras i metadata och jobbförlopp.

Exempel: klipp-pipeline för GTA VI (pseudokod)

async function archiveSegment(vodUrl: string, maxSeconds = 60) {
  const meta = await hunt.get("/v1/media/metadata", { query: vodUrl });
  if (!meta.metadata?.duration) {
    throw new Error("Fortfarande live eller VOD inte klar, försök igen senare");
  }

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

Lägg detta bakom en kö (SQS, Bull, Windmill, n8n): ett jobb per VOD-URL när streamen har slutat, och skapa sedan klipp på din sida från huvudfilen med olika max_duration eller offset.

Vad team använder det till under GTA VI-säsongen

AnvändningsfallAPI-mönster
Reprisarkiv för redaktionerFullständig audio_video-nedladdning när VOD:en är uppe
Klipp för sociala mediermax_duration + bara video, 720p
Podcast / citatjaktdownload_type=audio
Dashboard för kreatörsbevakningBara metadata tills längden dyker upp
Nattlig batchwebhook_url, ingen polling

Begränsningar att planera för

  • Live-URL:er: vänta på den färdiga reprisen; gör inte ”fortfarande live” till en retry-loop.
  • Mycket långa maraton: kvaliteten kan begränsas till 720p för videor över en timme (se Video Download).
  • Rättigheter: Hunt API hämtar det som URL:en exponerar; din produkt måste ändå ha kreatörernas samtycke och följa plattformarnas villkor.

Kom igång

  1. Skapa en nyckel på app.huntapi.com.
  2. Testa metadata på en URL till en färdig VOD.
  3. Starta en nedladdning med en webhook.
  4. Lägg till max_duration när nedladdningen av hela filen fungerar.

För agentstyrda arbetsflöden finns samma endpoints via Hunt API MCP: din assistent startar jobben och du behåller samma asynkrona ordning (metadata → VOD → klipp).

VIDEO API

Discover why Hunt is the preferred API provider for developers.