Rimuovi sfondoInformazioni su Background Remover
Scontorna il soggetto principale di qualsiasi foto con una sola chiamata: lo sfondo diventa completamente trasparente, in un PNG delle stesse dimensioni dell'immagine che hai caricato.
Lo chiami con il nome di modello popnow/background-remover-v1/edit su POST /jobs/createTask, da 1 credito per immagine (0,01 USD). I nuovi account ricevono 30 crediti gratuiti per provarlo prima nel Playground.
Per ora questa guida è solo in inglese. →
Parametri della richiesta
| Parametro | Obbligatorio | Descrizione |
|---|---|---|
image_url | Sì | L'immagine di partenza. |
Prezzi
I prezzi sono in crediti, gli stessi che usi sul sito (1 credito = 0,01 $). L'importo viene trattenuto quando il task è accettato e regolato sul costo reale al termine; i task falliti vengono rimborsati.
| Opzione | Crediti per immagine | ≈ USD |
|---|---|---|
| Standard | 0,72 | 0,0072 USD |
Ogni attività è arrotondata per eccesso ai crediti interi, quindi un'esecuzione al livello più basso costa 1 credito per immagine (0,01 USD).
Per avere la cifra esatta prima di eseguire, invia lo stesso body a POST /jobs/quote.
Guida rapida all'API
Chiama l'API di Background Remover in tre passaggi
- Crea una chiave API. Accedi a PopNow e crea una chiave nella console API. Le chiavi iniziano con sk-popnow- e usano gli stessi crediti del sito.
- Invia la richiesta. Invia POST /jobs/createTask con model popnow/background-remover-v1/edit e un oggetto input secondo la tabella dei parametri. La risposta restituisce subito un ID attività.
- Recupera il risultato. Interroga GET /jobs/recordInfo con l'ID attività, oppure passa una callBackUrl e ti inviamo lì il risultato. Scarica i link di output quando l'attività riesce.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "popnow/background-remover-v1/edit",
"input": {
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp"
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"Sostituisci il prompt e gli eventuali link con i tuoi. La scheda API contiene il riferimento per risposta, polling e callback.
Domande sull’API di Background Remover
Quanto costa l’API di Background Remover?
Background Remover costa 1 credito (0,01 USD) per immagine. I crediti sono gli stessi del sito (1 credito = 0,01 $), i nuovi account ricevono 30 crediti gratuiti e i task falliti vengono rimborsati.
Qual è il nome del modello di Background Remover nell’API?
Inserisci popnow/background-remover-v1/edit per Rimuovi sfondo nel campo model di POST /jobs/createTask.
Devo descrivere il soggetto?
No. L'endpoint accetta un solo campo, image_url, e sceglie da solo il primo piano. Se nella foto ci sono più candidati, ritagliala prima su quello che vuoi.
Che cosa ricevo?
Un PNG con sfondo trasparente, con la stessa larghezza e altezza dell'immagine inviata, così puoi sovrapporlo subito all'originale.
Può inserire un nuovo sfondo?
Non nella stessa chiamata: si limita a rimuovere. Metti il PNG sul tuo colore o sulla tua foto, oppure costruisci una nuova scena con Image Expander e sovrapponi lo scontorno.
Quali foto funzionano meglio?
Quelle con un soggetto chiaro che si stacca dall'ambiente per colore o luce. Bordi poco contrastati, mosso e soggetti tagliati dall'inquadratura sono i punti in cui lo scontorno cede.
Posso provare Background Remover senza scrivere codice?
Sì. Il Playground esegue Background Remover con i tuoi crediti PopNow, non richiede una chiave API e mostra il codice di ogni generazione.