Introduzione
Video Eraser rimuove i contenuti all’interno di una maschera immagine statica lungo un’intera clip video. Invia video_url e mask_url, aggiungendo facoltativamente un breve prompt che descriva la rimozione. È adatto a una fascia fissa di sottotitoli o a un altro elemento indesiderato che rimane nella stessa regione dello schermo. Lo sfondo risultante è un riempimento dedotto, non un recupero dei pixel originali nascosti.
Caratteristiche principali
Una regione fissa per l’intera clip
La maschera è un’immagine statica: il bianco indica l’area da cancellare e il nero quella da conservare. La stessa regione dello schermo si applica per l’intero video fornito. Non sono presenti un campo per il tempo di inizio, un campo per il tempo di fine o un controllo per il tracciamento di oggetti in movimento. Un sottotitolo che si sposta fuori dalla regione bianca non viene coperto da quella maschera. Anche i contenuti che attraversano la regione selezionata possono essere alterati dal riempimento.
Una descrizione facoltativa insieme alla maschera
Una breve descrizione può chiarire cosa rimuovere e cosa si trova intorno. La maschera resta obbligatoria su questo endpoint per definire esplicitamente la regione. L’elaborazione viene addebitata in base all’intera clip di input, arrotondando per eccesso ai secondi interi, con una durata minima fatturata di 3 secondi. Sono accettate clip sorgente di durata compresa tra 1 e 600 secondi. Una maschera più piccola non riduce la durata video fatturata.
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
video_url | Sì | Il video completo da elaborare, della durata di 1–600 secondi. La regione selezionata viene elaborata per l’intera clip. almeno 1 caratteri |
mask_url | Sì | Una singola immagine PNG statica allineata al fotogramma video. Colora di bianco l’area da rimuovere e di nero l’area restante. almeno 1 caratteri |
prompt | No | Indicazioni facoltative per la rimozione locale. Non selezionano un intervallo di tempo e non attivano il tracciamento. |
Prezzi
$0.024 / secondo
Addebito in base all’intera clip di input, arrotondando per eccesso ai secondi interi, con una durata minima fatturata di 3 secondi. Questo endpoint accetta clip da 1 a 600 secondi; la dimensione della maschera non riduce la durata.
Casi d’uso
Rimuovere una fascia fissa di sottotitoli
Per i sottotitoli già impressi nelle tue riprese, delimita la fascia dei sottotitoli e controlla ogni sezione in cui compare del testo. Uno sfondo statico è un buon punto di partenza per verificare il risultato. Se nel progetto i sottotitoli sono ancora livelli di testo modificabili, rimuovi direttamente quei livelli prima di scegliere la ricostruzione dei pixel.
Eliminare una sovrimpressione immobile
Usa una maschera aderente per una sovrimpressione indesiderata in un angolo delle riprese che stai montando. Controlla i fotogrammi in cui una persona o un prodotto passa dietro l’area selezionata, oppure un movimento della videocamera cambia il contenuto dietro quell’area. In quei momenti il riempimento deve dedurre contenuti mutevoli e può rivelare sfarfallii o bordi distorti non evidenti in un singolo fotogramma di anteprima.
Consigli avanzati
Crea una maschera senza ambiguità
Prepara una maschera PNG allineata al fotogramma sorgente: bianco all’interno della regione da rimuovere, nero all’esterno. Prima dell’invio, verifica il posizionamento sul primo fotogramma, su quello centrale e sull’ultimo. Evita regioni bianche inutilmente grandi, soprattutto quando si sovrappongono a un volto o a un dettaglio importante del prodotto. La maschera è statica e agisce sull’intera clip; non può seguire sottotitoli in movimento né limitare la modifica a un intervallo di tempo selezionato.
Descrivi la modifica locale e confronta il risultato
Un’istruzione facoltativa come «Rimuovi la fascia fissa dei sottotitoli e riempila con lo sfondo circostante» descrive il cambiamento desiderato senza inventare una nuova scena. Confronta l’output con l’originale a velocità di riproduzione normale e fotogramma per fotogramma in prossimità dei movimenti difficili. Oltre alla regione cancellata, verifica le aree non mascherate, la durata della clip, la frequenza dei fotogrammi e il suono. La conservazione dell’audio originale e la preservazione esatta dei pixel fuori dalla maschera non sono state verificate, quindi conserva il file sorgente.
Avvio rapido dell’API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "spicyapi/video-eraser-v1/video-edit",
"input": {
"mask_url": "https://example.com/reference.png",
"video_url": "https://example.com/reference.mp4"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Nel riferimento dell’API trovi autenticazione, schema completo, polling e gestione degli errori.