L’API de remove.bg ferme. Changez une ligne, gardez votre code.
Le site autonome et l’API en libre-service de remove.bg prennent fin le . L’API passe chez Leonardo.Ai (une société de Canva), ce qui impose de modifier votre intégration (annonce de Leonardo.Ai). removebackground.dev accepte les mêmes requêtes : pointez votre code vers notre URL, utilisez notre clé, et c’est terminé.
L’API en libre-service de remove.bg prend fin le
La seule ligne qui change
https://api.remove.bg/v1.0/removebghttps://removebackground.dev/v1.0/removebgMême en-tête X-Api-Key, avec votre clé removebackground.dev. Mêmes noms de paramètres, mêmes en-têtes de réponse, même format d’erreur {"errors": [...]}.
Avant et après
Une intégration type dans quatre langages. La clé provient de REMOVEBG_API_KEY : la seule modification est l’URL surlignée.
curl -f -H "X-Api-Key: $REMOVEBG_API_KEY" \
-F 'image_file=@photo.jpg' \
-F 'size=auto' \
-o no-bg.png \
https://api.remove.bg/v1.0/removebg
curl -f -H "X-Api-Key: $REMOVEBG_API_KEY" \
-F 'image_file=@photo.jpg' \
-F 'size=auto' \
-o no-bg.png \
https://removebackground.dev/v1.0/removebg
Vous utilisez Zapier, Make ou n8n ?
Ouvrez l’étape de requête HTTP qui appelle remove.bg (Zapier Webhooks, Make HTTP, n8n HTTP Request), remplacez l’URL par https://removebackground.dev/v1.0/removebg et la valeur X-Api-Key par votre clé removebackground.dev. Laissez tous les autres champs tels quels.
Compatibilité des paramètres
Tout ce que votre requête remove.bg envoie est accepté. Quelques options sont sans effet ici, comme indiqué ci-dessous.
| Paramètre | Statut | Remarques |
|---|---|---|
image_file / image_file_b64 / image_url | Pris en charge | Corps multipart, urlencoded ou JSON. JPG, PNG ou WebP jusqu’à 25 MB. |
size | Pris en charge | auto, full, 4k et 50MP donnent la résolution d’origine (jusqu’à 25 MP) ; preview, small et regular ≈ 0,25 MP ; medium 1,5 MP ; hd 4 MP. Toujours 1 crédit. |
format | Pris en charge | auto (PNG si transparent, sinon JPG), png, jpg, webp et zip (color.jpg + alpha.png). |
crop / crop_margin | Pris en charge | px ou % du sujet, 1 à 4 valeurs à la manière du CSS ("10% 20%" = vertical, horizontal) ; 500px ou 50 % au maximum par côté. |
roi | Pris en charge | "x1 y1 x2 y2" en px ou en % : seul le sujet à l’intérieur de la zone est conservé. |
scale / position | Pris en charge | scale de 10% à 100% ou original ; position center, original ou "x% y%". |
channels | Pris en charge | rgba (détourage) ou alpha (masque en niveaux de gris). |
bg_color | Pris en charge | Hexadécimal avec ou sans # (81d4fa), ou un nom de couleur. Un hexadécimal à 8 chiffres conserve la couleur et ignore sa transparence. |
bg_image_url / bg_image_file | Pris en charge | Le détourage est superposé à votre image d’arrière-plan, ajustée en mode cover à la taille de sortie. |
Accept: application/json | Pris en charge | Renvoie { data: { result_b64, foreground_top, foreground_left, foreground_width, foreground_height } }. |
type / type_level | Accepté, ignoré | Le sujet est détecté automatiquement ; X-Type vaut toujours "other". |
semitransparency | Accepté, ignoré | Les contours doux et les zones semi-transparentes proviennent tels quels du masque du modèle. |
shadow_type / shadow_opacity / add_shadow | Accepté, ignoré | Aucune ombre n’est ajoutée. |
Requêtes longues | Différence | Nous attendons jusqu’à 110 secondes ; si une image n’est pas prête d’ici là, vous recevez une erreur 503 que vous pouvez relancer (non facturée sauf si le traitement a abouti). |
En-têtes de réponse
Un appel réussi renvoie les octets de l’image (image/png, image/jpeg, image/webp ou application/zip) avec ces en-têtes. Envoyez Accept: application/json pour recevoir result_b64 à la place.
| En-tête | Signification |
|---|---|
X-Width / X-Height | Taille du résultat en pixels. |
X-Credits-Charged | Crédits utilisés par cette image : toujours 1 (les images en échec coûtent 0). |
X-Type | Toujours "other" (la détection du sujet est automatique). |
X-Foreground-Top / -Left / -Width / -Height | Cadre englobant du sujet dans le résultat, en pixels. |
X-Request-ID | Reprend votre X-Request-ID, ou un identifiant généré. En plus. |
X-Matte-Confidence / X-Matte-Ambiguous-Ratio | Netteté du masque (0–1) et proportion de pixels doux. En plus : pratique pour signaler les images à vérifier. |
Erreurs
| Statut | Signification |
|---|---|
400 | Paramètre ou image non valide (codes tels que invalid_size, invalid_crop_margin, missing_source, file_too_large, unknown_foreground). |
402 | insufficient_credits : rechargez sur la page des tarifs. |
403 | auth_failed : X-Api-Key manquant ou non valide. |
429 | rate_limit_exceeded. |
500 / 503 | Le traitement a échoué, a dépassé le délai ou le service est momentanément indisponible. Réessayez ; les images en échec sont gratuites. |
Consultez votre solde avec GET https://removebackground.dev/v1.0/account : la réponse suit le format de compte de remove.bg. Tous les détails dans la référence de l’API.
Crédits : 1 par image, et ils n’expirent jamais
Chaque image réussie coûte 1 crédit, quels que soient la taille ou les options. Les images en échec sont gratuites. Les nouveaux comptes reçoivent 50 crédits offerts pour tester.
- Crédits sans expirationRechargez une fois, utilisez-les la semaine prochaine ou l’an prochain.
- Sans abonnementDes packs à paiement unique. Rien ne se renouvelle.
- Images en échec gratuitesUn crédit n’est utilisé que si l’arrière-plan est supprimé.
Checklist de migration
- Obtenez une clé API removebackground.devInscrivez-vous (50 crédits offerts) et créez une clé sur la page de votre compte.
- Changez une lignePointez votre code vers https://removebackground.dev/v1.0/removebg et placez la nouvelle clé dans le même en-tête X-Api-Key.
- Testez une imageLancez une vraie requête et comparez le résultat avec celui que vous obtenez aujourd’hui.
- Basculez votre traficDéployez avant le 1 décembre 2026 à 09:00 CET. Rechargez vos crédits une fois ; ils n’expirent jamais.
FAQ sur la migration depuis remove.bg
remove.bg ferme-t-il ?
Le site autonome et l’API en libre-service de remove.bg prennent fin le 1 décembre 2026 à 09:00 CET. L’API passe chez Leonardo.Ai (une société de Canva), ce qui impose de modifier votre intégration. Source : l’annonce de Leonardo.Ai sur https://www.leonardo.ai/news/removebg-api-leonardo.
Quel est le remplaçant le plus simple de l’API remove.bg ?
removebackground.dev propose un endpoint compatible remove.bg. Remplacez https://api.remove.bg/v1.0/removebg par https://removebackground.dev/v1.0/removebg, envoyez une clé removebackground.dev dans le même en-tête X-Api-Key et gardez le reste de votre code : les noms de paramètres, les en-têtes de réponse et le format d’erreur sont identiques.
Dois-je réécrire mon intégration avant décembre 2026 ?
Non. Les requêtes gardent les mêmes paramètres (image_file, image_url, size, format, crop, bg_color…) et reçoivent le même type de réponse : les octets de l’image avec les en-têtes X-Width, X-Height et X-Foreground-*, ou du JSON avec result_b64. Seules l’URL et la clé changent.
Est-ce compatible avec Zapier, Make ou n8n ?
Oui. Dans votre étape de requête HTTP (Zapier Webhooks, Make HTTP, n8n HTTP Request), remplacez l’URL par https://removebackground.dev/v1.0/removebg et la valeur X-Api-Key par votre clé removebackground.dev. Rien d’autre ne change.
Combien ça coûte ?
1 crédit par image réussie, quels que soient la taille ou les options. Sans abonnement : recharges uniques de 17 $US, 49 $US ou 99 $US, et les crédits n’expirent jamais. Les images en échec sont gratuites. Les nouveaux comptes reçoivent 50 crédits offerts.
Quels paramètres remove.bg sont pris en charge ?
image_file, image_file_b64, image_url, size, format (auto, png, jpg, webp, zip), crop, crop_margin, roi, scale, position, channels, bg_color, bg_image_url et bg_image_file. type, type_level, semitransparency et les options shadow sont acceptés et ignorés : les requêtes qui les envoient fonctionnent quand même.
Puis-je consulter mon solde comme avant ?
Oui. GET https://removebackground.dev/v1.0/account avec votre clé renvoie vos crédits au format de compte de remove.bg.
removebackground.dev est-il affilié à remove.bg ?
Non. remove.bg est une marque de son propriétaire. removebackground.dev est un service indépendant qui accepte les mêmes requêtes API.
Changez avant le 1 décembre 2026 à 09:00 CET
L’API en libre-service de remove.bg prend fin le
Créez une clé, changez une ligne, testez une image. 50 crédits offerts.
remove.bg est une marque de son propriétaire ; removebackground.dev n’y est pas affilié.