Pourquoi utiliser l'API de détourage ?
Si vous gérez un catalogue produit important, l'upload manuel de chaque image devient vite chronophage et sujet à des oublis. L'API REST de Détourage Pro permet d'automatiser complètement le processus : envoyez une image en multipart/form-data, recevez le résultat détouré en quelques secondes.
Cas d'usage typiques :
- Traitement automatique à l'import de nouveaux produits WooCommerce
- Script batch pour nettoyer un catalogue existant de 500+ références
- Pipeline d'images dans un ERP ou PIM (Akeneo, Plytix…)
- Application mobile qui prend une photo et la traite à la volée
Obtenir votre clé API
Créez un compte sur detourmoi.com, choisissez un plan (à partir du plan Starter à 4,90 €/mois pour 100 crédits) et récupérez votre clé API dans votre tableau de bord. Elle se présente sous la forme :
dtg_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Cette clé est à transmettre dans l'en-tête HTTP X-API-Key de chaque requête.
Premier appel API en Python
L'exemple le plus simple — traiter une seule image :
import requests
API_KEY = "dtg_votre_cle_ici"
IMAGE_PATH = "produit.jpg"
with open(IMAGE_PATH, "rb") as f:
response = requests.post(
"https://detourmoi.com/api/v1/remove-bg",
headers={"X-API-Key": API_KEY},
files={"image": f},
data={
"model": "isnet-general-use", # ou 'combined', 'combined_portrait'
"format": "png", # png | webp | jpeg
"bg_type": "transparent" # transparent | color | blur
}
)
if response.status_code == 200:
with open("produit_detouré.png", "wb") as out:
out.write(response.content)
print("✅ Détourage terminé !")
else:
print(f"❌ Erreur {response.status_code}: {response.text}")
Traitement par lot (batch) en Python
Pour traiter un dossier entier d'images en une seule passe :
import os, requests, time
API_KEY = "dtg_votre_cle"
IN_DIR = "./produits"
OUT_DIR = "./produits_detouré"
os.makedirs(OUT_DIR, exist_ok=True)
EXTENSIONS = {'.jpg', '.jpeg', '.png', '.webp'}
for filename in os.listdir(IN_DIR):
ext = os.path.splitext(filename)[1].lower()
if ext not in EXTENSIONS:
continue
with open(f"{IN_DIR}/{filename}", "rb") as f:
r = requests.post(
"https://detourmoi.com/api/v1/remove-bg",
headers={"X-API-Key": API_KEY},
files={"image": f},
data={"model": "isnet-general-use", "format": "png"}
)
if r.status_code == 200:
out_name = os.path.splitext(filename)[0] + "_detouré.png"
with open(f"{OUT_DIR}/{out_name}", "wb") as out:
out.write(r.content)
print(f"✅ {filename} → {out_name}")
else:
print(f"❌ Échec sur {filename}: {r.status_code}")
time.sleep(0.5) # respectez le rate limit
print("🎉 Traitement terminé !")
Intégration WooCommerce (PHP)
Notre plugin WordPress officiel automatise le détourage au moment de l'upload des médias. Il suffit de :
- Télécharger le plugin depuis votre tableau de bord Détourage Pro
- L'installer dans Extensions → Ajouter → Téléverser
- Renseigner votre clé API dans Réglages → Détourage Pro
- Activer « Traitement automatique à l'import »
Chaque nouvelle image uploadée dans votre médiathèque est alors automatiquement détourée et remplacée par la version avec fond transparent ou fond blanc selon votre configuration.
Pour un appel manuel depuis du code PHP :
$api_key = 'dtg_votre_cle';
$image_path = '/chemin/vers/produit.jpg';
$ch = curl_init('https://detourmoi.com/api/v1/remove-bg');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => ["X-API-Key: $api_key"],
CURLOPT_POSTFIELDS => [
'image' => new CURLFile($image_path),
'model' => 'isnet-general-use',
'format' => 'png',
],
]);
$result = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
if ($status === 200) {
file_put_contents('/output/produit_detouré.png', $result);
echo "✅ Succès";
}
Quotas et plans tarifaires
Chaque traitement consomme 1 crédit. Voici les plans disponibles :
- Free : 5 crédits/mois — idéal pour tester
- Starter : 100 crédits/mois — 4,90 €
- Pro : 2 000 crédits/mois — 19 €/mois
- Business : 5 000 crédits/mois — 49 €/mois
- Pay-as-you-go : packs 100 / 500 / 1 000 crédits sans abonnement