Introduction
Background Remover sépare le sujet principal d’une photo de tout ce qui se trouve derrière lui et le renvoie sur un fond entièrement transparent. Vous envoyez une URL d’image et recevez un PNG avec canal alpha, à la même largeur et à la même hauteur que l’original, si bien que le détourage se superpose au pixel près à la source chaque fois que vous devez combiner les deux.
Il n’y a ni prompt, ni masque, ni réglage : l’outil décide seul de ce qui constitue le premier plan.
Fonctionnalités et points forts
Une transparence prête pour la mise en page
Les pixels du fond ne sont pas peints en blanc mais rendus entièrement transparents, si bien que le résultat se pose sur n’importe quelle couleur, dégradé ou photo sans cadre autour. C’est le format qu’attendent les places de marché, les présentations, les logiciels de design et les pages web pour les détourages de produits et de portraits.
Rien à écrire, rien à régler
La requête tient en une seule URL d’image. Comme rien n’est formulé, il n’y a pas de mauvaise tournure possible ni de second essai dû à une consigne ambiguë, ce qui permet de traiter facilement tout un dossier de photos de catalogue dans une boucle.
Dimensions d’origine conservées
Le détourage revient à la taille du fichier envoyé et non dans un carré fixe. Vous pouvez donc le reposer sur la source, l’utiliser comme masque ou le transmettre à l’étape suivante sans redimensionnement.
Paramètres de requête
| Paramètre | Obligatoire | Description |
|---|---|---|
image_url | Oui | La photo à détourer, en JPEG, PNG ou WebP. Le sujet est détecté automatiquement ; recadrez d’abord si le cadre contient plusieurs candidats. 1 caractères minimum |
Tarification
$0.0048 / image
Facturé par image produite ; la taille de la photo envoyée ne change pas le prix.
Cas d’utilisation
Catalogue produit et annonces de places de marché
Photographiez vos produits sur le support disponible, supprimez ensuite le fond et placez chaque article sur la même couleur unie. Un fond homogène sur toutes les annonces est l’amélioration visuelle la plus rapide pour une boutique, et il n’exige plus un fond studio pour chaque article.
Avatars, pages d’équipe et miniatures
Isolez des personnes d’un mur de bureau, d’un salon ou d’une scène de rue pour créer des photos de profil, des cartes d’intervenants et des miniatures vidéo sur un fond aux couleurs de la marque.
Première étape d’une retouche plus longue
Détourez le sujet avant un montage : supprimez le fond ici, construisez une nouvelle scène avec Image Expander, puis reposez le PNG transparent par-dessus.
Guide de prompt et conseils pratiques
Choisissez des photos au sujet net
L’outil choisit seul le premier plan. Il est le plus fiable quand une personne ou un objet domine clairement le cadre et se détache du fond par la couleur ou la lumière. Si une image montre plusieurs personnes ou objets d’importance égale, recadrez sur celui que vous voulez avant l’envoi, car l’outil pourrait en garder plus que prévu.
Vérifiez les contours fins à taille réelle
Les cheveux, la fourrure, la dentelle, la fumée et le verre sont les zones les plus délicates d’un détourage. Examinez-les en zoomant avant publication, surtout quand le fond partage les couleurs du sujet. Une nouvelle prise de vue devant un fond plus sobre corrige davantage qu’un second passage de la même photo.
Conservez le fichier en PNG
La transparence ne survit que dans les formats qui la prennent en charge. Enregistrez et transmettez le résultat en PNG ; une conversion en JPEG remplit la zone transparente d’une couleur unie et fait revenir le rectangle que vous venez d’enlever.
Démarrage rapide de l’API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "spicyapi/background-remover-v1/edit",
"input": {
"image_url": "https://example.com/reference.png"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
La référence API détaille l’authentification, le schéma complet, le polling et la gestion des erreurs.
