Guide
|
von Hunt Team

GTA VI Livestreams und VODs: Clipping im großen Stil mit der Hunt API

Die Launch-Woche von GTA VI bedeutet endlose Livestreams: Reaktionen auf den Reveal, Creator-Marathons, E-Sport-Scrims und Patch-Analysen nach dem Release. Produktteams, Redaktionen und Clip-Kanäle wollen alle dasselbe: aus einer Übertragung Dateien machen (komplette VOD, 30-Sekunden-Highlights, Audio für die Transkription), ohne schwere Download-Logik auf den eigenen Servern zu betreiben.

Dieser Guide zeigt einen praktischen Workflow: wann du die API aufrufst, wie du auf eine fertige VOD wartest, wie du mit max_duration clippst und wie du mit Jobs und Webhooks automatisierst. Der Fokus liegt auf Livestreams und VODs, nicht auf einer bestimmten Plattform.

Erst live, dann VOD

Eine Live-URL ist ein bewegliches Ziel. Solange der Streamer nicht beendet hat und die Plattform das Replay nicht fertig verarbeitet hat, kannst du in der Regel keine stabile, vollständige Datei herunterladen. Pipelines, die einen Download starten, sobald jemand live geht, schlagen fehl oder liefern unvollständige Daten.

Passe deine Workflows an:

  1. Verfolge das Live-Event (CMS, Tabelle oder Bot).
  2. Wenn der Stream endet, ersetze die URL durch den Replay- / VOD-Link (oder dieselbe kanonische URL, sobald die Plattform eine Dauer und eine fertige Aufnahme anzeigt).
  3. Erst dann rufst du Video Download auf oder prüfst zuerst die Metadaten (siehe unten).

Wer dieselbe Live-URL in einer Schleife erneut versucht, verschwendet Credits und Wartezeit. Plane einen einzigen Versuch nach dem Ende des Streams ein oder frage die Metadaten ab, bis die Dauer gesetzt ist.

Schritt 0: Metadaten (1 Credit, synchron)

Bevor du einen Download-Job startest, prüfe die URL mit Media Metadata:

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

Anhand der Antwort entscheidest du:

  • Titel und Thumbnail: GTA VI Coverage von Dutzenden Creators katalogisieren
  • Dauer: Downloads über deinem Limit überspringen, max_duration für Clips setzen
  • Live oder Replay: Fehlt die Dauer oder läuft die Übertragung noch, startest du den vollständigen VOD-Download noch nicht
{
  "metadata": {
    "title": "GTA VI launch night — full stream",
    "duration": 14422,
    "thumbnail": "https://…",
    "channel": "CreatorName",
    "webpage_url": "https://…"
  }
}

Beim Monitoring eines Launches mit hohem Volumen sind Metadaten der günstigste Filter.

Schritt 1: Download starten (asynchron)

Komplettes Replay für Editor oder Archiv:

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

Antwort:

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

Highlight-Clip (nur die ersten N Sekunden, nützlich für „Best Moment“-Automationen, wenn du das Zeitfenster schon kennst):

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

Nur Audio für die Transkription (Patch Notes, Interview-Ausschnitte):

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

Die Downloads laufen auf der Hunt-Infrastruktur, deine App hält nur die job_id.

Schritt 2: Fortschritt abfragen oder Webhook nutzen

Während der Job läuft:

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

Frage alle 1–2 Sekunden ab oder übergib webhook_url beim ersten Request, damit Hunt den CDN-Link per POST schickt, sobald die Datei bereit ist:

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

Das Fortschrittsmodell 0–100 erklärt der Artikel zur Job-Fortschrittsanzeige.

Beispiel: GTA VI Clip-Pipeline (Pseudocode)

async function archiveSegment(vodUrl: string, maxSeconds = 60) {
  const meta = await hunt.get("/v1/media/metadata", { query: vodUrl });
  if (!meta.metadata?.duration) {
    throw new Error("Noch live oder VOD nicht bereit, später erneut versuchen");
  }

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

Hänge das hinter eine Queue (SQS, Bull, Windmill, n8n): ein Job pro VOD-URL nach Streamende, danach erzeugst du auf deiner Seite aus der Masterdatei die Clips mit unterschiedlichem max_duration oder Offsets.

Wofür Teams das in der GTA VI Saison nutzen

Use CaseAPI-Pattern
Replay-Archiv für RedaktionenKompletter audio_video-Download, sobald die VOD online ist
Social Clippingmax_duration + nur video, 720p
Podcast / Zitate sammelndownload_type=audio
Creator-Monitoring-DashboardNur Metadaten, bis die Dauer erscheint
Nächtlicher Batchwebhook_url, kein Polling

Grenzen, die du einplanen solltest

  • Live-URLs: Warte auf das fertige Replay, behandle „noch live“ nicht als Retry-Schleife.
  • Sehr lange Marathons: Bei Videos über einer Stunde kann die Qualität auf 720p begrenzt sein (siehe Video Download).
  • Rechte: Die Hunt API holt, was die URL bereitstellt; dein Produkt muss trotzdem Einwilligungen und Plattformbedingungen einhalten.

Loslegen

  1. Erstelle einen Key auf app.huntapi.com.
  2. Teste die Metadaten mit einer fertigen VOD-URL.
  3. Starte einen Download mit Webhook.
  4. Füge max_duration hinzu, sobald der Weg zur kompletten Datei funktioniert.

Für agentengesteuerte Workflows gibt es dieselben Endpoints über den Hunt API MCP: Dein Assistent startet die Jobs, und du behältst die asynchrone Reihenfolge bei (Metadaten → VOD → Clip).

VIDEO API

Discover why Hunt is the preferred API provider for developers.