Una richiesta HTTP familiare è il punto di partenza. Usa questa checklist per provare immagini e integrazione prima di spostare la produzione.
1. Controlla le richieste che usi
Elenca metodo di input, formato, dimensioni e parametri di editing. Sono supportati file, URL HTTPS e base64 semplice, ma non ogni opzione remove.bg. Conserva le chiavi sul server e creane una nuova con un piano API.
2. Sostituisci endpoint e chiave
Per richieste compatibili, conserva la struttura e cambia origine e X-API-Key. Se una libreria fissa il dominio remove.bg, usa l’override dell’endpoint o un client HTTP diretto. Non inviare chiavi remove.bg a questo servizio.
- POST https://api.remove.bg/v1.0/removebg + POST https://removebgtool.net/v1.0/removebg X-API-Key: YOUR_NEW_API_KEY
curl --fail-with-body --max-time 180 \
-H 'X-API-Key: YOUR_API_KEY' \
-F 'image_file=@image.jpg' \
-F 'size=auto' \
'https://removebgtool.net/v1.0/removebg' -o no-bg.png3. Confronta i parametri prima dei test
La compatibilità riguarda la richiesta, non ritagli identici. type deve essere auto, type_level none e channels rgba. I parametri non supportati con valori non vuoti vengono rifiutati, non ignorati.
| Campo richiesta | Supporto qui |
|---|---|
| image_file / image_url / image_file_b64 | Scegli un solo input: image_file, image_url o image_file_b64. |
| format | auto, png, jpg o webp. ZIP non è supportato. |
| size | I limiti di pixel dipendono dal formato. Controlla la tabella delle dimensioni e i limiti di output. |
| crop / bg_color | crop=true/false e bg_color sono supportati. |
| type / type_level / channels | Solo auto / none / rgba, rispettivamente. |
| bg_image_url / shadow / roi / crop_margin / scale / position | Non supportati: immagini di sfondo, ombre, ROI, margini di ritaglio, scala o posizione. |
4. Controlla risposte e fatturazione
Leggi Content-Type prima di salvare. L’API restituisce byte immagine di default o JSON con result_b64 su richiesta. Controlla X-Credits-Charged e X-Request-ID. Chiavi e crediti remove.bg non sono trasferibili. Qui anteprima e piena risoluzione hanno lo stesso costo per immagine.
5. Prova un insieme rappresentativo di immagini
Prova prodotti, ritratti, bordi poco contrastati e ogni formato, oltre a file troppo grandi, chiavi errate, parametri non supportati e crediti insufficienti. Verifica 409, 429, timeout ed errori. Conserva gli ID richiesta per le indagini.
Idempotency-Key è facoltativo: stessa chiave, immagine e parametri permettono il replay di un successo per 10 minuti senza nuovo addebito. Il replay ripete X-Credits-Charged e aggiunge X-Idempotent-Replayed: true. Le richieste in corso restituiscono 409. Le chiavi fallite o scadute restano riservate: usa una nuova chiave per una nuova richiesta fatturabile. Senza header ogni richiesta è indipendente. Prevedi un timeout client di 180 secondi.
6. Passa gradualmente al nuovo servizio e prevedi un ripristino
Invia inizialmente una piccola parte del carico alla nuova integrazione. Verifica successo, qualità e crediti prima di aumentare il traffico. Mantieni disponibile la configurazione precedente. Routing e rollback sono gestiti dalla tua applicazione, non da un interruttore automatico del servizio.
Il servizio è indipendente da remove.bg. Verifica il comportamento, non solo i nomi dei parametri.