Suppression d'arrière-plan Recraft pour les images produits e-commerce

Le détourage manuel de l'arrière-plan des produits ne passe plus l'échelle au-delà de quelques dizaines de SKU. Le modèle de suppression d'arrière-plan de Recraft sur hiapi transforme cette tâche en un seul appel d'API : envoyez une photo produit, recevez un PNG propre à fond transparent, puis placez-le sur n'importe quel arrière-plan exigé par votre place de marché ou votre boutique. Cet article vous guide à travers une exécution par lots réelle sur recraft/remove-background, avec les requêtes réelles, les sorties réelles, et un script que vous pouvez pointer vers un catalogue produits complet.

Pourquoi la suppression d'arrière-plan reste un véritable goulot d'étranglement

La plupart des pipelines d'images produits se ressemblent : les photos envoyées par un photographe ou un fournisseur arrivent avec l'arrière-plan disponible sur le moment — fond de studio sans couture, sol d'entrepôt, palette de transport — et quelqu'un doit d'abord isoler le produit avant qu'il puisse être intégré à une page de liste sur fond blanc, à un montage en situation, ou à un template de place de marché qui impose une couleur d'arrière-plan spécifique selon la catégorie.

Au-delà de quelques images par semaine, faire cela dans Photoshop ne passe pas l'échelle, et les outils web génériques de « suppression d'arrière-plan par IA » impliquent de téléverser les photos produits une par une via un navigateur, ce qui est lent et difficile à automatiser. Un modèle de détourage basé sur une API résout ces deux problèmes : le traitement est rapide par image, et l'appel depuis un script est extrêmement simple, ce qui s'intègre directement dans votre pipeline existant de catalogue de photos produits.

Ce que fait réellement recraft/remove-background

Le modèle n'accepte qu'une seule entrée : l'URL de la photo produit. Il renvoie un PNG dont l'arrière-plan a été supprimé et remplacé par une zone transparente — pas de prompt, pas de masque, aucun paramètre supplémentaire à ajuster. La requête entière est :

{
  "model": "recraft/remove-background",
  "input": {
    "image_url": "https://your-cdn.example.com/products/sneaker-001.jpg"
  }
}

Pour les tâches de catalogue, une surface d'entrée étroite est un avantage : aucune étape de prompt engineering, le même appel fonctionne de la même manière sur chaque photo produit que vous lui soumettez, ce qui compte lorsqu'on traite des milliers de SKU sans surveillance.

Une exécution réelle : avant/après

Voici une vraie photo produit passée par l'API en direct, ainsi que le détourage qu'elle a renvoyé :

Le motif en damier sur la droite indique la transparence, et non un fond gris — la sortie PNG a entièrement supprimé l'arrière-plan, vous pouvez donc composer le produit sur tout ce que vous voulez en aval : fond blanc uni pour les fiches, aplat de couleur de marque ou scène de vie.

Le détourage isolé enregistré en PNG transparent ressemble à ceci :

Ce fichier peut être placé directement dans un template de fiche, dans un cadre à fond blanc conforme aux exigences d'une place de marché, ou dans la pile de calques d'un outil de design, sans aucun travail de masquage supplémentaire.

Appel direct

La requête est envoyée au point de terminaison standard des tâches asynchrones de hiapi. Soumettez la tâche, puis interrogez son état jusqu'à ce qu'elle soit terminée :

curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "recraft/remove-background",
    "input": {
      "image_url": "https://your-cdn.example.com/products/sneaker-001.jpg"
    }
  }'

Il renvoie un taskId. Interrogez GET https://api.hiapi.ai/v1/tasks/{taskId} jusqu'à ce que status vaille success, puis téléchargez immédiatement le PNG depuis output[0].url — les URL de sortie expirent, donc récupérez les octets dans votre propre stockage avant toute autre opération dessus.

Traitement par lots sur tout le catalogue

L'appel de détourage unitaire n'est pas la partie intéressante — c'est son exécution sur tout le catalogue produits qui l'est. Voici un script de traitement par lots réel qui distribue une liste d'URL d'images dans un pool de threads, attend chaque tâche, et renvoie une correspondance entre la photo source et l'URL du détourage :

