Wie es funktioniert
Video-Upscaling nutzt dasselbe asynchrone Queue-System wie die Videogenerierung:- Queue — Video an
/video/queuemit Modelltopaz-video-upscalesenden - Poll —
/video/retrievemit der zurückgegebenenqueue_idaufrufen, bis der Statuscompletedist - Complete —
/video/completeaufrufen, um den Job abzuschließen und die Output-URL zu erhalten
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
queue_id, um den Job zu verfolgen:
Auf Fertigstellung pollen
Mit Complete abschließen
Nach dem Abruf des Ergebnisses/video/complete aufrufen, um den Job zu finalisieren:
API-Parameter
Bei Upscale-Modellen nicht verwendete Parameter
Die folgenden Parameter werden beitopaz-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.