API

Documentation API publique

Remove Background expose une API publique simple pour supprimer automatiquement le fond d'une image. Le point d'entrée public est limité à 5 images par minute et par IP.

Vue d'ensemble

L'API publique actuelle est pensée pour des intégrations simples : vous envoyez une image en multipart/form-data et vous récupérez directement un PNG transparent en réponse.

Endpoint public

POST/api/remove-background

Rate limit

Maximum 5 images par minute et par IP sur l'endpoint public POST /api/remove-background.

Formats supportés

Entrée : JPEG, PNG, WebP. Sortie : PNG transparent.

Paramètres ModNet

Les paramètres sont optionnels et doivent être envoyés en champs multipart/form-data en plus du fichier.

threshold : seuil alpha entre 0 et 255. Défaut : 12.
feather : flou de bord entre 0 et 24. Défaut : 2.0.
foreground_strength : intensité du sujet entre 0.5 et 2.0. Défaut : 1.0.

Exemple cURL

curl -X POST \
  -F "file=@/path/to/image.jpg" \
  -F "threshold=16" \
  -F "feather=3.5" \
  -F "foreground_strength=1.15" \
  https://remove.openutils.net/api/remove-background \
  --output result.png

Réponse

La réponse contient directement l'image PNG générée. En cas de dépassement de limite, l'API renvoie HTTP 429.

Healthcheck

curl https://remove.openutils.net/api/health

GET /api/health permet de vérifier si le moteur est prêt.