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

Der Quote-Endpoint akzeptiert input_height, um den Output-Auflösungs-Tier zu schätzen. Das ist optional – wird es weggelassen, geht das Quote von einer konservativen Schätzung aus.

Fehlerbehebung