Développeurs

API de suppression d'arrière-plan

Les mêmes requêtes que l'API remove.bg, les mêmes réponses. Changez l'URL de base et la clé ; le reste de votre code ne bouge pas.

Quitter remove.bg

remove.bg a annoncé la fermeture de son service autonome le 1er décembre 2026 et l'arrêt le même jour des requêtes de son API en libre-service, qui passe chez Leonardo.Ai. Si votre code appelle api.remove.bg, faites-le pointer ici :

Avanthttps://api.remove.bg/v1.0/removebg
Aprèshttps://imagic-ai.com/api/v1.0/removebg

L'en-tête reste X-Api-Key, les champs gardent leurs noms et les erreurs le format de remove.bg : les bibliothèques clientes dont l'URL de base est réglable fonctionnent telles quelles.

Obtenir une clé

  1. Connectez-vous avec Google.
  2. Ouvrez Mon compte et créez une clé dans « Clés de l'API de détourage ».
  3. Copiez la clé dès qu'elle s'affiche. Elle n'apparaît qu'une fois.
Créer une clé

Démarrage rapide

Envoyez l'image en fichier, en base64 ou sous forme d'URL publique. Le corps de la réponse est l'image finale.

curl
curl -H "X-Api-Key: $IMAGIC_API_KEY" \
  -F "image_file=@photo.jpg" \
  -F "size=auto" \
  -o no-bg.png \
  https://imagic-ai.com/api/v1.0/removebg
Python
import os, requests

response = requests.post(
    "https://imagic-ai.com/api/v1.0/removebg",
    files={"image_file": open("photo.jpg", "rb")},
    data={"size": "auto"},
    headers={"X-Api-Key": os.environ["IMAGIC_API_KEY"]},
)
response.raise_for_status()
with open("no-bg.png", "wb") as out:
    out.write(response.content)
Node.js
import { readFile, writeFile } from "node:fs/promises";

const form = new FormData();
form.append("image_file", new Blob([await readFile("photo.jpg")]), "photo.jpg");
form.append("size", "auto");

const res = await fetch("https://imagic-ai.com/api/v1.0/removebg", {
  method: "POST",
  headers: { "X-Api-Key": process.env.IMAGIC_API_KEY },
  body: form,
});
if (!res.ok) throw new Error(JSON.stringify(await res.json()));
await writeFile("no-bg.png", Buffer.from(await res.arrayBuffer()));

Champs de la requête

POST /api/v1.0/removebg accepte multipart/form-data, application/x-www-form-urlencoded ou JSON. Envoyez un seul des trois champs d'image.

ChampValeursRemarques
image_filefichierJPG, PNG ou WebP, jusqu'à 22 Mo.
image_file_b64chaîne base64Le même fichier en base64. Le préfixe data: URL est accepté.
image_urlURL http(s)Nous la téléchargeons. Adresses publiques et ports web standard uniquement, 3 redirections au maximum.
sizepreview · small · regular · medium · hd · full · 4k · auto · 50MPpreview/small/regular : jusqu'à 0,25 MP. medium : 1,5 MP. hd : 4 MP. full/4k/auto/50MP : jusqu'à 25 MP (10 MP en PNG). Chaque taille compte pour une image.
formatauto · png · jpg · webp · zipauto renvoie un PNG si le résultat est transparent, un JPG sinon. zip contient color.jpg et alpha.png, comme sur remove.bg.
channelsrgba · alphaalpha renvoie uniquement le masque, en niveaux de gris.
bg_colorhex (81d4fa, #81d4fa77) ou nom de couleurRemplit l'arrière-plan supprimé. Un JPG sans bg_color est aplati sur du blanc.
croptrue · falseRecadre le résultat sur le sujet.
crop_marginex. 30px ou 10%Marge autour du sujet recadré. Jusqu'à 500px ou 50 %.
typeauto · person · product · car · animal · graphic · transportationAccepté par compatibilité. Renvoyé dans X-Type ; ne change pas le détourage.

scale, position, roi, bg_image_url, bg_image_file et les options d'ombre ne sont pas pris en charge. Les requêtes qui les utilisent reçoivent une erreur 400 plutôt qu'une image différente sans prévenir.

Réponse

Par défaut, le corps est l'image elle-même, avec ces en-têtes : X-Width, X-Height, X-Type, X-Foreground-Top, X-Foreground-Left, X-Foreground-Width, X-Foreground-Height, X-Credits-Charged (toujours 1) et X-RateLimit-Limit / -Remaining / -Reset pour le quota quotidien. Envoyez Accept: application/json pour obtenir du JSON :

Accept: application/json
{
  "data": {
    "result_b64": "iVBORw0KGgo…",
    "foreground_top": 115,
    "foreground_left": 477,
    "foreground_width": 637,
    "foreground_height": 824
  }
}

Quota restant

GET /api/v1.0/account renvoie la structure de compte de remove.bg. credits.total et api.free_calls indiquent tous deux le nombre d'images restantes aujourd'hui.

Erreurs

Les erreurs suivent le format de remove.bg, présenté ci-dessous. Une requête en échec ne consomme pas d'image.

{"errors": [{"title": "Daily limit of 50 images reached. …", "code": "rate_limit_exceeded"}]}
StatutSignification
400Entrée incorrecte : aucune image, deux images, un fichier illisible, une option non prise en charge ou une image_url que nous ne pouvons pas ou ne devons pas télécharger.
403L'en-tête X-Api-Key est absent, erroné ou révoqué.
429Les 50 images du jour sont épuisées. Retry-After donne le nombre de secondes avant la remise à zéro.
503Le traitement est momentanément indisponible. Réessayez dans un instant.

Limites

  • 50 images par jour et par compte, partagées entre toutes ses clés. Jusqu'à 3 clés actives par compte, pour pouvoir les faire tourner.
  • Envois jusqu'à 22 Mo. Sortie jusqu'à 25 MP, ou 10 MP en PNG.
  • Les requêtes sont mises en file et traitées quelques-unes à la fois. Comptez quelques secondes par image, davantage pour les grandes photos.
  • Il n'existe pas encore d'offre payante : pour l'instant, le quota quotidien est le plafond.

À quoi s'attendre côté détourage

Le détourage vient du modèle isnet-general-use, le même que l'outil Suppression d'arrière-plan. Il est fiable sur les produits, les personnes et les animaux devant des fonds ordinaires. Ses points faibles sont les cheveux fins, le verre et les sujets de la même couleur que le fond ; là, le modèle de remove.bg peut faire mieux. Testez quelques-unes de vos images avant de basculer un flux de production.

Questions

Est-ce un remplaçant officiel de remove.bg ?
Non. Imagic AI n'est affilié ni à remove.bg, ni à Canva, ni à Leonardo.Ai. L'API accepte le format de requête de remove.bg pour que le code existant continue de fonctionner.
L'API est-elle gratuite ?
Oui. Chaque compte dispose de 50 images par jour sans frais. Chaque taille, preview comprise, compte pour une image.
Les bibliothèques clientes officielles de remove.bg fonctionnent-elles ?
Celles dont l'URL de base est réglable fonctionnent en la remplaçant par https://imagic-ai.com/api. Celles où api.remove.bg est codé en dur demandent de modifier cette ligne ou d'ajouter un petit wrapper.
Conservez-vous mes images ?
Les images envoyées à l'API sont traitées puis renvoyées dans la réponse. Elles ne rejoignent aucune galerie et ne servent pas à l'entraînement.

Juste quelques images, sans code ?

Utiliser la Suppression d'arrière-plan