This page was machine-translated. Spotted a mistake?Help improve it.
Skip to content

Flouter l'arrière-plan

Floute l'arrière-plan d'une image tout en gardant le sujet net. Le modèle d'IA isole le sujet, applique un flou à l'arrière-plan d'origine et compose le sujet net par-dessus.

Point de terminaison de l'API

POST /api/v1/tools/image/blur-background

Accepte des données de formulaire multipart contenant un fichier image et un champ JSON settings.

Paramètres

ParamètreTypeRequisPar défautDescription
intensityentierNon50Intensité du flou (1 à 100)
featherentierNon0Rayon d'adoucissement des bords (0 à 20)
formatchaîneNon"png"Format de sortie : png ou webp

Exemple de requête

bash
curl -X POST http://localhost:1349/api/v1/tools/image/blur-background \
  -H "Authorization: Bearer si_your-api-key" \
  -F "[email protected]" \
  -F 'settings={"intensity": 75, "feather": 3}'

Exemple de réponse

json
{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "async": true
}

Suivez la progression via SSE sur GET /api/v1/jobs/{jobId}/progress. Une fois le travail terminé, le flux SSE émet un événement completed contenant l'URL de téléchargement.

Remarques

  • Il s'agit d'un outil assisté par IA qui renvoie 202 Accepted et traite de façon asynchrone. Connectez-vous au point de terminaison SSE pour recevoir les mises à jour de progression et le résultat final.
  • Nécessite l'installation du bundle de fonctionnalités background-removal. Renvoie 501 si le bundle n'est pas disponible.
  • Des valeurs d'intensité plus élevées produisent un effet de flou plus prononcé. Les valeurs supérieures à 80 créent une séparation prononcée de type bokeh.
  • Les entrées HEIC, RAW, PSD et SVG sont automatiquement décodées avant le traitement.