Introduzione
Isola il primo piano di una clip esistente e scegli la trasparenza o uno sfondo a tinta unita. La richiesta predefinita prevede WebM VP9 trasparente con l’audio originale.
| Campo | Valore |
|---|---|
| Input | Video |
| Output | Video |
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
video_url | Sì | Clip sorgente da 1 a 60 secondi. L’output isola il primo piano rilevato; non è disponibile un controllo del ritaglio. almeno 1 caratteri |
background | No | Scegli la trasparenza o una delle dieci tinte unite. L’output trasparente richiede un formato che supporti alfa. |
output_format | No | Preimpostazione di contenitore e codec. WebM VP9 è il formato predefinito. |
keep_original_audio | No | Richiede l’audio originale nell’output; attivo per impostazione predefinita. Disattivalo per una clip senza audio. Predefinito: |
Prezzi
$0.06 / secondo
Addebito per secondo di video in ingresso, arrotondato per eccesso al secondo intero. Questo endpoint accetta clip da 1 a 60 secondi. Le scelte di sfondo, formato e audio non modificano questa regola basata sulla durata.
Casi d’uso
Video → Editing video → Video
Editing video
Video
Attività asincrona
Consigli avanzati
Introduzione
Lo strumento di rimozione dello sfondo video isola il primo piano di un video esistente per il compositing o per posizionarlo su uno sfondo a tinta unita. Invia video_url e scegli lo sfondo e il formato di esportazione. La richiesta predefinita prevede WebM VP9 trasparente e mantiene l’audio originale. Questo endpoint accetta clip sorgente da 1 a 60 secondi; non genera una nuova scena a partire da un prompt.
Funzioni principali e punti di forza
La trasparenza dipende dalla scelta di sfondo e formato
Imposta background su transparent e usa un formato che supporti alfa. WebM VP9, MOV ProRes 4444, MKV VP9 e GIF sono opzioni documentate con alfa. Qui le preimpostazioni MP4 e quelle MKV H.264 o H.265 non includono alfa; le richieste di trasparenza incompatibili possono essere rifiutate. MOV H.265 ha solo un supporto parziale documentato, quindi usa WebM VP9 per il flusso di lavoro trasparente predefinito e controlla l’output effettivo prima del compositing.
Tinte unite e audio originale
Puoi anche scegliere nero, bianco, grigio, rosso, verde, blu, giallo, ciano, magenta o arancione. keep_original_audio controlla se viene richiesto l’audio sorgente nel risultato. GIF non può contenere una traccia audio; disattiva la conservazione dell’audio quando lo scegli. Le scelte di contenitore, codec e sfondo non modificano la regola di addebito basata sulla durata. La fatturazione usa i secondi in ingresso arrotondati per eccesso e questo endpoint non offre controlli sul ritaglio o sulla risoluzione di output.
Casi d’uso
Posizionare un relatore sopra una presentazione
Inizia con una breve clip in cui il relatore sia chiaramente separato dallo sfondo. Richiedi WebM VP9 trasparente, poi posiziona il risultato sopra la diapositiva o la scena in un editor che supporti questo formato. Prima di pubblicare la composizione, controlla i capelli e i bordi sfocati dal movimento sia su sfondi scuri sia su sfondi chiari.
Preparare una clip di prodotto per un nuovo layout
Separa un prodotto dall’ambientazione originale per riutilizzare le riprese in un layout di catalogo o in un montaggio per i social. L’esportazione a tinta unita può essere utile quando la trasparenza non è necessaria. Le superfici riflettenti e i bordi sottili richiedono un controllo accurato: il risultato è una maschera elaborata e va valutato sullo sfondo previsto, non soltanto in un’anteprima a scacchiera.
Guida ai prompt e consigli pratici
Scegliere consapevolmente il formato di consegna
Mantieni background=transparent, output_format=webm_vp9 e keep_original_audio=true per il flusso di lavoro video predefinito. Scegli un’altra preimpostazione solo dopo aver verificato che il tuo editor possa importarla. Il supporto per la riproduzione sul web varia in base al browser e al codec; un download riuscito non dimostra che un’anteprima incorporata o un montaggio successivo funzioneranno. Conserva il master trasparente quando crei un’anteprima separata appiattita su uno sfondo da condividere.
Verificare la trasparenza e l’intera clip
Ispeziona il canale alfa effettivo e componi il risultato su nero, bianco e un colore saturo. Un file che mostra una scacchiera o un rettangolo nero non dimostra che la trasparenza funzioni. Esamina tutto il movimento per individuare variazioni dei bordi e confronta durata, dimensioni dei fotogrammi e sincronizzazione audio con l’originale. Non dedurre la presenza di alfa dal nome del file o dalle opzioni selezionate. Per questa integrazione non è stato ancora completato alcun test di qualità dei contenuti multimediali o di compatibilità con i browser; convalida il risultato con il flusso di lavoro previsto.
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/background-remover-video-v1/video-edit",
"input": {
"background": "transparent",
"output_format": "webm_vp9",
"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.
