API Video Eraser per rimuovere sottotitoli e filigrane

Cosa supporta effettivamente l'API developer 550W

L'API developer 550W consente a un backend di inviare job di rimozione sottotitoli o testo video e job di rimozione filigrane immagine senza passare gli utenti attraverso un editor manuale. È progettata per piattaforme di creator, pipeline di localizzazione, librerie multimediali e strumenti interni che elaborano ripetutamente contenuti di proprietà dell'organizzazione o per i quali è stata ottenuta una licenza di modifica.

Rimozione di sottotitoli e testo video

Per i video, invia filmati MP4 o MOV tramite /open/uploadVideo o fornisci un videoUrl pubblico a /open/submitTask. La richiesta include dimensioni del video, durata e il rettangolo da riparare. I job video vengono eseguiti in modo asincrono e possono essere verificati tramite /open/taskDetail o /open/taskList.

Rimozione di filigrane immagine

Per le immagini, /open/removeImageWatermark accetta file JPG, PNG, BMP, WebP, AVIF, TIFF o SVG fino a 50 MB. Può attendere un risultato o restituire un task di elaborazione per una successiva consultazione. L'API developer Eraser non espone il download di filigrane da link video, quindi le integrazioni non devono promettere tale funzionalità.

Usa l'API per la rimozione autorizzata di sottotitoli/testo video e filigrane immagine; escludi dai promessi del prodotto i flussi di lavoro non supportati per filigrane da link video.

Un flusso di richiesta pronto per la produzione

Ogni richiesta è autenticata con userNo e apiKey. Conserva entrambi i valori sul tuo server: posizionare una chiave API nel codice del browser o del client mobile la rende recuperabile dagli utenti e dalle estensioni. Un video può essere caricato prima o fornito come URL HTTPS raggiungibile pubblicamente.

Autenticazione e caricamento

Invia /open/submitTask con width, height, duration e x1, y1, x2, y2. Un rettangolo stretto di solito preserva più dettagli di una riparazione a schermo intero. Usa mode=protect quando il flusso di lavoro supportato richiede una ricostruzione conservativa e removeAudio solo quando l'audio deve essere rimosso prima dell'elaborazione.

Inviare un job idempotente

Invia un Idempotency-Key di non più di 128 caratteri per una creazione sicura in caso di ritentivi. Se una connessione si interrompe dopo l'invio, ritenta con la stessa chiave invece di creare un secondo job fatturabile. Memorizza il taskId restituito insieme al tuo ID asset.

Ricevere e verificare il risultato

Per la consegna asincrona, fornisci un callbackUrl HTTPS pubblico. Il webhook si attiva quando il task raggiunge uno stato finale. Il tuo handler dovrebbe riconoscere rapidamente, verificare nuovamente il task tramite /open/taskDetail e trattare la consegna ripetuta del webhook come normale. Il polling rimane utile come percorso di ripristino quando un callback è ritardato.

Credenziali lato server, idempotenza, ID task persistenti e verifica webhook rendono i ritentivi sicuri e osservabili.

Limiti di input e controlli di qualità

I video caricati supportano MP4 e MOV, una dimensione massima del file di 1 GB, durata fino a 600 secondi e elaborazione fino a 1080p entro le regole delle dimensioni documentate. Convalida formato, durata, dimensioni, profondità bit e stato HDR prima dell'invio affinché contenuti multimediali non supportati non entrino mai nella coda a pagamento.

Convalida prima di spendere crediti

La qualità dipende da cosa si muove dietro il sottotitolo o il testo. Pareti piatte, cielo e paesaggi che cambiano lentamente sono di solito più facili di mani, capelli, vestiti con fantasie, riflessi o movimenti rapidi della telecamera. Crea una coda di revisione per i casi limite e confronta l'intera timeline, non solo una miniatura.

Rivedere footage difficile

I job immagine supportano formati web e di design comuni e costano un numero fisso di crediti per task riuscito secondo la pagina API corrente. Preserva il file sorgente e salva il risultato come derivato; la rimozione delle filigrane non crea permesso di copyright o uso commerciale.

Rifiuta gli input non supportati tempestivamente e richiedi revisione umana ogni volta che l'area di riparazione attraversa dettagli importanti in movimento.

Fatturazione, errori e politica di ritentivi

La rimozione dei sottotitoli video viene fatturata in base alla durata e alla risoluzione. La tariffa attuale è 1,3 crediti al secondo a 720p o inferiore e 1,6 crediti al secondo sopra 720p fino a 1080p. Un video 1280×720 di 30 secondi è quindi circa 39 crediti, mentre un video 1920×1080 di 30 secondi è circa 48 crediti. Interroga /open/queryCredits prima di accettare un batch grande.

Stimare il costo prima dell'invio

Le risposte riuscite includono code e message; le risposte dei task espongono inoltre status e, quando completo, resultUrl. I task falliti possono includere failCode, failReason e refundStatus. Ritenta errori temporanei di trasporto o interni con backoff esponenziale, ma non ritentare ciecamente parametri non validi, contenuti multimediali non supportati, account sospesi o errori di crediti insufficienti.

Gestire i campi di errore stabili

Registra latenza di invio, latenza di completamento, tasso di errore, tasso di rifiuto della revisione e costo per asset approvato. Queste metriche rivelano se l'automazione sta migliorando il flusso di lavoro invece di spostare semplicemente il lavoro manuale a valle.

Un'integrazione utile misura l'output approvato e il costo effettivo, non solo le risposte HTTP riuscite.

Avvia l'integrazione in quattro passaggi

Innanzitutto, genera una chiave API dalla pagina developer 550W localizzata e invia un video rappresentativo. Secondo, implementa la ricerca del task e mostra gli stati di attesa, elaborazione, successo e fallito nel tuo prodotto. Terzo, aggiungi idempotenza e un webhook con ripristino tramite polling. Infine, esegui un batch controllato e rivedi ogni output prima di aumentare la concorrenza.

Pilotare prima di scalare

Usa controlli separati per sviluppo e produzione, ruota le credenziali esposte, limita l'accesso ai contenuti multimediali sorgente e mantieni una politica di eliminazione per i risultati. I team con criteri di accettazione chiari possono quindi connettere l'API a un DAM, CMS, coda di localizzazione o flusso di lavoro di caricamento creator senza sacrificare la revisione editoriale.