Video Eraser API voor ondertiteling en afbeeldingswatermerkverwijdering

Wat de 550W developer API daadwerkelijk ondersteunt

Met de 550W developer API kan een backend video-ondertiteling of tekstverwijderingstaken en afbeeldingswatermerkverwijderingstaken indienen zonder gebruikers door een handmatige editor te leiden. Het is ontworpen voor creator platforms, localisatie-pijplijnen, medialijsten en interne tools die herhaaldelijk content verwerken die de organisatie bezit of gemachtigd is om te bewerken.

Video-ondertiteling en tekst verwijderen

Upload voor video's MP4 of MOV beelden via /open/uploadVideo of geef een openbare videoUrl op aan /open/submitTask. De aanvraag bevat video-afmetingen, duur en het rechthoekige gebied dat hersteld moet worden. Video-taken worden asynchroon uitgevoerd en kunnen worden gecontroleerd via /open/taskDetail of /open/taskList.

Afbeeldingswatermerkverwijdering

Voor afbeeldingen accepteert /open/removeImageWatermark JPG, PNG, BMP, WebP, AVIF, TIFF of SVG-bestanden tot 50 MB. Het kan wachten op een resultaat of een verwerkingstaak retourneren voor later opzoeken. De Eraser developer API biedt geen video-link watermerkdownload aan, dus integraties zouden die functionaliteit niet moeten beloven.

Gebruik de API voor geautoriseerde video-ondertiteling/tekst opschoning en afbeeldingswatermerkverwijdering; houd niet-ondersteunde video-link watermerkwerkstromen buiten uw productbelofte.

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

Authenticeren en uploaden

Dien /open/submitTask in met width, height, duration en x1, y1, x2, y2. Een strakke rechthoek bewaart meestal meer detail dan een volledig scherm herstel. Gebruik mode=protect wanneer de ondersteunde werkstroom conservatieve reconstructie vereist, en removeAudio alleen wanneer audio moet worden verwijderd voor verwerking.

Dien een idempotente taak in

Stuur een Idempotency-Key van maximaal 128 tekens voor retry-veilige creatie. Als een verbinding wegvalt na het indienen, probeer dan opnieuw met dezelfde sleutel in plaats van een tweede factureerbare taak te maken. Sla de geretourneerde taskId op naast uw eigen asset-ID.

Ontvang en verifieer het resultaat

Voor asynchrone levering kunt u een openbare HTTPS callbackUrl opgeven. De webhook wordt geactiveerd wanneer de taak een definitieve status bereikt. Uw handler moet snel bevestigen, de taak opnieuw verifiëren via /open/taskDetail en herhaalde webhook-leveringen als normaal behandelen. Polling blijft nuttig als herstelpad wanneer een callback is vertraagd.

Server-side referenties, idempotentie, duurzame taak-ID's en webhook-verificatie maken retries veilig en observeerbaar.

Invoerlimieten en kwaliteitscontroles

Geüploade video's ondersteunen MP4 en MOV, een maximale bestandsgrootte van 1 GB, duur tot 600 seconden en verwerking tot 1080p binnen de gedocumenteerde afmetingsregels. Valideer formaat, duur, afmetingen, bitdiepte en HDR-status voordat u indient, zodat niet-ondersteunde media nooit de betaalde wachtrij betreedt.

Valideer voordat u credits uitgeeft

Kwaliteit hangt af van wat er achter de ondertiteling of tekst beweegt. Vlakke muren, hemel en langzaam veranderende scenery zijn meestal gemakkelijker dan handen, haar, gepatte kleding, reflecties of snelle camerabewegingen. Bouw een beoordelingswachtrij voor randgevallen en vergelijk de volledige tijdlijn, niet alleen een thumbnail.

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 niet-ondersteunde invoer vroeg af en vereis menselijke beoordeling wanneer het herstelgebied belangrijke bewegende details kruist.

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

Succesvolle responses bevatten code en message; taakresponses onthullen bovendien status en, wanneer voltooid, resultUrl. Mislukte taken kunnen failCode, failReason en refundStatus bevatten. Retry tijdelijke transport- of interne fouten met exponentiële backoff, maar retry niet blindelings ongeldige parameters, niet-ondersteunde media, geschorste accounts of onvoldoende credit-fouten.

Handel stabiele mislukkingsvelden af

Registreer submit latentie, voltooiingslatentie, foutpercentage, beoordelingsafwijzingspercentage en kosten per goedgekeurde asset. Deze metrieken onthullen of automatisering de werkstroom verbetert in plaats van alleen handmatig werk stroomafwaarts te verplaatsen.

Een nuttige integratie meet goedgekeurde output en effectieve kosten, niet alleen succesvolle HTTP-responses.

Lanceer de integratie in vier stappen

Genereer eerst een API-sleutel van de gelokaliseerde 550W developer pagina en dien één representatieve video in. Implementeer ten tweede taakopzoeking en geef wachten, verwerken, succes en mislukte statussen weer in uw eigen product. Voeg ten derde idempotentie en een webhook toe met polling-herstel. Voer ten slotte een gecontroleerde batch uit en beoordeel elke output voordat u de gelijktijdigheid verhoogt.

Piloot voordat u opschaalt

Gebruik aparte ontwikkeling en productiecontroles, roteer blootgestelde referenties, beperk de toegang tot bronmedia en houd een verwijderingsbeleid aan voor resultaten. Teams met duidelijke acceptatiecriteria kunnen dan de API verbinden met een DAM, CMS, localisatiewachtrij of creator upload-werkstroom zonder redactionele beoordeling op te offeren.