1 crédit par appel
API de suppression d'arrière-plan
Supprimez l'arrière-plan de vos images par code avec une seule requête POST. Une clé d'API, une sortie en PNG transparent et un service sans état qui ne conserve jamais les images que vous envoyez.
- REST · JSON
- Sans filigrane
- Rien n'est stocké
POST /v1/remove-background
Qu'est-ce que l'API de suppression d'arrière-plan ?
L'API de suppression d'arrière-plan ImgGen AI est un endpoint REST qui sépare le sujet au premier plan de l'arrière-plan d'une photo et renvoie un PNG transparent. Vous envoyez une image via HTTPS, l'IA détecte le sujet automatiquement, et le détourage revient encodé en base64 dans la réponse JSON. Aucun masque ni sélection manuelle n'est nécessaire.
C'est l'un des sept endpoints de l'API d'édition d'images ImgGen AI, qui partagent tous une seule clé d'API, une seule URL de base et le même format de requête et de réponse. Si vous avez aussi besoin de cette fonction dans un navigateur plutôt que depuis du code, le même modèle d'IA anime l'outil Background Remover.
Paramètres de la requête
Envoyez une requête POST vers https://app.imggen.ai/v1/remove-background, authentifiée avec une clé d'API dans l'en-tête Authorization.
| Paramètre | Type | Obligatoire | Par défaut | Description |
|---|---|---|---|---|
| image | file | OBLIGATOIRE | — | The input image to process. Accepts JPEG (JPG), PNG and WebP, up to 25 MB. |
Comment intégrer l'API de suppression d'arrière-plan ?
Créez une clé d'API dans votre compte ImgGen, enregistrez-la comme variable d'environnement et appelez l'endpoint. Voici la même requête en cURL, Node.js et Python.
curl --request POST \
--url 'https://app.imggen.ai/v1/remove-background' \
--header 'Authorization: Bearer sk_live_YOUR_API_KEY' \
--form image=@/path/to/photo.jpgimport fs from 'node:fs';
const form = new FormData();
form.append('image', new Blob([fs.readFileSync('photo.jpg')]), 'photo.jpg');
const res = await fetch('https://app.imggen.ai/v1/remove-background', {
method: 'POST',
headers: { Authorization: `Bearer ${process.env.IMGGEN_API_KEY}` },
body: form,
});
const data = await res.json();
// data.image is a base64-encoded PNG
fs.writeFileSync('result.png', Buffer.from(data.image, 'base64'));import base64, os, requests
with open("photo.jpg", "rb") as f:
res = requests.post(
"https://app.imggen.ai/v1/remove-background",
headers={"Authorization": f"Bearer {os.environ['IMGGEN_API_KEY']}"},
files={"image": f},
)
data = res.json()
with open("result.png", "wb") as out:
out.write(base64.b64decode(data["image"]))Réponse
Un appel réussi renvoie du JSON. Le résultat est encodé en base64 — décodez-le avant de l'écrire sur disque ou dans votre stockage objet. Chaque réponse réussie porte aussi un en-tête X-Credit-Remaining avec votre solde après l'appel.
{
"success": true,
"message": "Background removed successfully",
"image": "iVBORw0KGgoAAAANSUhEUgAA...SUVORK5CYII="
}Limites et comportements à connaître
L'endpoint accepte JPEG (JPG), PNG et WebP avec une taille de fichier maximale de 25 Mo, et répond de façon synchrone en moins de 60 secondes : aucun job à interroger, aucun webhook à configurer.
Sortie en PNG transparent
Le résultat est renvoyé avec un vrai canal alpha : vous pouvez le composer sur n'importe quel fond, couleur ou gabarit sans seconde requête.
Aucun masque requis
La détection du sujet est automatique — le premier plan est séparé de l'arrière-plan pour vous. Rien à peindre, à détourer ni à passer en second paramètre : envoyez l'image d'entrée et lisez le résultat.
Rien n'est stocké
L'entrée est conservée dans un objet temporaire le temps de l'appel, puis supprimée. Utile quand vous traitez des photos de clients que vous n'avez pas le droit de conserver.
À quoi sert l'API de suppression d'arrière-plan ?
Là où les équipes mettent cet endpoint en production pour traiter des images par programmation, à grande échelle.
Catalogues e-commerce
Détourez les images produit de vos fournisseurs dès l'envoi pour que chaque annonce affiche un détourage net et homogène, sans étape d'édition manuelle.
Places de marché et petites annonces
Normalisez automatiquement les photos envoyées par les vendeurs. Passez chaque envoi par l'endpoint et stockez le PNG transparent à côté de l'original.
Print-on-demand
Isolez visuels et sujets avant de les composer sur des mockups, pour que les aperçus s'affichent correctement à toutes les tailles de produit.
SaaS de design et d'édition
Offrez à vos utilisateurs la suppression d'arrière-plan en un clic dans votre propre produit sans entraîner de modèle, l'héberger ni faire tourner votre propre inférence sur AWS ou ailleurs.
Combien coûte l'API de suppression d'arrière-plan ?
Chaque appel réussi coûte 1 crédit : votre coût réel par image dépend donc du forfait que vous avez. Les crédits proviennent de votre forfait et sont partagés entre tous les endpoints et l'éditeur web, vous n'achetez donc pas un quota séparé par outil. Un appel qui échoue est remboursé automatiquement. Voir tous les détails sur la page tarifs.
| Forfait | Prix | Crédits | API |
|---|---|---|---|
| Free | $0 | 50 crédits gratuits en une fois | Pas d'accès à l'API |
| Starter | $9.99 / month | 400 crédits / mois | Accès à l'API inclus |
| Pro | $29.99 / month | 1 400 crédits / mois | Accès à l'API + support prioritaire |
| Enterprise | Custom | Volume sur mesure | Infrastructure dédiée |
Coûts en crédits et limites vérifiés pour la dernière fois le 2026-08-27.
Endpoints et outils associés
Les équipes qui utilisent l'API de suppression d'arrière-plan se tournent ensuite généralement vers ceux-ci.
Également disponibles : Agrandissement d'images, Restauration de photos, Colorisation de photos, Génération d'images.
FAQ sur l'API de suppression d'arrière-plan
- C'est un endpoint HTTP qui reçoit une photo et renvoie cette même photo avec l'arrière-plan supprimé et le sujet conservé sur un calque transparent. Comme c'est une API et non un éditeur, vous pouvez l'appeler depuis un job backend, un worker de file ou le gestionnaire d'envoi de vos utilisateurs et traiter des milliers d'images sans que personne n'ouvre un navigateur.
- Créez une clé d'API dans votre compte ImgGen, puis envoyez en POST un formulaire multipart contenant un champ image vers https://app.imggen.ai/v1/remove-background avec un en-tête Authorization: Bearer. La réponse est en JSON ; décodez le champ image en base64 et écrivez-le sur disque ou dans votre stockage objet. Des exemples fonctionnels en cURL, Node.js et Python figurent sur cette page.
- Un crédit par appel réussi — l'endpoint le moins cher de l'API. Starter inclut 400 crédits par mois pour 9,99 $, soit environ 400 suppressions d'arrière-plan, et Pro en inclut 1 400 pour 29,99 $. Les crédits non utilisés sont reportés tant que l'abonnement est actif, et les appels en échec sont remboursés automatiquement : vous n'êtes facturé que pour les images qui reviennent.
- Vous pouvez créer un compte et tester les outils d'IA avec 50 crédits gratuits et sans carte bancaire. L'accès à l'API fait partie des forfaits payants Starter et Pro ; il n'existe pas de palier d'API gratuit permanent, et nous préférons le dire plutôt que d'en annoncer un qui vous bride ensuite en silence.
- L'API accepte les fichiers JPEG (JPG), PNG et WebP jusqu'à 25 Mo par image. Les résultats sont renvoyés sous forme d'image encodée en base64 dans la réponse JSON.
- Non. L'API est sans état : elle ne crée aucun projet, n'enregistre aucun fichier et ne conserve pas votre image. Votre envoi est écrit dans un objet temporaire, traité, puis supprimé dès que la réponse est renvoyée. La seule chose conservée est un journal d'utilisation indiquant qu'un appel a eu lieu et combien de crédits il a coûté. Vos images ne servent jamais à entraîner des modèles.
- Oui. Tous les forfaits, y compris le forfait gratuit, incluent des droits d'usage commercial complets, et aucun résultat ne porte de filigrane. Vous pouvez vendre, imprimer ou publier tout ce que l'API renvoie.
- L'endpoint renvoie un PNG transparent : composer une nouvelle couleur, un dégradé ou un décor se fait dans votre propre pipeline, sans second appel d'API. L'éditeur web ImgGen propose aussi un générateur d'arrière-plans si vous préférez des décors générés par IA plutôt que vos propres visuels.
Commencer
Commencez à appeler l'API de suppression d'arrière-plan
Une seule clé débloque les sept endpoints. Sans filigrane, avec des droits commerciaux complets, et rien de ce que vous envoyez n'est conservé une fois la réponse renvoyée.
Obtenir votre clé d'API