Une requête HTTP familière n’est qu’un point de départ. Testez images et intégration avec cette liste avant de basculer la production.
1. Vérifiez les requêtes utilisées
Listez méthode d’entrée, format de sortie, taille et paramètres d’édition. Fichiers, URL HTTPS et base64 simple sont acceptés, mais pas toutes les options remove.bg. Gardez les clés côté serveur et créez-en une sur un forfait avec API.
2. Remplacez le point de terminaison et la clé
Pour les requêtes compatibles, gardez la structure et remplacez l’origine et X-API-Key. Si une bibliothèque impose le domaine remove.bg, utilisez son endpoint configurable ou un client HTTP direct. N’envoyez pas de clé remove.bg à ce service.
- 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. Faites correspondre les paramètres avant les tests
La compatibilité concerne la forme des requêtes, pas des détourage identiques. type doit être auto, type_level none et channels rgba. Les paramètres non pris en charge et non vides sont rejetés, pas ignorés.
| Champ de requête | Prise en charge ici |
|---|---|
| image_file / image_url / image_file_b64 | Choisissez une seule entrée : image_file, image_url ou image_file_b64. |
| format | auto, png, jpg ou webp. ZIP n’est pas pris en charge. |
| size | Les plafonds de pixels varient selon le format. Consultez le tableau des tailles et les limites de sortie. |
| crop / bg_color | crop=true/false et bg_color sont pris en charge. |
| type / type_level / channels | Uniquement auto / none / rgba, respectivement. |
| bg_image_url / shadow / roi / crop_margin / scale / position | Non pris en charge : images de fond, ombres, ROI, marges de recadrage, échelle ou position. |
4. Vérifiez les réponses et la facturation
Lisez Content-Type avant d’enregistrer. L’API renvoie des octets d’image par défaut, ou du JSON avec result_b64 sur demande. Vérifiez X-Credits-Charged et X-Request-ID. Les clés et crédits remove.bg ne sont pas transférables. Ici, aperçu et pleine résolution ont le même coût par image.
5. Testez un jeu d'images représentatif
Testez produits, portraits, faibles contrastes et chaque format, puis fichiers trop volumineux, clés invalides, paramètres non pris en charge et crédits insuffisants. Vérifiez les 409, 429, délais dépassés et échecs. Conservez les identifiants de requête pour le diagnostic.
Idempotency-Key est facultatif : réutilisez clé, image et paramètres identiques pour rejouer un succès pendant 10 minutes sans nouveau débit. Le replay reprend X-Credits-Charged et ajoute X-Idempotent-Replayed: true. Les requêtes en cours renvoient 409. Les clés échouées ou expirées restent réservées : utilisez une nouvelle clé pour une nouvelle requête facturable. Sans cet en-tête, chaque requête est indépendante. Prévoyez un délai client de 180 secondes.
6. Basculez progressivement et prévoyez un retour arrière
Envoyez d’abord une petite part de votre charge à la nouvelle intégration. Vérifiez réussite, qualité et crédits avant d’augmenter le trafic. Gardez l’ancienne configuration disponible. Votre application gère le routage et le retour arrière, sans bascule automatique par ce service.
Ce service est indépendant de remove.bg. Testez le comportement, pas seulement les noms de paramètres.