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é API

Un 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

401Clé absente, invalide ou révoquée (en-tête X-Werise-Cle).
402Crédit épuisé : rechargez votre compte.
413 / 415 / 422Image trop lourde (10 Mo max), format non accepté (JPEG, PNG, WebP) ou illisible. Non facturé.
429Plus de 20 requêtes par minute : accès suspendu 5 minutes (voir Retry-After). Non facturé.
503Service 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.