mirror of https://github.com/snapotter-hq/SnapOtter.git synced 2026-08-03 07:46:42 +02:00

Files

T

SnapOtterandGitHub 4963ab3bbd feat(docs-i18n): translate all documentation into 20 languages

All 181 docs markdown files translated into 20 languages (apps/docs/<locale>/**). Companion to the i18n code PR; admin-merged because the file count exceeds GitHub's per-PR CI trigger limit. Validated by pnpm i18n:check (all surfaces, 0 stale/missing) and a clean all-locale docs build.

2026-07-11 13:52:47 +08:00

2.5 KiB

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Remplace l'arrière-plan d'une image par une couleur unie ou un dégradé grâce à l'IA.	930fe8890e55	human	bebdb66a0221

Remplacer l'arrière-plan

Remplace l'arrière-plan d'une image par une couleur unie ou un dégradé. Le modèle d'IA détecte le sujet, supprime l'arrière-plan d'origine et compose le sujet sur l'arrière-plan de votre choix.

Point de terminaison de l'API

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

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

Paramètres

Paramètre	Type	Requis	Par défaut	Description
backgroundType	chaîne	Non	`"color"`	Mode d'arrière-plan : `color` ou `gradient`
color	chaîne	Non	`"#ffffff"`	Couleur hex de l'arrière-plan (lorsque backgroundType vaut `color`)
gradientColor1	chaîne	Non	-	Première couleur hex du dégradé
gradientColor2	chaîne	Non	-	Deuxième couleur hex du dégradé
gradientAngle	entier	Non	`180`	Angle du dégradé en degrés (0 à 360)
feather	entier	Non	`0`	Rayon d'adoucissement des bords (0 à 20)
format	chaîne	Non	`"png"`	Format de sortie : `png` ou `webp`

Exemple de requête

curl -X POST http://localhost:1349/api/v1/tools/image/background-replace \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@photo.jpg" \
  -F 'settings={"backgroundType": "color", "color": "#2563eb", "feather": 2}'

Exemple de réponse

{
  "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.
Les entrées HEIC, RAW, PSD et SVG sont automatiquement décodées avant le traitement.
La sortie est par défaut au format PNG afin de préserver la transparence autour du sujet.

2.5 KiB Raw Blame History