Video Eraser API voor ondertitels en watermerken in video en beeld

Wat de 550W developer API daadwerkelijk ondersteunt

Met de 550W ontwikkelaars-API kan een server geautoriseerde taken indienen voor video-ondertitels of zichtbare watermerken binnen een geselecteerd kader, en voor watermerken in afbeeldingen. API-toegang verleent geen rechten op bronmateriaal; controleer de resultaten altijd.

Video-ondertitels en watermerken verwerken

Upload een MP4- of MOV-bestand via /open/uploadVideo of geef bij /open/submitTask een openbare videoUrl op. Stuur afmetingen, duur en het te bewerken kader mee. De opdracht draait op de achtergrond; controleer de status via /open/taskDetail of /open/taskList.

Afbeeldingswatermerkverwijdering

/open/removeImageWatermark accepteert JPG, PNG, BMP, WebP, AVIF, TIFF en SVG tot 50 MB. De aanroep kan meteen een resultaat of een later op te vragen taak opleveren. Deze API downloadt geen video met watermerk via een link; bied die mogelijkheid niet aan.

Gebruik de API voor toegestane video- en afbeeldingsbewerking. Bied geen download van video met watermerk via een link aan.

Een productierijpe aanvraagstroom

Elke aanvraag wordt geverifieerd met userNo en apiKey. Bewaar beide waarden op uw server: een API-sleutel in browser of mobiele clientcode plaatsen maakt deze herstelbaar door gebruikers en extensies. Een video kan eerst worden geüpload of worden geleverd als een openbaar bereikbare HTTP(S)-URL.

Authenticeren en uploaden

Stuur width, height, duration en x1, y1, x2, y2 mee naar /open/submitTask. Standard (mode=normal, standaardinstelling) bewerkt het gebied binnen het kader. Protect (mode=protect) behoudt de inhoud van het kader en bewerkt de buitenkant; het is geen stand met hogere kwaliteit. Gebruik removeAudio alleen als het geluid weg moet.

Dien een idempotente taak in

Geef voor elke logische opdracht een Idempotency-Key van maximaal 128 tekens mee. Valt de verbinding na verzending weg, gebruik dan bij een nieuwe poging dezelfde sleutel. Zo voorkom je een tweede betaalde opdracht. Bewaar taskId bij je eigen bestandsnummer.

Ontvang en verifieer het resultaat

Geef voor meldingen een openbare HTTP(S) callbackUrl op. Bevestig ontvangst van de webhook snel en controleer de taak daarna via /open/taskDetail. Verwerk dubbele meldingen veilig en gebruik statusopvragen als reserve wanneer de callback vertraagd is.

Sleutels op de server, een vaste sleutel tegen dubbele opdrachten, opgeslagen taaknummers en controle van webhooks maken herhaalde verzoeken beheersbaar.

Invoerlimieten en kwaliteitscontroles

De invoerregels van de API kunnen afwijken van die van de webeditor. Controleer de actuele documentatie en toets formaat, duur, afmetingen, bitdiepte en HDR voordat een betaalde opdracht wordt gestart.

Valideer voordat u credits uitgeeft

Het resultaat hangt af van details en beweging rond de tekst. Een egale lucht of muur is doorgaans eenvoudiger dan handen, haar, kleding met patronen of spiegelingen. Bekijk de hele export, vooral waar de achtergrond verandert.

Beoordeel moeilijke beelden

Afbeeldingstaken ondersteunen gangbare web- en designformaten en kosten een vast aantal credits per geslaagde taak volgens de huidige API-pagina. Bewaar het bronbestand en sla het resultaat op als een afgeleide; watermerkverwijdering creëert geen auteursrechtelijke of commerciële gebruikspermissie.

Wijs ongeschikte bestanden vooraf af en laat bewegende, gedetailleerde beelden door een persoon beoordelen.

Facturering, mislukkingen en retrybeleid

Video-ondertiteling verwijderen wordt gefactureerd op duur en resolutie. Het huidige schema is 1,3 credits per seconde op 720p of lager en 1,6 credits per seconde boven 720p tot 1080p. Een 30-seconden 1280×720 video is daarom ongeveer 39 credits, terwijl een 30-seconden 1920×1080 video ongeveer 48 credits is. Raadpleeg /open/queryCredits voordat u een grote batch accepteert.

Schat de kosten in vóór het indienen

Antwoorden bevatten code en message. Bij taken kunnen ook status, resultUrl en bij fouten failCode, failReason en refundStatus staan. Probeer tijdelijke storingen opnieuw met oplopende wachttijd; herstel eerst ongeldige parameters, niet-ondersteunde bestanden of onvoldoende tegoed.

Handel stabiele mislukkingsvelden af

Meet hoe lang taken duren, hoeveel mislukken, hoeveel resultaten na controle worden afgewezen en wat een goedgekeurd bestand kost. Daarmee beoordeel je de werkelijke opbrengst van de automatisering.

Meet hoeveel bestanden na controle worden goedgekeurd en wat ze kosten, naast de technische taakstatus.

Lanceer de integratie in vier stappen

Maak eerst via de 550W ontwikkelaarspagina een API-sleutel en test één representatieve video. Toon daarna wachtende, lopende, geslaagde en mislukte taken in je product. Voeg een vaste sleutel tegen dubbele opdrachten en een webhook met statuscontrole als reserve toe. Beoordeel elke export van een kleine proefbatch voordat je meer tegelijk laat verwerken.

Piloot voordat u opschaalt

Scheid ontwikkel- en productieomgevingen, vervang gelekte sleutels, beperk toegang tot bronbestanden en leg een bewaartermijn voor resultaten vast. Koppel de API pas aan je mediabibliotheek, CMS of lokalisatieproces wanneer de beoordelingscriteria helder zijn.