API bgCut.net

Supprimez les arrière-plans depuis vos applications, boutiques ou pipelines avec une seule requête HTTPS.

URL de base : https://bgcut.net/api/v1 · Obtenez votre clé dans Clés API.

Authentification

Chaque requête doit inclure votre clé API dans l'en-tête X-Api-Key. Les clés se créent et se révoquent depuis votre compte ; chaque clé peut être nommée, ce qui vous permet d'en effectuer la rotation par application.

X-Api-Key: bgc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Vous pouvez aussi l'envoyer sous forme de jeton Bearer : Authorization: Bearer bgc_…

POST /remove

Envoyez l'image sous forme de fichier multipart, d'URL ou encodée en base64. Par défaut, la réponse est l'image obtenue (binaire).

Paramètres

ParamètreTypeDescription
image_filefileLe fichier image (multipart/form-data). JPG, PNG, WebP, GIF, BMP, TIFF ; max. 25 Mo / 30 MP.
image_urlstringURL publique de l'image à récupérer au lieu de l'envoyer.
image_file_b64stringImage encodée en base64 (éventuellement avec un préfixe data:).
sizeauto | preview | fullpreview = jusqu'à 640 px (utilise votre quota mensuel gratuit, sans crédit) ; full = résolution d'origine (1 crédit) ; auto (par défaut) = full si vous avez des crédits, sinon preview.
formatpng | jpg | webpFormat de sortie. png conserve la transparence ; jpg est aplati sur bg_color (blanc par défaut).
modelfast | hq | portraitfast (par défaut, ~1 s), hq (qualité supérieure, plus lent), portrait (optimisé pour les personnes).
bg_colorstringCouleur hexadécimale de l'arrière-plan, ex. #ffffff. À omettre pour un fond transparent.
bg_blurnumberConserve l'arrière-plan d'origine en le floutant avec ce rayon en pixels (1–200), par ex. 25 pour un effet mode portrait. Prioritaire sur bg_color.
cropbooleanRecadrer le résultat sur le cadre englobant du sujet.
crop_marginintegerMarge supplémentaire en pixels autour du sujet lors du recadrage (0–200).
roistringZone d'intérêt sous forme de fractions x,y,w,h (0–1). L'IA n'analyse que l'intérieur de ce rectangle ; tout ce qui se trouve à l'extérieur devient transparent.
feathernumberAdoucir les bords selon ce rayon en pixels (0–5).
qualityintegerQualité JPG/WebP de 50 à 100 (92 par défaut).
responsebinary | jsonbinary (par défaut) renvoie l'image ; json renvoie les métadonnées ainsi que l'image en base64.

Réponses

Les requêtes réussies renvoient HTTP 200 avec les octets de l'image et les en-têtes suivants :

HTTP/1.1 200 OK
Content-Type: image/png
X-Credits-Charged: 1
X-Credits-Remaining: 149
X-Free-Remaining: 5
X-Width: 3000
X-Height: 2000
X-Image-Id: 1f3a…
X-Type: hd

Avec response=json, vous obtenez :

{
  "ok": true,
  "image": { "id": "1f3a…", "width": 3000, "height": 2000, "format": "png", "type": "hd", "bytes": 812345, "bbox": [120, 40, 2810, 1990], "data": "iVBORw0KGgo…" },
  "credits_charged": 1,
  "credits_remaining": 149,
  "free_remaining": 5
}

GET /account

curl https://bgcut.net/api/v1/account -H "X-Api-Key: bgc_…"

{ "ok": true, "email": "[email protected]", "credits": 149, "free_remaining": 5, "free_per_month": 5, "free_max_width": 640, "rate_limit_per_minute": 60 }

GET /images

Renvoie les 100 dernières images traitées avec vos clés API, avec une URL d'éditeur pour les retoucher dans le navigateur.

Erreurs

Les erreurs sont renvoyées en JSON avec un code d'erreur et un message lisible :

{ "ok": false, "error": "insufficient_credits", "message": "No credits left. Buy credits at https://bgcut.net/pricing or request size=preview." }
HTTPerrorDescription
400bad_request / missing_imageParamètres manquants ou non valides.
401auth_required / invalid_keyClé API manquante, non valide ou révoquée.
402insufficient_credits / free_quota_exceededAucun crédit (pour la taille réelle) ou quota gratuit épuisé (pour l'aperçu).
422too_large / bad_type / fetch_failedImpossible de lire ou de télécharger l'image.
429rate_limitedTrop de requêtes – ralentissez ou contactez-nous pour obtenir des limites plus élevées.
500processing_failedLe traitement a échoué de notre côté – aucun crédit n'est débité.

Exemples de code

Tous les exemples utilisent le même endpoint. Téléchargez la collection complète d'exemples : bgcut-api-examples.zip

Limites

  • 60 requêtes par minute et par clé API (limites plus élevées sur demande).
  • 25 Mo et 30 mégapixels maximum par image ; les images plus grandes sont réduites.
  • Les images traitées sont conservées 30 jours et peuvent être retouchées dans l'éditeur en ligne.
  • Les requêtes échouées ne sont jamais facturées ; un débit est remboursé automatiquement si la génération du résultat échoue.

Lancez l'intégration

Créez un compte gratuit, générez une clé et effectuez votre premier appel en moins d'une minute.

Obtenir une clé API Tarifs