API Video Eraser per sottotitoli e filigrane di video e immagini

Cosa supporta effettivamente l'API developer 550W

L’API sviluppatori 550W consente a un server di inviare attività autorizzate per elaborare sottotitoli o una filigrana visibile in un rettangolo selezionato, oltre alle filigrane nelle immagini. L’accesso all’API non concede diritti sui materiali originali e i risultati vanno controllati.

Elaborazione di sottotitoli e filigrane video

Per i video, carica un MP4 o MOV tramite /open/uploadVideo oppure passa una videoUrl pubblica a /open/submitTask. Indica dimensioni, durata e rettangolo da elaborare. L’attività è asincrona: verificane lo stato con /open/taskDetail o /open/taskList.

Rimozione di filigrane immagine

Per le immagini, /open/removeImageWatermark accetta JPG, PNG, BMP, WebP, AVIF, TIFF e SVG fino a 50 MB. Può restituire il risultato o un’attività da consultare in seguito. L’API non scarica video con filigrana a partire da link; non promettere questa funzione.

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 HTTP(S) raggiungibile pubblicamente.

Autenticazione e caricamento

Invia width, height, duration e x1, y1, x2, y2 a /open/submitTask. Standard (mode=normal, predefinita) elabora la zona interna al rettangolo. Protect (mode=protect) conserva l’interno ed elabora l’esterno; non è una modalità di qualità superiore. Usa removeAudio solo se l’audio va eliminato 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 HTTP(S) 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à

Le regole di input dell’API possono essere diverse da quelle dell’editor web. Controlla la documentazione aggiornata e verifica formato, durata, dimensioni, profondità colore e HDR prima di avviare un’attività a pagamento.

Convalida prima di spendere crediti

Il risultato dipende dai dettagli e dal movimento intorno al testo. Cielo e pareti uniformi sono in genere più semplici di mani, capelli, tessuti a fantasia e riflessi. Esamina tutto il video, soprattutto quando cambia lo sfondo.

Esaminare le riprese complesse

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 includono code e message. Un’attività può inoltre riportare status, resultUrl e, in caso di errore, failCode, failReason e refundStatus. Riprova gli errori temporanei con attese crescenti; correggi prima parametri errati, file non supportati o 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.