import concurrent.futures
import os
import time
import requests

API_KEY = os.environ["HIAPI_API_KEY"]
BASE_URL = "https://api.hiapi.ai/v1/tasks"


def remove_background(image_url: str) -> str:
    resp = requests.post(
        BASE_URL,
        headers={"Authorization": f"Bearer {API_KEY}"},
        json={"model": "recraft/remove-background", "input": {"image_url": image_url}},
        timeout=60,
    )
    resp.raise_for_status()
    task_id = resp.json()["data"]["taskId"]

    while True:
        poll = requests.get(
            f"{BASE_URL}/{task_id}",
            headers={"Authorization": f"Bearer {API_KEY}"},
            timeout=30,
        )
        task = poll.json()["data"]
        if task["status"] == "success":
            return task["output"][0]["url"]
        if task["status"] == "fail":
            raise RuntimeError(f"{image_url}: {task['error']}")
        time.sleep(3)


def batch_remove_background(image_urls, max_workers: int = 5):
    results = {}
    with concurrent.futures.ThreadPoolExecutor(max_workers=max_workers) as pool:
        futures = {pool.submit(remove_background, url): url for url in image_urls}
        for future in concurrent.futures.as_completed(futures):
            url = futures[future]
            try:
                results[url] = future.result()
            except Exception as exc:
                print(f"failed: {url} -> {exc}")
    return results

max_workers=5 est un point de départ raisonnable pour une tâche de catalogue — augmentez-le si les limites de débit de votre compte autorisent davantage de tâches en parallèle, et conservez toujours un try/except par image afin qu'une mauvaise photo source ne bloque pas le reste du lot. Téléchargez chaque URL de résultat dans un stockage permanent dès qu'elle est renvoyée ; ne supposez pas que l'URL de sortie sera encore valide plus tard.

Coût à l'échelle du catalogue

En date de septembre 2026, le tarif de recraft/remove-background sur hiapi est de 0,01 $ par image. Pour un catalogue de 500 SKU avec une image principale chacun, détourer tout le lot ne coûte que 5 $ ; pour un catalogue nécessitant trois angles détourés par SKU, cela fait 15 $. Avant de planifier un gros lot, consultez la page de tarification en direct, car les tarifs peuvent évoluer.

Questions fréquentes

Faut-il un prompt ou un masque ? Non. La seule entrée est image_url. Rien à ajuster image par image, ce qui explique pourquoi il peut tourner sans surveillance sur de grands catalogues.

À quoi ressemble la sortie ? Un PNG dont l'arrière-plan est remplacé par une zone transparente, aux dimensions correspondant au cadrage du sujet sur la photo d'entrée. Composez-le sur l'arrière-plan requis par votre template de fiche.

Puis-je lui fournir des photos en situation avec un arrière-plan encombré, et pas seulement des photos studio ? Oui — il fonctionne sur n'importe quelle URL de photo produit, pas seulement sur des mises en scène studio propres, bien qu'un sujet clairement séparé (comme dans la plupart des photographies produits) donne les bords les plus nets.

Combien de temps prend une tâche ? Une tâche unitaire se termine généralement en quelques secondes à une minute ; le script par lots ci-dessus interroge chaque tâche toutes les 3 secondes et exécute plusieurs tâches en parallèle, donc quelques centaines d'images peuvent être traitées en une seule exécution de script.

Le prix varie-t-il selon la résolution de l'image ? Le modèle facture un tarif fixe par tâche, et non une tarification par paliers de résolution. Avant de vous engager sur un gros lot, confirmez le tarif actuel sur la page de tarification, car les tarifs publiés peuvent changer.

Où aller ensuite

Essayez le modèle directement sur la page du modèle recraft/remove-background, ou, si vous devez aussi générer de nouvelles scènes produits plutôt que simplement détourer des photos existantes, consultez le workflow de génération associé Générer des images produits e-commerce avec Qwen Image. Pour tout ce que l'API de tâches prend en charge, la documentation de démarrage rapide couvre l'authentification et le cycle de vie complet des tâches.