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

3.2 KiB

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Corrige les faux PNG transparents grâce au détourage par IA (BiRefNet) pour produire une véritable transparence alpha, avec un nettoyage des contours par défrangeage.	7eb748b80f93	human	a679aa24c8dd

Correcteur de transparence PNG

Corrige les faux PNG transparents en un clic. Utilise le détourage par IA (modèle BiRefNet HR Matting) pour produire une véritable transparence alpha, avec un post-traitement de défrangeage pour nettoyer les contours.

Point d'accès de l'API

POST /api/v1/tools/image/transparency-fixer

Traitement : asynchrone (renvoie 202, interroger /api/v1/jobs/{jobId}/progress pour le statut via SSE)

Bundle de modèle : background-removal (4-5 Go)

Paramètres

Paramètre	Type	Requis	Défaut	Description
file	file	Oui	-	Fichier image (multipart)
defringe	number	Non	`30`	Intensité du défrangeage (0-100). Supprime les pixels de frange semi-transparents autour des contours
outputFormat	string	Non	`"png"`	Format de sortie : `png` ou `webp`
removeWatermark	boolean	Non	`false`	Applique un prétraitement de suppression de filigrane (filtre médian)

Exemple de requête

curl -X POST http://localhost:1349/api/v1/tools/image/transparency-fixer \
  -F "file=@fake-transparent.png" \
  -F 'settings={"defringe":40,"outputFormat":"png"}'

Réponse

Réponse initiale (202 Accepted)

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

Progression (SSE sur `/api/v1/jobs/{jobId}/progress`)

event: progress
data: {"phase":"processing","stage":"Processing transparency...","percent":50}

Résultat final (via SSE)

{
  "phase": "complete",
  "percent": 100,
  "result": {
    "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "downloadUrl": "/api/v1/download/{jobId}/fake-transparent_fixed.png",
    "originalSize": 180000,
    "processedSize": 150000,
    "filename": "fake-transparent.png"
  }
}

Remarques

Nécessite l'installation du bundle de modèle background-removal (4-5 Go).
Utilise birefnet-hr-matting comme modèle principal pour un détourage alpha de haute qualité. Revient à birefnet-general si le modèle HR manque de mémoire.
L'option defringe supprime les pixels de frange semi-transparents que le détourage par IA laisse parfois autour des cheveux, de la fourrure et des contours fins. Elle fonctionne en floutant le canal alpha et en mettant à zéro les pixels de faible confiance.
L'option removeWatermark applique une étape de prétraitement par filtre médian. Il s'agit d'une réduction de filigrane basique, et non d'un outil dédié à la suppression de filigrane.
Ne produit que du PNG ou du WebP sans perte (tous deux prennent en charge la transparence alpha).
Prend en charge les formats d'entrée HEIC/HEIF, RAW, TGA, PSD, EXR et HDR via un décodage automatique.

3.2 KiB Raw Blame History