Développeurs · API v1
API Détourage Werise
Enlevez le fond de vos images depuis votre propre application : boutique en ligne, menu de restaurant, petites annonces, studio photo. 10 F la requête, payés d'avance.
Obtenir une clé APIUn PNG transparent
Vous envoyez une photo, vous recevez l'objet détouré en pleine résolution, prêt à publier.
10 F la requête
Crédit acheté d'avance par Mobile Money. Une requête qui échoue n'est jamais facturée.
Sécurisé
Clés chiffrées, révocables à tout moment ; vos images ne sont jamais conservées.
Mon espace
Crédit, clés et consommation
Chargement…
Utilisation
Une requête, une image
Envoyez l'image en multipart/form-data dans le champ image, avec votre clé dans l'en-tête X-Werise-Cle (jamais dans l'URL). La réponse est le PNG transparent ; l'en-tête X-Credit-Restant indique les requêtes qui vous restent.
curl -X POST https://admin.weriseapp.tech/api/detourage/v1/detourer \
-H "X-Werise-Cle: wr_det_votre_cle" \
-F "image=@photo.jpg" \
-o photo-sans-fond.png// Côté serveur (Node 18+) : ne mettez jamais la clé dans le navigateur.
const form = new FormData();
form.append("image", new Blob([octets], { type: "image/jpeg" }), "photo.jpg");
const r = await fetch("https://admin.weriseapp.tech/api/detourage/v1/detourer", {
method: "POST",
headers: { "X-Werise-Cle": process.env.WERISE_CLE_DETOURAGE },
body: form,
});
if (!r.ok) throw new Error((await r.json()).message);
const png = Buffer.from(await r.arrayBuffer());
console.log("Crédit restant :", r.headers.get("X-Credit-Restant"));Formats acceptés : JPEG, PNG, WebP, 10 Mo au maximum. Le résultat fait au plus 4096 px de côté, sans les métadonnées de l'original (position GPS, appareil). Comptez quelques secondes par image.
Limites
Erreurs et protection
| 401 | Clé absente, invalide ou révoquée (en-tête X-Werise-Cle). |
| 402 | Crédit épuisé : rechargez votre compte. |
| 413 / 415 / 422 | Image trop lourde (10 Mo max), format non accepté (JPEG, PNG, WebP) ou illisible. Non facturé. |
| 429 | Plus de 20 requêtes par minute : accès suspendu 5 minutes (voir Retry-After). Non facturé. |
| 503 | Service momentanément occupé : réessayez après le délai Retry-After. Non facturé. |
Seules les images détourées avec succès sont débitées. Une clé exposée par erreur se révoque en un clic depuis votre espace : elle cesse de fonctionner immédiatement.