Video Eraser API für Videountertitel, Videowasserzeichen und Bildwasserzeichen

Was die 550W Entwickler-API tatsächlich unterstützt

Über die 550W Entwickler-API kann ein Server autorisierte Aufträge für Video-Untertitel oder sichtbare Wasserzeichen in einem ausgewählten Rechteck sowie für Bild-Wasserzeichen senden. Der API-Zugang verleiht keine Rechte am Ausgangsmaterial; Ergebnisse müssen weiterhin geprüft werden.

Video-Untertitel und Wasserzeichen entfernen

Laden Sie für Video eine MP4- oder MOV-Datei über /open/uploadVideo hoch oder geben Sie bei /open/submitTask eine öffentliche videoUrl an. Übermitteln Sie Abmessungen, Dauer und das zu bearbeitende Rechteck. Den asynchronen Auftrag verfolgen Sie mit /open/taskDetail oder /open/taskList.

Bild-Wasserzeichen-Entfernung

/open/removeImageWatermark akzeptiert JPG, PNG, BMP, WebP, AVIF, TIFF und SVG bis 50 MB. Der Aufruf liefert entweder ein Ergebnis oder einen später abrufbaren Auftrag. Die API lädt keine Videos mit Wasserzeichen über einen Link herunter; bieten Sie diese Funktion daher nicht an.

Verwenden Sie die API für autorisierte Video-Untertitel/Text-Bereinigung und Bild-Wasserzeichen-Entfernung; halten Sie nicht unterstützte Video-Link-Wasserzeichen-Workflows aus Ihrem Produktversprechen heraus.

Ein produktionsreifer Anfrageworkflow

Jede Anfrage wird mit userNo und apiKey authentifiziert. Beide Werte sollten auf Ihrem Server bleiben: Wenn ein API-Schlüssel im Browser oder in mobilem Client-Code platziert wird, kann er von Benutzern und Erweiterungen wiederhergestellt werden. Ein Video kann zuerst hochgeladen oder als öffentlich erreichbare HTTP(S)-URL bereitgestellt werden.

Authentifizieren und hochladen

Senden Sie /open/submitTask mit width, height, duration und x1, y1, x2, y2. Im Standardmodus (mode=normal, Standardwert) wird der Bereich innerhalb des Rechtecks bearbeitet. Protect (mode=protect) lässt den Bereich im Rechteck unverändert und bearbeitet die Fläche außerhalb; es ist kein Modus für höhere Qualität. Setzen Sie removeAudio nur, wenn der Ton vor der Verarbeitung entfernt werden soll.

Einen idempotenten Auftrag einreichen

Senden Sie einen Idempotency-Key von maximal 128 Zeichen für eine wiederholungssichere Erstellung. Wenn eine Verbindung nach der Einreichung unterbrochen wird, wiederholen Sie mit demselben Schlüssel, anstatt einen zweiten kostenpflichtigen Auftrag zu erstellen. Speichern Sie die zurückgegebene taskId zusammen mit Ihrer eigenen Asset-ID.

Ergebnis empfangen und überprüfen

Für die asynchrone Zustellung geben Sie eine öffentliche HTTP(S) callbackUrl an. Der webhook wird ausgelöst, wenn der Auftrag einen endgültigen Zustand erreicht. Ihr Handler sollte schnell bestätigen, den Auftrag erneut über /open/taskDetail überprüfen und mehrfache Webhook-Zustellungen als normal behandeln. Polling bleibt als Recovery-Pfad nützlich, wenn ein Callback verzögert wird.

Serverseitige Anmeldedaten, Idempotenz, dauerhafte Auftrag-IDs und Webhook-Überprüfung machen Wiederholungen sicher und beobachtbar.

Eingabelimits und Qualitätskontrollen

Die Eingaberegeln der API können von denen des Webeditors abweichen. Prüfen Sie die aktuelle Dokumentation und validieren Sie Format, Dauer, Abmessungen, Bittiefe und HDR, bevor ein kostenpflichtiger Auftrag entsteht.

Vor dem Verbrauch von Credits validieren

Das Ergebnis hängt von Details und Bewegung rund um den Text ab. Himmel oder eine gleichmäßige Wand sind meist einfacher als Hände, Haare, gemusterte Kleidung oder Spiegelungen. Sehen Sie sich das ganze Video an, besonders Szenen mit wechselndem Hintergrund.

Schwieriges Material überprüfen

Bildaufträge unterstützen gängige Web- und Designformate und kosten eine feste Anzahl von Credits pro erfolgreichem Auftrag gemäß der aktuellen API-Seite. Bewahren Sie die Quelldatei auf und speichern Sie das Ergebnis als Derivat; die Wasserzeichen-Entfernung erstellt keine Urheberrechts- oder Handelsnutzungsgenehmigung.

Lehnen Sie nicht unterstützte Eingaben frühzeitig ab und erfordern Sie eine menschliche Überprüfung, wenn der Reparaturbereich wichtige bewegte Details überschreitet.

Abrechnung, Fehler und Wiederholungsrichtlinie

Die Video-Untertitelentfernung wird nach Dauer und Auflösung abgerechnet. Der aktuelle Tarif beträgt 1,3 Credits pro Sekunde bei 720p oder niedriger und 1,6 Credits pro Sekunde über 720p bis 1080p. Ein 30-Sekunden-Video mit 1280×720 ist daher etwa 39 Credits, während ein 30-Sekunden-Video mit 1920×1080 etwa 48 Credits ist. Fragen Sie /open/queryCredits ab, bevor Sie einen großen Batch akzeptieren.

Kosten vor der Einreichung schätzen

Antworten enthalten code und message. Aufträge können außerdem status, resultUrl und bei Fehlern failCode, failReason sowie refundStatus liefern. Wiederholen Sie vorübergehende Fehler mit wachsenden Wartezeiten; korrigieren Sie zuvor ungültige Parameter, ungeeignete Dateien oder zu wenig Guthaben.

Stabile Fehlerfelder behandeln

Protokollieren Sie Einreichungslatenz, Abschlusslatenz, Fehlerrate, Review-Ablehnungsrate und Kosten pro genehmigtem Asset. Diese Metriken zeigen, ob die Automatisierung den Workflow verbessert, anstatt manuelle Arbeit nur downstream zu verschieben.

Eine nützliche Integration misst genehmigte Ausgabe und effektive Kosten, nicht nur erfolgreiche HTTP-Antworten.

Die Integration in vier Schritten starten

Generieren Sie zunächst einen API-Schlüssel von der lokalisierten 550W Entwicklerseite und reichen Sie ein repräsentatives Video ein. Implementieren Sie dann die Auftragssuche und zeigen Sie Warte-, Verarbeitungs-, Erfolgs- und Fehlerzustände in Ihrem eigenen Produkt an. Fügen Sie Idempotenz und einen webhook mit Polling-Recovery hinzu. Führen Sie schließlich einen kontrollierten Batch aus und überprüfen Sie jede Ausgabe, bevor Sie die Parallelität erhöhen.

Vor dem Skalieren pilotieren

Verwenden Sie separate Entwicklungs- und Produktionskontrollen, rotieren Sie freigelegte Anmeldedaten, beschränken Sie den Zugriff auf Quellmedien und halten Sie eine Löschrichtlinie für Ergebnisse ein. Teams mit klaren Abnahmekriterien können die API dann mit einem DAM, CMS, einer Lokalisierungs-Warteschlange oder einem Creator-Upload-Workflow verbinden, ohne die redaktionelle Überprüfung zu opfern.