Skip to main content
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 der zurückgegebenen queue_id aufrufen, bis der Status completed ist
  3. Complete/video/complete aufrufen, um den Job abzuschließen und die Output-URL zu erhalten
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 -Upscale eines 720p-Videos ergibt etwas anderes als ein -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:

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 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.
Die Quote- und Queue-Endpoints benennen den Upscale-Faktor derzeit unterschiedlich: /video/queue nimmt upscale_factor (1, 2 oder 4), während /video/quote den Faktor aus resolution ("2x" oder "4x") liest. Das Senden von upscale_factor an den Quote-Endpoint hat keine Wirkung – er fällt auf den Default "2x" zurück und gibt einen 2x-Preis für einen möglicherweise 4x-Job zurück. Übergib beim Quoten eines 4x-Upscales resolution: "4x".

Fehlerbehebung