Zum Hauptinhalt springen
Mit Video-Upscaling kannst du vorhandene Videos in höhere Auflösungen heben und gleichzeitig die visuelle Qualität verbessern. Das Topaz-Video-Upscale-Modell nutzt KI-basiertes Upscaling, um die Auflösung 2× oder 4× zu erhöhen, oder wendet bei 1× eine Qualitätsverbesserung in der Original-Auflösung an.

Wie es funktioniert

Video-Upscaling nutzt dasselbe asynchrone Queue-System wie die Videogenerierung:
  1. Queue — Video an /video/queue mit Modell topaz-video-upscale senden
  2. Poll — /video/retrieve mit model und der zurückgegebenen queue_id aufrufen. Während der Job läuft, kommt JSON mit "status": "PROCESSING" zurück. Ist der Job fertig, ist der Response-Body das hochskalierte MP4 (Content-Type: video/mp4), also speicherst du ihn in einer Datei. Es gibt keine Output-URL.
  3. Aufräumen (optional) — Nachdem du die Datei gespeichert hast, /video/complete aufrufen, um den gespeicherten Output zu löschen
Der Server erkennt Dauer, Bildrate und Dimensionen des Input-Videos automatisch aus der hochgeladenen Datei. Du musst diese Werte nicht angeben – die Abrechnung erfolgt anhand der tatsächlichen Videometadaten.

Upscale-Faktoren

Der Parameter upscale_factor ersetzt resolution bei Upscale-Modellen. Wird resolution übergeben, gibt es einen Fehler. Das liegt daran, dass die Output-Auflösung von den Input-Dimensionen abhängt – ein 2×-Upscale eines 720p-Videos ergibt etwas anderes als ein 2×-Upscale eines 480p-Videos.

Unterstützte Eingabeformate

  • Formate: MP4, MOV, WebM
  • Input-Methoden: HTTPS-URL oder data:video/...;base64,...-Data-URL
  • Max. Dauer: 300 Sekunden (5 Minuten)

API-Nutzung

Upscale-Job in die Queue stellen

Die Antwort enthält eine queue_id, um den Job zu verfolgen:

Pollen und Ergebnis speichern

Das fertige Upscale ist der Response-Body selbst, kein JSON-Feld. Prüfe daher Content-Type, bevor du die Antwort parst. Das cURL-Beispiel gibt den Content-Type jeder Antwort aus: Wiederhole den Aufruf, bis video/mp4 ausgegeben wird. Dann enthält upscaled.mp4 das Video. Wenn die Queue-Antwort eine download_url enthielt, gibt retrieve stattdessen JSON mit "status": "COMPLETED" zurück, und du lädst die Datei von dieser URL herunter. Siehe Private Download-Links.

Aufräumen (optional)

Nachdem du das MP4 gespeichert hast, kannst du /video/complete aufrufen, um den gespeicherten Output zu löschen. Der Aufruf gibt weder das Video noch eine URL zurück.

API-Parameter

Bei Upscale-Modellen nicht verwendete Parameter

Die folgenden Parameter werden bei topaz-video-upscale nicht akzeptiert und führen zu einem Fehler: Der Parameter duration wird ebenfalls ignoriert – der Server erkennt die Dauer für die Abrechnungsgenauigkeit direkt aus der Videodatei.

Preise

Die Preise basieren auf Dauer, Output-Auflösungs-Tier und Bildrate. Der Output-Auflösungs-Tier ergibt sich aus der Höhe des Input-Videos multipliziert mit dem Upscale-Faktor.

Output-Auflösungs-Tiers

Videos mit Bildraten über 48 fps kosten das 2-fache der Pro-Sekunde-Rate.

Preisbeispiele

Nutze die Video-Quote-API, um vor dem Einreichen die genauen Kosten zu erhalten.

Quote abrufen

video_url ist für Quotes auf Upscale-Modellen erforderlich – der Quote-Endpoint ruft die Datei ab und ermittelt Dauer, FPS und Höhe aus den Bytes, sodass du sie nicht angeben musst. Wird es weggelassen, kommt 400 mit “video_url is required for quotes on this model” zurück. Quotes für Upscale-Modelle erfordern einen API-Schlüssel. Requests ohne Schlüssel geben 403 zurück. Übergib an /video/quote denselben upscale_factor (1, 2 oder 4), den du auch an /video/queue senden wirst, damit das Quote zum Job passt. Quote akzeptiert bei Upscale-Modellen außerdem resolution ("2x" oder "4x") als veralteten Alias; werden beide gesendet, hat upscale_factor Vorrang.

Fehlerbehebung