550W Video Eraser API für Untertitel und Bild-Wasserzeichen

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

Die 550W Entwickler-API ermöglicht es einem Backend, Video-Untertitel- oder Text-Löschaufträge sowie Bild-Wasserzeichen-Entfernungsaufträge einzureichen, ohne Benutzer durch einen manuellen Editor zu führen. Sie ist konzipiert für Creator-Plattformen, Lokalisierungs-Pipelines, Medienbibliotheken und interne Tools, die wiederholt Inhalte verarbeiten, die der Organisation gehören oder deren Bearbeitung lizenziert ist.

Video-Untertitel und Text löschen

Für Videos reichen Sie MP4- oder MOV-Material über /open/uploadVideo ein oder geben eine öffentliche videoUrl an /open/submitTask. Die Anfrage enthält Videoabmessungen, Dauer und das zu reparierende Rechteck. Video-Aufträge werden asynchron ausgeführt und können über /open/taskDetail oder /open/taskList überprüft werden.

Bild-Wasserzeichen-Entfernung

Für Bilder akzeptiert /open/removeImageWatermark JPG-, PNG-, BMP-, WebP-, AVIF-, TIFF- oder SVG-Dateien bis zu 50 MB. Es kann auf ein Ergebnis warten oder einen Verarbeitungsauftrag zur späteren Abfrage zurückgeben. Die Eraser Entwickler-API bietet keinen Video-Link-Wasserzeichen-Download an, daher sollten Integrationen diese Funktion nicht versprechen.

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 HTTPS-URL bereitgestellt werden.

Authentifizieren und hochladen

Reichen Sie /open/submitTask mit width, height, duration und x1, y1, x2, y2 ein. Ein enges Rechteck bewahrt normalerweise mehr Details als eine Vollbild-Reparatur. Verwenden Sie mode=protect, wenn der unterstützte Workflow eine konservative Rekonstruktion erfordert, und removeAudio nur, wenn Audio 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 HTTPS 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

Hochgeladene Videos unterstützen MP4 und MOV, eine maximale Dateigröße von 1 GB, Dauer bis zu 600 Sekunden und Verarbeitung bis zu 1080p innerhalb der dokumentierten Abmessungsregeln. Validieren Sie Format, Dauer, Abmessungen, Bittiefe und HDR-Status vor der Einreichung, damit keine nicht unterstützten Medien in die kostenpflichtige Warteschlange gelangen.

Vor dem Verbrauch von Credits validieren

Die Qualität hängt davon ab, was sich hinter dem Untertitel oder Text bewegt. Flache Wände, Himmel und sich langsam ändernde Landschaften sind normalerweise einfacher als Hände, Haare, gemusterte Kleidung, Reflexionen oder schnelle Kamerabewegungen. Erstellen Sie eine Review-Warteschlange für Grenzfälle und vergleichen Sie die gesamte Timeline, nicht nur ein Thumbnail.

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

Erfolgreiche Antworten enthalten code und message; Auftragsantworten zeigen zusätzlich status und bei Abschluss resultUrl. Fehlgeschlagene Aufträge können failCode, failReason und refundStatus enthalten. Wiederholen Sie vorübergehende Transport- oder interne Fehler mit exponentiellem Backoff, aber wiederholen Sie nicht blind Parameterfehler, nicht unterstützte Medien, gesperrte Konten oder unzureichende Credit-Fehler.

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.