Introduzione
Background Remover separa il soggetto principale di una foto da tutto ciò che ha alle spalle e lo restituisce su uno sfondo completamente trasparente. Invii un URL di immagine e ricevi un PNG con canale alfa, con la stessa larghezza e altezza dell'originale, così lo scontorno combacia pixel per pixel con la sorgente ogni volta che devi sovrapporre le due immagini.
Non ci sono prompt, maschere o impostazioni: è lo strumento a decidere da solo che cosa è primo piano.
Caratteristiche principali
Una trasparenza pronta per qualsiasi layout
I pixel dello sfondo non vengono dipinti di bianco ma resi completamente trasparenti, quindi il risultato si posa su qualunque colore, sfumatura o foto senza un riquadro intorno. È il formato che marketplace, presentazioni, programmi di grafica e pagine web si aspettano per gli scontorni di prodotti e ritratti.
Niente da scrivere, niente da regolare
L'intera richiesta è un solo URL di immagine. Siccome non si formula nulla, non esistono parole sbagliate né secondi tentativi dovuti a un'istruzione ambigua, e diventa facile elaborare in un ciclo un'intera cartella di foto di catalogo.
Le dimensioni originali restano
Lo scontorno torna con le dimensioni del file caricato e non in un quadrato fisso, quindi puoi rimetterlo sopra la sorgente, usarlo come maschera o passarlo al passaggio successivo senza ridimensionarlo.
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
image_url | Sì | La foto da scontornare, in JPEG, PNG o WebP. Il soggetto viene rilevato in automatico, quindi ritaglia prima se nell'inquadratura ci sono più candidati. almeno 1 caratteri |
Prezzi
$0.0048 / immagine
Addebito per immagine prodotta; le dimensioni della foto che invii non cambiano il prezzo.
Casi d’uso
Catalogo prodotti e inserzioni sui marketplace
Fotografa i prodotti sulla superficie che hai a disposizione, poi rimuovi lo sfondo e metti ogni articolo sullo stesso colore pulito. Uno sfondo uniforme in tutte le inserzioni è il miglioramento visivo più rapido per un negozio, e non richiede più un fondale da studio per ogni articolo.
Avatar, pagine del team e miniature
Isola le persone da pareti d'ufficio, soggiorni o scene di strada per creare foto profilo, schede dei relatori e miniature video con uno sfondo del brand alle spalle.
Primo passo di un lavoro più lungo
Scontorna il soggetto prima di un fotomontaggio: rimuovi qui lo sfondo, costruisci una nuova scena con Image Expander e poi rimetti sopra il PNG trasparente.
Consigli avanzati
Scegli foto con un soggetto chiaro
Lo strumento sceglie da solo il primo piano. È più affidabile quando una persona o un oggetto domina chiaramente l'inquadratura e si stacca dallo sfondo per colore o luce. Se un'immagine mostra più persone o oggetti con lo stesso peso, ritagliala sul soggetto che vuoi prima di inviarla, perché lo strumento potrebbe tenerne più del previsto.
Controlla i bordi sottili a grandezza reale
Capelli, pelliccia, pizzo, fumo e vetro sono le zone più difficili di uno scontorno. Esaminale ingrandite prima di pubblicare, soprattutto quando lo sfondo ha colori simili al soggetto. Rifare la foto su uno sfondo più semplice risolve più di una seconda passata della stessa immagine.
Tieni il file in PNG
La trasparenza sopravvive solo nei formati che la supportano. Salva e passa il risultato in PNG; convertirlo in JPEG riempie l'area trasparente con un colore pieno e fa tornare il rettangolo che hai appena tolto.
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-v1/edit",
"input": {
"image_url": "https://example.com/reference.png"
}
}'
# 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.
