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 :
| Avant | https://api.remove.bg/v1.0/removebg |
|---|---|
| Après | https://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.
Ce que change la fermeture du 1er décembre, et quoi faire en premierObtenir une clé
- Connectez-vous avec Google.
- Ouvrez Mon compte et créez une clé dans « Clés de l'API de détourage ».
- Copiez la clé dès qu'elle s'affiche. Elle n'apparaît qu'une fois.
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 -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/removebgimport 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)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.
| Champ | Valeurs | Remarques |
|---|---|---|
| image_file | fichier | JPG, PNG ou WebP, jusqu'à 22 Mo. |
| image_file_b64 | chaîne base64 | Le même fichier en base64. Le préfixe data: URL est accepté. |
| image_url | URL http(s) | Nous la téléchargeons. Adresses publiques et ports web standard uniquement, 3 redirections au maximum. |
| size | preview · small · regular · medium · hd · full · 4k · auto · 50MP | preview/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. |
| format | auto · png · jpg · webp · zip | auto renvoie un PNG si le résultat est transparent, un JPG sinon. zip contient color.jpg et alpha.png, comme sur remove.bg. |
| channels | rgba · alpha | alpha renvoie uniquement le masque, en niveaux de gris. |
| bg_color | hex (81d4fa, #81d4fa77) ou nom de couleur | Remplit l'arrière-plan supprimé. Un JPG sans bg_color est aplati sur du blanc. |
| crop | true · false | Recadre le résultat sur le sujet. |
| crop_margin | ex. 30px ou 10% | Marge autour du sujet recadré. Jusqu'à 500px ou 50 %. |
| type | auto · person · product · car · animal · graphic · transportation | Accepté par compatibilité. Renvoyé dans X-Type ; ne change pas le détourage. |
| model | fast · precise | Option ajoutée par nos soins (remove.bg ne l'a pas). fast, par défaut : notre modèle standard. precise : contours plus fins sur cheveux, parties fines et verre, un peu plus lent. Les deux comptent pour une image ; l'en-tête X-Imagic-Model indique celui utilisé. |
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. Une image payée avec un crédit porte aussi X-Imagic-Paid: 1 et X-Imagic-Credit-Balance. Envoyez Accept: application/json pour obtenir du 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. api.free_calls indique le nombre d'images gratuites restantes aujourd'hui, credits.payg le solde de crédits du compte et credits.total la somme des deux.
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 free images reached. …", "code": "rate_limit_exceeded"}]}| Statut | Signification |
|---|---|
| 400 | Entré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. |
| 403 | L'en-tête X-Api-Key est absent, erroné ou révoqué. |
| 422 | Le modèle demandé n'est pas disponible pour le moment (code model_unavailable). Réessayez avec model=fast ; l'image n'est pas décomptée. |
| 429 | Les 50 images gratuites du jour sont épuisées et le compte n'a plus de crédits, ou il a atteint 1 000 images payantes aujourd'hui. Retry-After donne le nombre de secondes avant la remise à zéro des images gratuites. |
| 503 | Le 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.
- Au-delà des 50 images gratuites, chaque image utilise un crédit du solde du compte, jusqu'à 1 000 images payantes par jour. Les crédits s'achètent sur la page du compte (100 pour 5 $ US ou 500 pour 19 $ US) et n'expirent pas.
À 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. Au-delà, chaque image utilise un crédit (100 crédits coûtent 5 $ US).
- 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