Search K
Référence du moteur d'IA
Le package @snapotter/ai coordonne les outils natifs et les environnements d'exécution Python pour les opérations ML locales. La plupart des outils ML utilisent un Python sidecar persistant pour des démarrages à chaud rapides. OCR est intentionnellement séparé : fast invoque le binaire natif Tesseract, tandis que balanced et best utilisent un JSONL persistant dédié dispatcher épinglé à la génération RapidOCR active et immuable sous /data/ai/v3. Chaque requête contient un generation lease. Lors d'une mise à niveau, SnapOtter exécute un smoke test sur le candidat avant l'activation, passe atomiquement au nouveau dispatcher, puis draine l'ancienne génération avant garbage collection.
NVIDIA CUDA est détecté automatiquement et utilisé par les environnements d'exécution qui le prennent en charge. OCR utilise CPU sur chaque hôte, y compris les systèmes dotés de GPU NVIDIA, évitant ainsi CUDA et le couplage de pilotes pour cet outil.
L'accélération par iGPU Intel/AMD via VA-API, Quick Sync ou OpenCL n'est pas prise en charge pour l'inférence d'IA aujourd'hui. Le mappage de /dev/dri dans un conteneur n'accélère pas ces outils du sidecar Python à moins qu'un GPU NVIDIA compatible CUDA ne soit disponible.
19 outils d'IA du sidecar Python répartis sur quatre modalités (image, audio, vidéo, document), plus 2 outils avec des capacités d'IA optionnelles. Tous les modèles s'exécutent localement : aucune connexion Internet requise après le téléchargement initial des modèles.
Compatibilité de l’OCR coréen
L’OCR rapide prend en charge auto, en, de, es, fr, zh et ja, mais pas le coréen (ko). Le coréen nécessite le pack OCR précis et balanced ou best. Le pack fonctionne dans les conteneurs Linux amd64 et arm64 officiels, y compris sur les hôtes NVIDIA où l’OCR reste exécuté sur le CPU. Un système non pris en charge reçoit une erreur de compatibilité explicite, sans repli silencieux vers fast. Le coréen avec fast ou l’alias historique tesseract est refusé avant la mise en file avec FEATURE_INCOMPATIBLE et fast-korean-unsupported.
Architecture
Node.js Tool Route
|
v
@snapotter/ai bridge.ts
| (stdin/stdout JSON + stderr progress events)
v
+-- Native Tesseract + Ghostscript (fast image/PDF OCR)
|
+-- Isolated OCR runtime (persistent JSONL dispatcher)
| `-- RapidOCR + ONNX Runtime CPU + pinned PP-OCR models
|
`-- Python dispatcher (persistent process, "ai" profile)
|
|-- remove_bg.py (rembg / BiRefNet)
|-- upscale.py (RealESRGAN)
|-- inpaint.py (LaMa ONNX)
|-- outpaint.py (LaMa canvas expansion)
|-- detect_faces.py (MediaPipe)
|-- face_landmarks.py (MediaPipe landmarks)
|-- enhance_faces.py (GFPGAN / CodeFormer)
|-- colorize.py (DDColor)
|-- noise_removal.py (SCUNet / tiered denoising)
|-- red_eye_removal.py (landmark + color analysis)
|-- restore.py (scratch repair + enhancement + denoising)
|-- transcribe.py (faster-whisper speech-to-text)
+-- install_feature.py (on-demand bundle installer)Un profil de répartiteur « docs » distinct remplace la liste d'autorisation d'IA par des scripts de traitement de documents (doc_pagecount, doc_health, doc_flatten, doc_redact, doc_text, doc_to_word, doc_metadata, doc_html_pdf) et ignore les lourdes importations de ML.
Délais d'expiration : 300 s par défaut ; l'OCR et la suppression d'arrière-plan BiRefNet disposent de 600 s.
Groupes de fonctionnalités
Les modèles d'IA sont regroupés par pile de dépendances partagée, et non par une archive par outil. Un groupe de fonctionnalités peut activer plusieurs outils lorsqu'ils utilisent la même famille de modèles, les mêmes wheels Python ou les mêmes bibliothèques natives. Cela permet de réduire la taille de l'image Docker publiée et d'éviter de stocker des copies en double des mêmes modèles de détourage d'arrière-plan, de détection de visages, d'OCR, de restauration et de reconnaissance vocale.
L'image Docker contient l'application ainsi que l'environnement d'exécution commun. Les grandes archives de modèles sont téléchargées à la demande dans le volume persistant /data/ai, puis réutilisées par chaque outil qui en a besoin. Si un groupe est déjà installé parce qu'un autre outil en avait besoin, l'activation d'un nouvel outil dépendant ne télécharge pas ce groupe à nouveau.
La plupart des outils d'IA nécessitent un ou plusieurs ensembles de fonctionnalités avant de pouvoir s'exécuter. L'interface utilisateur d'administration les installe par outil via POST /api/v1/admin/tools/:toolId/features/install, qui résout la liste complète des bundles, ignore les bundles déjà installés et met en file d'attente uniquement les téléchargements manquants. Par exemple, l'activation de Passport Photo sur une nouvelle instance met en file d'attente background-removal et face-detection ; l'activer une fois la suppression de l'arrière-plan déjà installée ne met en file d'attente que face-detection. OCR est l'exception car fast n'a pas besoin de pack ; installez son environnement d'exécution précis en option via l'interface utilisateur ou POST /api/v1/admin/features/ocr/install.
| Groupe | Taille | Groupe de dépendances partagé | Outils qui l'utilisent |
|---|---|---|---|
background-removal | 4-5 Go | détourage d'arrière-plan rembg / BiRefNet | remove-background, passport-photo, transparency-fixer, background-replace, blur-background |
face-detection | 200-300 Mo | détection de visages et points de repère MediaPipe | blur-faces, red-eye-removal, smart-crop |
object-eraser-colorize | 1-2 Go | remplissage/extension par LaMa et DDColor | erase-object, colorize, ai-canvas-expand |
upscale-enhance | 5-6 Go | RealESRGAN, GFPGAN / CodeFormer, débruitage | upscale, enhance-faces, noise-removal |
photo-restoration | 4-5 Go | pipeline de réparation des rayures et de restauration | restore-photo |
ocr | ~208-234 MiB téléchargé / ~409-488 MiB installé | Modèles RapidOCR 3.9.1, ONNX Runtime 1.20.1 et PP-OCR épinglés en option | ocr, ocr-pdf (balanced et best uniquement) |
transcription | ~600 Mo | modèles de reconnaissance vocale faster-whisper | transcribe-audio, auto-subtitles |
Outils avec des dépendances multi-groupes :
| Outil | Groupes requis | Pourquoi |
|---|---|---|
passport-photo | background-removal, face-detection | Supprime l'arrière-plan, puis utilise les points de repère du visage pour cadrer le recadrage selon les règles des photos de passeport et de pièce d'identité. |
enhance-faces | upscale-enhance, face-detection | Détecte les visages avant d'exécuter l'amélioration GFPGAN ou CodeFormer sur les régions de visage sélectionnées. |
Un outil n'est disponible que lorsque tous ses bundles requis sont installés, à l'exception de OCR : son niveau fast intégré reste disponible sans le pack OCR en option. Les installations partielles sont valides et sont gérées de manière incrémentielle : les bundles installés sont réutilisés, les bundles manquants sont affichés sous forme de téléchargements et les installations en file d'attente s'exécutent une par une afin que l'environnement Python partagé ne soit pas modifié simultanément.
Installation précise du runtime OCR
Le pack OCR précis est un moteur d'exécution spécifique à la plate-forme pour le conteneur officiel Linux amd64 ou Linux arm64. La version amd64 utilise Python 3.12 ; la version arm64 utilise Python 3.11. Les deux versions exécutent RapidOCR via CPUExecutionProvider de ONNX Runtime, de sorte que le même pack fonctionne sur les hôtes CPU uniquement et NVIDIA Docker. Le temps d'exécution précis nécessite au moins 4 GiB de mémoire effective : la limite cgroup du conteneur configuré, sinon la mémoire hôte. Un système inférieur au minimum de compatibilité signé est rejeté avant le téléchargement. Cette exigence ne s’applique pas au Fast OCR intégré. Les builds Bare-metal sont rejetées car leurs libc et Python ABI ne peuvent pas être déduits en toute sécurité ; Fast OCR reste disponible lorsque l'hôte fournit Tesseract et Ghostscript.
L'artefact facultatif correspond à environ 208 à 234 MiB compressés et 409 à 488 MiB extraits, selon l'architecture. L'index signé lie le nombre exact d'octets compressés et extraits appliqué par le programme d'installation. Tesseract intégré ajoute environ 25 MiB à l'image officielle et ne nécessite aucun fichier dans /data/ai.
L'installation en ligne récupère un index de version signé et l'artefact exact adressé au contenu pour la plate-forme actuelle. SnapOtter vérifie la signature d'index Ed25519, la taille de l'artefact, le résumé SHA-256, les résumés de modèle, les chemins, les modes de fichier et le smoke test intermédiaire avant d'activer atomiquement la nouvelle génération. Un échec d’installation laisse la génération saine précédente active.
Pour une installation isolée, téléchargez à la fois le ocr-runtime-index.json de la version et l'archive d'exécution OCR correspondante sur POST /api/v1/admin/features/import à l'aide de champs en plusieurs parties nommés index et archive. L'importation hors ligne applique les mêmes vérifications de signature, de hachage, d'extraction, de compatibilité et de test de fumée que l'installation en ligne ; une archive sans son index signé de confiance est rejetée.
Suppression d'arrière-plan
Route de l'outil : remove-background
Modèle : rembg avec BiRefNet (par défaut) ou variantes U2-Net
| Paramètre | Type | Par défaut | Description |
|---|---|---|---|
model | string | - | Variante du modèle (remplacement optionnel) |
backgroundType | string | "transparent" | L'un de : transparent, color, gradient, blur, image |
backgroundColor | string | - | Couleur hexadécimale pour un arrière-plan uni |
gradientColor1 | string | - | Première couleur du dégradé |
gradientColor2 | string | - | Deuxième couleur du dégradé |
gradientAngle | number | - | Angle du dégradé en degrés |
blurEnabled | boolean | - | Activer l'effet de flou d'arrière-plan |
blurIntensity | number (0-100) | - | Intensité du flou |
shadowEnabled | boolean | - | Activer l'ombre portée sur le sujet |
shadowOpacity | number (0-100) | - | Opacité de l'ombre |
outputFormat | string | - | Format de sortie : png, webp, ou avif |
edgeRefine | integer (0-3) | - | Niveau d'affinement des bords |
decontaminate | boolean | - | Supprimer le débordement de couleur sur les bords |
Remplacement d'arrière-plan
Route de l'outil : background-replace
Modèle : rembg / BiRefNet (partagé avec remove-background)
Supprime l'arrière-plan et le remplace par une couleur unie ou un dégradé.
| Paramètre | Type | Par défaut | Description |
|---|---|---|---|
backgroundType | "color" | "gradient" | "color" | Mode d'arrière-plan |
color | string | "#ffffff" | Couleur hexadécimale de l'arrière-plan (lorsque backgroundType vaut color) |
gradientColor1 | string | - | Première couleur hexadécimale du dégradé |
gradientColor2 | string | - | Deuxième couleur hexadécimale du dégradé |
gradientAngle | integer (0-360) | 180 | Angle du dégradé en degrés |
feather | integer (0-20) | 0 | Rayon d'adoucissement des bords |
format | "png" | "webp" | "png" | Format de sortie |
Flou d'arrière-plan
Route de l'outil : blur-background
Modèle : rembg / BiRefNet (partagé avec remove-background)
Applique un flou à l'arrière-plan tout en gardant le sujet net.
| Paramètre | Type | Par défaut | Description |
|---|---|---|---|
intensity | integer (1-100) | 50 | Intensité du flou |
feather | integer (0-20) | 0 | Rayon d'adoucissement des bords |
format | "png" | "webp" | "png" | Format de sortie |
Agrandissement d'image
Route de l'outil : upscale
Modèle : RealESRGAN (avec repli Lanczos lorsqu'il est indisponible)
| Paramètre | Type | Par défaut | Description |
|---|---|---|---|
scale | number | 2 | Facteur d'agrandissement |
model | string | "auto" | Variante du modèle |
faceEnhance | boolean | false | Appliquer une passe d'amélioration des visages GFPGAN |
denoise | number | 0 | Force du débruitage |
format | string | "auto" | Remplacement du format de sortie |
quality | number | 95 | Qualité de sortie (1-100) |
OCR / Extraction de texte
Route de l'outil : ocr
Modèles : Tesseract (fast) ; RapidOCR avec les petits modèles PP-OCRv6 (balanced) ; Modèles moyens PP-OCRv6 avec notation de variantes calibrée (best)
| Paramètre | Type | Par défaut | Description |
|---|---|---|---|
quality | "fast" | "balanced" | "best" | Dynamique | Lorsque quality et engine sont omis, SnapOtter choisit le meilleur niveau disponible dans cet ordre : best, balanced, fast. Pour le coréen, fast n’est jamais choisi : best, puis balanced sont utilisés, sinon une erreur d’installation ou de compatibilité du moteur précis est renvoyée. |
language | string | "auto" | Langue : auto, en, de, fr, es, zh, ja, ko |
enhance | booléen | Dépend du niveau | Améliorer le contraste local. Fast l'applique directement ; les niveaux précis conservent la variante uniquement lorsque la notation calibrée améliore OCR. Activé par défaut pour le meilleur |
engine | chaîne | - | Alias de compatibilité obsolète. Mappe tesseract à fast et la valeur paddleocr héritée à balanced ; il ne charge pas PaddlePaddle |
Renvoie le texte extrait ainsi que les métadonnées de provenance : moteur, qualité demandée et réelle, appareil, fournisseur, état de dégradation, avertissements et versions d'exécution/modèle précises, le cas échéant. Les demandes de qualité explicites ne retombent jamais sur un autre niveau. Si balanced ou best n'est pas disponible, API renvoie FEATURE_NOT_INSTALLED ou FEATURE_INCOMPATIBLE au lieu d'exécuter silencieusement fast.
OCR de PDF
Route de l'outil : ocr-pdf
Modèles : Même système de niveaux que l'OCR d'image
Extrait le texte de documents PDF numérisés à l'aide d'un OCR alimenté par IA, page par page.
| Paramètre | Type | Par défaut | Description |
|---|---|---|---|
quality | "fast" | "balanced" | "best" | Dynamique | Lorsque quality et engine sont omis, SnapOtter choisit le meilleur niveau disponible dans cet ordre : best, balanced, fast. Pour le coréen, fast n’est jamais choisi : best, puis balanced sont utilisés, sinon une erreur d’installation ou de compatibilité du moteur précis est renvoyée. |
language | string | "auto" | Langue : auto, en, de, fr, es, zh, ja, ko |
pages | string | "all" | Sélection de pages : "all", "1-3", "1,3,5" |
enhance | booléen | Dépend du niveau | Améliorer le contraste local. Fast l'applique directement ; les niveaux précis conservent la variante uniquement lorsque la notation calibrée améliore OCR. Activé par défaut pour le meilleur |
engine | chaîne | - | Alias de compatibilité obsolète. Mappe tesseract à fast et la valeur paddleocr héritée à balanced ; il ne charge pas PaddlePaddle |
La même règle de non-rétrogradation s'applique à PDF OCR. Les pages PDF sont rastérisées avant la reconnaissance, et une requête peut sélectionner au maximum 50 pages.
Floutage de visages / PII
Route de l'outil : blur-faces
Modèle : détection de visages MediaPipe
| Paramètre | Type | Par défaut | Description |
|---|---|---|---|
blurRadius | number (1-100) | 30 | Rayon du flou gaussien |
sensitivity | number (0-1) | 0.5 | Seuil de confiance de détection |
Amélioration des visages
Route de l'outil : enhance-faces
Modèles : GFPGAN, CodeFormer
| Paramètre | Type | Par défaut | Description |
|---|---|---|---|
model | "auto" | "gfpgan" | "codeformer" | "auto" | Modèle d'amélioration |
strength | number (0-1) | 0.8 | Force de l'amélioration |
sensitivity | number (0-1) | 0.5 | Seuil de détection de visages |
onlyCenterFace | boolean | false | Améliorer uniquement le visage le plus central |
Colorisation par IA
Route de l'outil : colorize
Modèle : DDColor (avec repli OpenCV DNN)
Convertit les photos en noir et blanc ou en niveaux de gris en couleur.
| Paramètre | Type | Par défaut | Description |
|---|---|---|---|
intensity | number (0-1) | 1.0 | Force de la saturation des couleurs |
model | "auto" | "ddcolor" | "opencv" | "auto" | Variante du modèle |
Suppression du bruit
Route de l'outil : noise-removal
Modèle : SCUNet (pipeline de débruitage à plusieurs niveaux)
| Paramètre | Type | Par défaut | Description |
|---|---|---|---|
tier | "quick" | "balanced" | "quality" | "maximum" | "balanced" | Niveau de traitement |
strength | number (0-100) | 50 | Force du débruitage |
detailPreservation | number (0-100) | 50 | Quantité de détails à préserver ; une valeur plus élevée conserve plus de texture |
colorNoise | number (0-100) | 30 | Force de réduction du bruit de couleur |
format | string | "original" | Format de sortie : original, png, jpeg, webp, avif, jxl |
quality | number (1-100) | 90 | Qualité d'encodage de sortie |
Suppression des yeux rouges
Route de l'outil : red-eye-removal
Détecte les points de repère du visage, localise les régions des yeux et corrige la sursaturation du canal rouge.
| Paramètre | Type | Par défaut | Description |
|---|---|---|---|
sensitivity | number (0-100) | 50 | Seuil de détection des pixels rouges |
strength | number (0-100) | 70 | Force de la correction |
format | string | - | Remplacement du format de sortie (optionnel) |
quality | number (1-100) | 90 | Qualité de sortie |
Restauration de photos
Route de l'outil : restore-photo
Pipeline en plusieurs étapes pour les photos anciennes ou endommagées : détection et réparation des rayures/déchirures, amélioration des visages, débruitage et colorisation optionnelle.
| Paramètre | Type | Par défaut | Description |
|---|---|---|---|
scratchRemoval | boolean | true | Détecter et réparer les rayures, les déchirures |
faceEnhancement | boolean | true | Appliquer une passe d'amélioration des visages |
fidelity | number (0-1) | 0.7 | Force de l'amélioration des visages (plus élevé = plus conservateur) |
denoise | boolean | true | Appliquer une passe de débruitage |
denoiseStrength | number (0-100) | 25 | Force du débruitage |
colorize | boolean | false | Coloriser après la restauration |
colorizeStrength | number (0-100) | 85 | Intensité de la colorisation |
Photo d'identité
Route de l'outil : passport-photo
Modèles : points de repère du visage MediaPipe + suppression d'arrière-plan BiRefNet
Flux de travail en deux phases : analyser (détecter le visage + supprimer l'arrière-plan) puis générer (recadrer, redimensionner, disposer en mosaïque). Prend en charge plus de 37 pays répartis sur 6 régions.
Phase 1 : Analyser
POST /api/v1/tools/image/passport-photo/analyze
Accepte un fichier image (multipart). Renvoie les données des points de repère du visage, un aperçu en base64 et les dimensions de l'image.
Phase 2 : Générer
POST /api/v1/tools/image/passport-photo/generate
Accepte un corps JSON contenant les résultats de la Phase 1 ainsi que les paramètres de génération :
| Paramètre | Type | Par défaut | Description |
|---|---|---|---|
jobId | string | (requis) | ID de tâche de la Phase 1 |
filename | string | (requis) | Nom de fichier d'origine de la Phase 1 |
countryCode | string | (requis) | Code de pays ISO (par ex., US, GB, IN) |
documentType | string | "passport" | Type de document |
bgColor | string | "#FFFFFF" | Couleur d'arrière-plan hexadécimale |
printLayout | string | "none" | Disposition d'impression : none, 4x6, a4, letter |
maxFileSizeKb | number | 0 | Taille de fichier maximale en Ko (0 = aucune limite) |
dpi | number (72-1200) | 300 | DPI de sortie |
customWidthMm | number | - | Largeur personnalisée en mm (remplace la spécification du pays) |
customHeightMm | number | - | Hauteur personnalisée en mm (remplace la spécification du pays) |
zoom | number (0.5-3) | 1 | Facteur de zoom |
adjustX | number | 0 | Ajustement de la position horizontale |
adjustY | number | 0 | Ajustement de la position verticale |
landmarks | object | (requis) | Points de repère de la Phase 1 |
imageWidth | number | (requis) | Largeur de l'image de la Phase 1 |
imageHeight | number | (requis) | Hauteur de l'image de la Phase 1 |
Effacement d'objets (remplissage)
Route de l'outil : erase-object
Modèle : LaMa via ONNX Runtime
Le masque est envoyé en tant que deuxième partie de fichier (nom de champ mask), et non en base64. Les pixels blancs du masque indiquent les zones à effacer. Les paramètres format et quality sont envoyés en tant que champs de formulaire de premier niveau.
| Paramètre | Type | Par défaut | Description |
|---|---|---|---|
file | file | (requis) | Image source (multipart) |
mask | file | (requis) | Image de masque (multipart, nom de champ mask, blanc = effacer) |
format | string | "auto" | Format de sortie : auto, png, jpg, jpeg, webp, tiff, gif, avif, heic, heif, jxl |
quality | integer (1-100) | 95 | Qualité de sortie |
Accéléré par CUDA lorsqu'un GPU NVIDIA est disponible.
Extension de canevas par IA
Route de l'outil : ai-canvas-expand
Modèle : extension basée sur LaMa
Étend le canevas d'une image dans n'importe quelle direction et remplit les nouvelles zones avec un contenu généré par IA qui correspond à l'image existante.
| Paramètre | Type | Par défaut | Description |
|---|---|---|---|
extendTop | integer | 0 | Pixels à étendre en haut |
extendRight | integer | 0 | Pixels à étendre à droite |
extendBottom | integer | 0 | Pixels à étendre en bas |
extendLeft | integer | 0 | Pixels à étendre à gauche |
tier | "fast" | "balanced" | "high" | "balanced" | Niveau de qualité |
format | string | "auto" | Format de sortie : auto, png, jpg, jpeg, webp, tiff, gif, avif, heic, heif, jxl |
quality | integer (1-100) | 95 | Qualité de sortie |
Au moins une direction d'extension doit être supérieure à 0.
Recadrage intelligent
Route de l'outil : smart-crop
Modèle : détection de visages MediaPipe (mode visage uniquement)
| Paramètre | Type | Par défaut | Description |
|---|---|---|---|
mode | string | "subject" | Stratégie de recadrage : subject, face, trim |
strategy | "attention" | "entropy" | "attention" | Stratégie pour le mode sujet |
width | integer | - | Largeur de sortie |
height | integer | - | Hauteur de sortie |
padding | integer (0-50) | 0 | Pourcentage de marge autour du sujet |
facePreset | string | "head-shoulders" | Cadrage prédéfini lorsque mode=face |
sensitivity | number (0-1) | 0.5 | Seuil de détection de visages |
threshold | integer (0-255) | 30 | Seuil de détection de l'arrière-plan (mode rognage) |
padToSquare | boolean | false | Compléter le résultat rogné pour obtenir un carré |
padColor | string | "#ffffff" | Couleur d'arrière-plan pour le remplissage carré |
targetSize | integer | - | Taille cible pour la sortie complétée (pixels) |
quality | integer (1-100) | - | Qualité de sortie |
Les anciennes valeurs de mode attention et content sont acceptées et mises en correspondance avec subject et trim respectivement.
Préréglages de visage :
| Préréglage | Idéal pour |
|---|---|
closeup | Portraits |
head-shoulders | Photos de profil |
upper-body | LinkedIn / formel |
half-body | Buste complet |
Transcrire un fichier audio
Route de l'outil : transcribe-audio
Modèle : faster-whisper
Convertit la parole en texte. Prend en charge les formats de sortie texte brut, SRT et VTT.
| Paramètre | Type | Par défaut | Description |
|---|---|---|---|
language | string | "auto" | Langue : auto, en, de, fr, es, zh, ja, ko, id, th, vi |
outputFormat | "txt" | "srt" | "vtt" | "txt" | Format de sortie |
Sous-titres automatiques
Route de l'outil : auto-subtitles
Modèle : faster-whisper (extrait l'audio de la vidéo, puis le transcrit)
Génère des fichiers de sous-titres à partir de la piste audio d'une vidéo.
| Paramètre | Type | Par défaut | Description |
|---|---|---|---|
language | string | "auto" | Langue : auto, en, de, fr, es, zh, ja, ko, id, th, vi |
format | "srt" | "vtt" | "srt" | Format de sous-titre de sortie |
Correcteur de transparence PNG
Route de l'outil : transparency-fixer
Modèle : détourage HR BiRefNet (résolution 2048x2048)
Corrige les PNG « faussement transparents » où l'arrière-plan a été supprimé mais a laissé un liseré, des halos ou des artefacts semi-transparents. Utilise le modèle de détourage haute résolution de BiRefNet pour produire un canal alpha propre, puis applique un traitement de suppression de liseré configurable pour éliminer la contamination des couleurs le long des bords.
Chaîne de repli en cas de OOM : Si le détourage HR de BiRefNet dépasse la mémoire disponible, l'outil se rabat automatiquement sur birefnet-general, puis sur u2net.
| Paramètre | Type | Par défaut | Description |
|---|---|---|---|
defringe | number (0-100) | 30 | Force de suppression du liseré sur les bords pour éliminer la contamination des couleurs |
outputFormat | "png" | "webp" | "png" | Format de l'image de sortie |
removeWatermark | boolean | false | Appliquer un prétraitement de suppression du filigrane (filtre médian) |
bash
curl -X POST http://localhost:1349/api/v1/tools/image/transparency-fixer \
-H "Authorization: Bearer <token>" \
-F "file=@fake-transparent.png" \
-F 'settings={"defringe":30,"outputFormat":"png"}'Outils avec des capacités d'IA optionnelles
Les outils suivants ne sont pas des outils du sidecar Python mais utilisent des fonctionnalités d'IA lorsque certaines options sont activées.
Amélioration d'image
Route de l'outil : image-enhancement
Moteur : basé sur l'analyse (histogramme et statistiques Sharp)
Analyse l'image et applique des corrections automatiques pour l'exposition, le contraste, la balance des blancs, la saturation, la netteté et le bruit. Prend en charge des modes spécifiques à la scène.
| Paramètre | Type | Par défaut | Description |
|---|---|---|---|
mode | "auto" | "portrait" | "landscape" | "low-light" | "food" | "document" | "auto" | Mode de scène pour ajuster les corrections |
intensity | number (0-100) | 50 | Force globale de la correction |
corrections.exposure | boolean | true | Appliquer la correction de l'exposition |
corrections.contrast | boolean | true | Appliquer la correction du contraste |
corrections.whiteBalance | boolean | true | Appliquer la correction de la balance des blancs |
corrections.saturation | boolean | true | Appliquer la correction de la saturation |
corrections.sharpness | boolean | true | Appliquer la correction de la netteté |
corrections.denoise | boolean | true | Appliquer le débruitage |
deepEnhance | boolean | false | Activer la suppression du bruit par IA via SCUNet (nécessite le groupe upscale-enhance) |
Un point de terminaison d'analyse supplémentaire est disponible à POST /api/v1/tools/image/image-enhancement/analyze qui renvoie les corrections détectées sans les appliquer.
Redimensionnement contextuel (découpe de coutures)
Route de l'outil : content-aware-resize
Moteur : binaire Go caire (pas Python : aucun bénéfice GPU)
Redimensionne intelligemment les images en supprimant les coutures à faible énergie, en préservant le contenu important.
| Paramètre | Type | Par défaut | Description |
|---|---|---|---|
width | number | - | Largeur cible |
height | number | - | Hauteur cible |
protectFaces | boolean | false | Protéger les régions de visage détectées (nécessite le groupe face-detection) |
blurRadius | number (0-20) | 4 | Pré-flou pour le calcul de l'énergie |
sobelThreshold | number (1-20) | 2 | Seuil de sensibilité des bords |
square | boolean | false | Forcer une sortie carrée |