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-08-03 07:46:42 +02:00 · 2026-07-11 13:52:47 +08:00
parent 00b651c9f8
commit 4963ab3bbd
3620 changed files with 306134 additions and 0 deletions
@@ -0,0 +1,438 @@
+---
+description: "AI-engine-referentie met alle lokale ML-tools. Achtergrondverwijdering, upscaling, OCR, gezichtsdetectie, fotorestauratie en meer."
+i18n_source_hash: 14728c1dcd05
+i18n_provenance: machine
+i18n_output_hash: 3188860db651
+---
+
+# AI-engine-referentie {#ai-engine-reference}
+
+Het `@snapotter/ai`-pakket verbindt Node.js met een **persistente Python-sidecar** voor alle ML-bewerkingen. Het dispatcher-proces blijft actief tussen aanvragen door voor snelle warm-start-prestaties. NVIDIA CUDA wordt bij het opstarten automatisch gedetecteerd en gebruikt wanneer beschikbaar; anders draaien de AI-tools op de CPU.
+
+Intel/AMD iGPU-versnelling via VA-API, Quick Sync of OpenCL wordt vandaag niet ondersteund voor AI-inferentie. Het toewijzen van `/dev/dri` aan een container versnelt deze Python-sidecar-tools niet, tenzij er een CUDA-compatibele NVIDIA-GPU beschikbaar is.
+
+19 Python-sidecar-AI-tools verdeeld over vier modaliteiten (afbeelding, audio, video, document), plus 2 tools met optionele AI-mogelijkheden. Alle modellen draaien lokaal: na de eerste modeldownload is er geen internet vereist.
+
+## Architectuur {#architecture}
+
+```
+Node.js Tool Route
+      |
+      v
+ @snapotter/ai bridge.ts
+      | (stdin/stdout JSON + stderr progress events)
+      v
+ Python dispatcher (persistent process, "ai" profile)
+      |
+      |-- remove_bg.py        (rembg / BiRefNet)
+      |-- upscale.py          (RealESRGAN)
+      |-- inpaint.py          (LaMa ONNX)
+      |-- outpaint.py         (LaMa canvas expansion)
+      |-- ocr.py              (PaddleOCR / Tesseract)
+      |-- ocr_pdf.py          (page-by-page document OCR)
+      |-- ocr_preprocess.py   (image enhancement for OCR)
+      |-- 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)
+```
+
+Een apart "docs"-dispatcher-profiel vervangt de AI-allowlist door scripts voor documentverwerking (`doc_pagecount`, `doc_health`, `doc_flatten`, `doc_redact`, `doc_text`, `doc_to_word`, `doc_metadata`, `doc_html_pdf`) en slaat zware ML-imports over.
+
+**Time-outs:** 300 s standaard; OCR en BiRefNet-achtergrondverwijdering krijgen 600 s.
+
+## Feature-bundels {#feature-bundles}
+
+AI-modellen worden per gedeelde dependency-stack gebundeld, niet één archief per tool. Een feature-bundel kan meerdere tools inschakelen wanneer ze dezelfde modelfamilie, Python-wheels of native libraries gebruiken. Dit houdt de release-Docker-image kleiner en voorkomt het opslaan van dubbele kopieën van dezelfde achtergrondmatting-, gezichtsdetectie-, OCR-, restauratie- en spraakmodellen.
+
+De Docker-image levert de applicatie plus de gedeelde runtime. Grote modelarchieven worden op aanvraag gedownload naar het persistente `/data/ai`-volume en vervolgens hergebruikt door elke tool die ze nodig heeft. Als een bundel al geïnstalleerd is omdat een andere tool deze nodig had, downloadt het inschakelen van een nieuwe afhankelijke tool die bundel niet opnieuw.
+
+Elke AI-tool vereist een of meer feature-bundels voordat deze kan draaien. De beheerder-UI installeert per tool via `POST /api/v1/admin/tools/:toolId/features/install`, die de volledige bundellijst oplost, bundels overslaat die al geïnstalleerd zijn en alleen de ontbrekende downloads in de wachtrij zet. Zo zet het inschakelen van Pasfoto op een nieuwe instantie `background-removal` en `face-detection` in de wachtrij; wanneer je het inschakelt nadat Achtergrondverwijdering al geïnstalleerd is, wordt alleen `face-detection` in de wachtrij gezet.
+
+| Bundel | Grootte | Gedeelde dependency-groep | Tools die het gebruiken |
+|--------|------|-------------------------|-------------------|
+| `background-removal` | 4-5 GB | rembg / BiRefNet-achtergrondmatting | remove-background, passport-photo, transparency-fixer, background-replace, blur-background |
+| `face-detection` | 200-300 MB | MediaPipe-gezichtsdetectie en -landmarks | blur-faces, red-eye-removal, smart-crop |
+| `object-eraser-colorize` | 1-2 GB | LaMa inpainting/outpainting en DDColor | erase-object, colorize, ai-canvas-expand |
+| `upscale-enhance` | 5-6 GB | RealESRGAN, GFPGAN / CodeFormer, denoising | upscale, enhance-faces, noise-removal |
+| `photo-restoration` | 4-5 GB | krasreparatie- en restauratiepijplijn | restore-photo |
+| `ocr` | 5-6 GB | PaddleOCR / Tesseract OCR-stack | ocr, ocr-pdf |
+| `transcription` | ~600 MB | faster-whisper spraak-naar-tekst-modellen | transcribe-audio, auto-subtitles |
+
+Tools met bundeloverschrijdende afhankelijkheden:
+
+| Tool | Vereiste bundels | Waarom |
+|------|------------------|-----|
+| `passport-photo` | `background-removal`, `face-detection` | Verwijdert de achtergrond en gebruikt vervolgens gezichtslandmarks om de uitsnede te kaderen volgens de regels voor pasfoto's en ID-foto's. |
+| `enhance-faces` | `upscale-enhance`, `face-detection` | Detecteert gezichten voordat GFPGAN- of CodeFormer-verbetering op de geselecteerde gezichtsregio's wordt uitgevoerd. |
+
+Een tool is alleen beschikbaar wanneer al zijn vereiste bundels geïnstalleerd zijn. Gedeeltelijke installaties zijn geldig en worden incrementeel afgehandeld: geïnstalleerde bundels worden hergebruikt, ontbrekende bundels worden als downloads getoond, en in de wachtrij gezette installaties draaien één voor één, zodat de gedeelde Python-omgeving niet gelijktijdig wordt gewijzigd.
+
+---
+
+## Achtergrondverwijdering {#background-removal}
+
+**Toolroute:** `remove-background`  
+**Model:** rembg met BiRefNet (standaard) of U2-Net-varianten
+
+| Parameter | Type | Standaard | Beschrijving |
+|-----------|------|---------|-------------|
+| `model` | string | - | Modelvariant (optionele override) |
+| `backgroundType` | string | `"transparent"` | Een van: `transparent`, `color`, `gradient`, `blur`, `image` |
+| `backgroundColor` | string | - | Hex-kleur voor effen achtergrond |
+| `gradientColor1` | string | - | Eerste verloopkleur |
+| `gradientColor2` | string | - | Tweede verloopkleur |
+| `gradientAngle` | number | - | Verloophoek in graden |
+| `blurEnabled` | boolean | - | Achtergrondvervaging inschakelen |
+| `blurIntensity` | number (0-100) | - | Vervagingsintensiteit |
+| `shadowEnabled` | boolean | - | Slagschaduw op onderwerp inschakelen |
+| `shadowOpacity` | number (0-100) | - | Schaduwdekking |
+| `outputFormat` | string | - | Uitvoerformaat: `png`, `webp`, of `avif` |
+| `edgeRefine` | integer (0-3) | - | Niveau van randverfijning |
+| `decontaminate` | boolean | - | Kleurdoorloop van randen verwijderen |
+
+## Achtergrond vervangen {#background-replace}
+
+**Toolroute:** `background-replace`  
+**Model:** rembg / BiRefNet (gedeeld met remove-background)
+
+Verwijdert de achtergrond en vervangt deze door een effen kleur of verloop.
+
+| Parameter | Type | Standaard | Beschrijving |
+|-----------|------|---------|-------------|
+| `backgroundType` | `"color"` \| `"gradient"` | `"color"` | Achtergrondmodus |
+| `color` | string | `"#ffffff"` | Hex-achtergrondkleur (wanneer `backgroundType` `color` is) |
+| `gradientColor1` | string | - | Eerste hex-verloopkleur |
+| `gradientColor2` | string | - | Tweede hex-verloopkleur |
+| `gradientAngle` | integer (0-360) | `180` | Verloophoek in graden |
+| `feather` | integer (0-20) | `0` | Straal van randvervaging |
+| `format` | `"png"` \| `"webp"` | `"png"` | Uitvoerformaat |
+
+## Achtergrond vervagen {#blur-background}
+
+**Toolroute:** `blur-background`  
+**Model:** rembg / BiRefNet (gedeeld met remove-background)
+
+Vervaagt de achtergrond terwijl het onderwerp scherp blijft.
+
+| Parameter | Type | Standaard | Beschrijving |
+|-----------|------|---------|-------------|
+| `intensity` | integer (1-100) | `50` | Vervagingsintensiteit |
+| `feather` | integer (0-20) | `0` | Straal van randvervaging |
+| `format` | `"png"` \| `"webp"` | `"png"` | Uitvoerformaat |
+
+## Afbeelding upscalen {#image-upscaling}
+
+**Toolroute:** `upscale`  
+**Model:** RealESRGAN (met Lanczos-fallback wanneer niet beschikbaar)
+
+| Parameter | Type | Standaard | Beschrijving |
+|-----------|------|---------|-------------|
+| `scale` | number | `2` | Upscale-factor |
+| `model` | string | `"auto"` | Modelvariant |
+| `faceEnhance` | boolean | `false` | GFPGAN-gezichtsverbeteringspas toepassen |
+| `denoise` | number | `0` | Denoising-sterkte |
+| `format` | string | `"auto"` | Override van uitvoerformaat |
+| `quality` | number | `95` | Uitvoerkwaliteit (1-100) |
+
+## OCR / Tekstextractie {#ocr-text-extraction}
+
+**Toolroute:** `ocr`  
+**Modellen:** Tesseract (snel), PaddleOCR PP-OCRv5 (gebalanceerd), PaddleOCR-VL 1.5 (beste)
+
+| Parameter | Type | Standaard | Beschrijving |
+|-----------|------|---------|-------------|
+| `quality` | `"fast"` \| `"balanced"` \| `"best"` | `"balanced"` | Verwerkingsniveau |
+| `language` | string | `"auto"` | Taal: `auto`, `en`, `de`, `fr`, `es`, `zh`, `ja`, `ko` |
+| `enhance` | boolean | `true` | Afbeelding voorbewerken om OCR-nauwkeurigheid te verbeteren |
+| `engine` | string | - | Verouderd. Wijst `tesseract` toe aan `fast`, `paddleocr` aan `balanced` |
+
+Retourneert gestructureerde resultaten met bounding boxes, betrouwbaarheidsscores en geëxtraheerde tekstblokken.
+
+## PDF-OCR {#pdf-ocr}
+
+**Toolroute:** `ocr-pdf`  
+**Modellen:** Hetzelfde niveausysteem als afbeeldings-OCR
+
+Extraheert tekst uit gescande PDF-documenten met AI-gestuurde OCR, pagina voor pagina.
+
+| Parameter | Type | Standaard | Beschrijving |
+|-----------|------|---------|-------------|
+| `quality` | `"fast"` \| `"balanced"` \| `"best"` | `"balanced"` | Verwerkingsniveau |
+| `language` | string | `"auto"` | Taal: `auto`, `en`, `de`, `fr`, `es`, `zh`, `ja`, `ko` |
+| `pages` | string | `"all"` | Paginaselectie: `"all"`, `"1-3"`, `"1,3,5"` |
+
+## Gezicht / PII vervagen {#face-pii-blur}
+
+**Toolroute:** `blur-faces`  
+**Model:** MediaPipe-gezichtsdetectie
+
+| Parameter | Type | Standaard | Beschrijving |
+|-----------|------|---------|-------------|
+| `blurRadius` | number (1-100) | `30` | Straal van gaussische vervaging |
+| `sensitivity` | number (0-1) | `0.5` | Drempel voor detectiebetrouwbaarheid |
+
+## Gezichtsverbetering {#face-enhancement}
+
+**Toolroute:** `enhance-faces`  
+**Modellen:** GFPGAN, CodeFormer
+
+| Parameter | Type | Standaard | Beschrijving |
+|-----------|------|---------|-------------|
+| `model` | `"auto"` \| `"gfpgan"` \| `"codeformer"` | `"auto"` | Verbeteringsmodel |
+| `strength` | number (0-1) | `0.8` | Verbeteringssterkte |
+| `sensitivity` | number (0-1) | `0.5` | Gezichtsdetectiedrempel |
+| `onlyCenterFace` | boolean | `false` | Alleen het meest centrale gezicht verbeteren |
+
+## AI-inkleuring {#ai-colorization}
+
+**Toolroute:** `colorize`  
+**Model:** DDColor (met OpenCV DNN-fallback)
+
+Zet zwart-wit- of grijswaardenfoto's om naar volledige kleur.
+
+| Parameter | Type | Standaard | Beschrijving |
+|-----------|------|---------|-------------|
+| `intensity` | number (0-1) | `1.0` | Sterkte van kleurverzadiging |
+| `model` | `"auto"` \| `"ddcolor"` \| `"opencv"` | `"auto"` | Modelvariant |
+
+## Ruisverwijdering {#noise-removal}
+
+**Toolroute:** `noise-removal`  
+**Model:** SCUNet (getrapte denoising-pijplijn)
+
+| Parameter | Type | Standaard | Beschrijving |
+|-----------|------|---------|-------------|
+| `tier` | `"quick"` \| `"balanced"` \| `"quality"` \| `"maximum"` | `"balanced"` | Verwerkingsniveau |
+| `strength` | number (0-100) | `50` | Denoising-sterkte |
+| `detailPreservation` | number (0-100) | `50` | Hoeveel detail behouden blijft; hoger behoudt meer textuur |
+| `colorNoise` | number (0-100) | `30` | Sterkte van kleurruisreductie |
+| `format` | string | `"original"` | Uitvoerformaat: `original`, `png`, `jpeg`, `webp`, `avif`, `jxl` |
+| `quality` | number (1-100) | `90` | Kwaliteit van uitvoercodering |
+
+## Rode-ogenverwijdering {#red-eye-removal}
+
+**Toolroute:** `red-eye-removal`
+
+Detecteert gezichtslandmarks, lokaliseert oogregio's en corrigeert oververzadiging van het rode kanaal.
+
+| Parameter | Type | Standaard | Beschrijving |
+|-----------|------|---------|-------------|
+| `sensitivity` | number (0-100) | `50` | Detectiedrempel voor rode pixels |
+| `strength` | number (0-100) | `70` | Correctiesterkte |
+| `format` | string | - | Override van uitvoerformaat (optioneel) |
+| `quality` | number (1-100) | `90` | Uitvoerkwaliteit |
+
+## Fotorestauratie {#photo-restoration}
+
+**Toolroute:** `restore-photo`
+
+Meerstaps-pijplijn voor oude of beschadigde foto's: detectie en reparatie van krassen/scheuren, gezichtsverbetering, denoising en optionele inkleuring.
+
+| Parameter | Type | Standaard | Beschrijving |
+|-----------|------|---------|-------------|
+| `scratchRemoval` | boolean | `true` | Krassen en scheuren detecteren en repareren |
+| `faceEnhancement` | boolean | `true` | Gezichtsverbeteringspas toepassen |
+| `fidelity` | number (0-1) | `0.7` | Sterkte van gezichtsverbetering (hoger = behoudender) |
+| `denoise` | boolean | `true` | Denoising-pas toepassen |
+| `denoiseStrength` | number (0-100) | `25` | Denoising-sterkte |
+| `colorize` | boolean | `false` | Inkleuren na restauratie |
+| `colorizeStrength` | number (0-100) | `85` | Inkleurintensiteit |
+
+## Pasfoto {#passport-photo}
+
+**Toolroute:** `passport-photo`  
+**Modellen:** MediaPipe-gezichtslandmarks + BiRefNet-achtergrondverwijdering
+
+Workflow in twee fasen: analyseren (gezicht detecteren + achtergrond verwijderen) en vervolgens genereren (uitsnijden, formaat wijzigen, tegelen). Ondersteunt meer dan 37 landen in 6 regio's.
+
+### Fase 1: Analyseren {#phase-1-analyze}
+
+`POST /api/v1/tools/image/passport-photo/analyze`
+
+Accepteert een afbeeldingsbestand (multipart). Retourneert gezichtslandmark-gegevens, een base64-voorbeeld en afbeeldingsafmetingen.
+
+### Fase 2: Genereren {#phase-2-generate}
+
+`POST /api/v1/tools/image/passport-photo/generate`
+
+Accepteert een JSON-body met de resultaten van fase 1 plus generatie-instellingen:
+
+| Parameter | Type | Standaard | Beschrijving |
+|-----------|------|---------|-------------|
+| `jobId` | string | (vereist) | Job-ID uit fase 1 |
+| `filename` | string | (vereist) | Oorspronkelijke bestandsnaam uit fase 1 |
+| `countryCode` | string | (vereist) | ISO-landcode (bijv. `US`, `GB`, `IN`) |
+| `documentType` | string | `"passport"` | Documenttype |
+| `bgColor` | string | `"#FFFFFF"` | Hex-achtergrondkleur |
+| `printLayout` | string | `"none"` | Afdruklay-out: `none`, `4x6`, `a4`, `letter` |
+| `maxFileSizeKb` | number | `0` | Max. bestandsgrootte in KB (0 = geen limiet) |
+| `dpi` | number (72-1200) | `300` | Uitvoer-DPI |
+| `customWidthMm` | number | - | Aangepaste breedte in mm (overschrijft landspecificatie) |
+| `customHeightMm` | number | - | Aangepaste hoogte in mm (overschrijft landspecificatie) |
+| `zoom` | number (0.5-3) | `1` | Zoomfactor |
+| `adjustX` | number | `0` | Horizontale positieaanpassing |
+| `adjustY` | number | `0` | Verticale positieaanpassing |
+| `landmarks` | object | (vereist) | Landmarks uit fase 1 |
+| `imageWidth` | number | (vereist) | Afbeeldingsbreedte uit fase 1 |
+| `imageHeight` | number | (vereist) | Afbeeldingshoogte uit fase 1 |
+
+## Objecten wissen (Inpainting) {#object-erasing-inpainting}
+
+**Toolroute:** `erase-object`  
+**Model:** LaMa via ONNX Runtime
+
+Het masker wordt verzonden als een **tweede bestandsdeel** (fieldname `mask`), niet als base64. Witte pixels in het masker geven gebieden aan die gewist moeten worden. De instellingen `format` en `quality` worden verzonden als velden op het hoogste niveau van het formulier.
+
+| Parameter | Type | Standaard | Beschrijving |
+|-----------|------|---------|-------------|
+| `file` | file | (vereist) | Bronafbeelding (multipart) |
+| `mask` | file | (vereist) | Maskerafbeelding (multipart, fieldname `mask`, wit = wissen) |
+| `format` | string | `"auto"` | Uitvoerformaat: `auto`, `png`, `jpg`, `jpeg`, `webp`, `tiff`, `gif`, `avif`, `heic`, `heif`, `jxl` |
+| `quality` | integer (1-100) | `95` | Uitvoerkwaliteit |
+
+CUDA-versneld wanneer een NVIDIA-GPU beschikbaar is.
+
+## AI-canvas uitbreiden {#ai-canvas-expand}
+
+**Toolroute:** `ai-canvas-expand`  
+**Model:** LaMa-gebaseerde outpainting
+
+Breidt het canvas van een afbeelding in elke richting uit en vult nieuwe gebieden met door AI gegenereerde inhoud die aansluit op de bestaande afbeelding.
+
+| Parameter | Type | Standaard | Beschrijving |
+|-----------|------|---------|-------------|
+| `extendTop` | integer | `0` | Aantal pixels om bovenaan uit te breiden |
+| `extendRight` | integer | `0` | Aantal pixels om rechts uit te breiden |
+| `extendBottom` | integer | `0` | Aantal pixels om onderaan uit te breiden |
+| `extendLeft` | integer | `0` | Aantal pixels om links uit te breiden |
+| `tier` | `"fast"` \| `"balanced"` \| `"high"` | `"balanced"` | Kwaliteitsniveau |
+| `format` | string | `"auto"` | Uitvoerformaat: `auto`, `png`, `jpg`, `jpeg`, `webp`, `tiff`, `gif`, `avif`, `heic`, `heif`, `jxl` |
+| `quality` | integer (1-100) | `95` | Uitvoerkwaliteit |
+
+Ten minste één uitbreidingsrichting moet groter zijn dan 0.
+
+## Slim uitsnijden {#smart-crop}
+
+**Toolroute:** `smart-crop`  
+**Model:** MediaPipe-gezichtsdetectie (alleen gezichtsmodus)
+
+| Parameter | Type | Standaard | Beschrijving |
+|-----------|------|---------|-------------|
+| `mode` | string | `"subject"` | Uitsnijstrategie: `subject`, `face`, `trim` |
+| `strategy` | `"attention"` \| `"entropy"` | `"attention"` | Strategie voor onderwerpmodus |
+| `width` | integer | - | Uitvoerbreedte |
+| `height` | integer | - | Uitvoerhoogte |
+| `padding` | integer (0-50) | `0` | Percentage opvulling rond onderwerp |
+| `facePreset` | string | `"head-shoulders"` | Vaste kadering wanneer `mode=face` |
+| `sensitivity` | number (0-1) | `0.5` | Gezichtsdetectiedrempel |
+| `threshold` | integer (0-255) | `30` | Achtergronddetectiedrempel (trimmodus) |
+| `padToSquare` | boolean | `false` | Getrimd resultaat opvullen tot een vierkant |
+| `padColor` | string | `"#ffffff"` | Achtergrondkleur voor vierkante opvulling |
+| `targetSize` | integer | - | Doelgrootte voor opgevulde uitvoer (pixels) |
+| `quality` | integer (1-100) | - | Uitvoerkwaliteit |
+
+Verouderde `mode`-waarden `attention` en `content` worden geaccepteerd en respectievelijk toegewezen aan `subject` en `trim`.
+
+**Gezichtspresets:**
+
+| Preset | Best voor |
+|--------|---------|
+| `closeup` | Portretfoto's |
+| `head-shoulders` | Profielfoto's |
+| `upper-body` | LinkedIn / formeel |
+| `half-body` | Volledig bovenlichaam |
+
+## Audio transcriberen {#transcribe-audio}
+
+**Toolroute:** `transcribe-audio`  
+**Model:** faster-whisper
+
+Zet spraak om naar tekst. Ondersteunt platte tekst, SRT en VTT als uitvoerformaten.
+
+| Parameter | Type | Standaard | Beschrijving |
+|-----------|------|---------|-------------|
+| `language` | string | `"auto"` | Taal: `auto`, `en`, `de`, `fr`, `es`, `zh`, `ja`, `ko`, `id`, `th`, `vi` |
+| `outputFormat` | `"txt"` \| `"srt"` \| `"vtt"` | `"txt"` | Uitvoerformaat |
+
+## Automatische ondertiteling {#auto-subtitles}
+
+**Toolroute:** `auto-subtitles`  
+**Model:** faster-whisper (extraheert audio uit video en transcribeert vervolgens)
+
+Genereert ondertitelbestanden op basis van het audiospoor van een video.
+
+| Parameter | Type | Standaard | Beschrijving |
+|-----------|------|---------|-------------|
+| `language` | string | `"auto"` | Taal: `auto`, `en`, `de`, `fr`, `es`, `zh`, `ja`, `ko`, `id`, `th`, `vi` |
+| `format` | `"srt"` \| `"vtt"` | `"srt"` | Uitvoerformaat voor ondertitels |
+
+## PNG-transparantiehersteller {#png-transparency-fixer}
+
+**Toolroute:** `transparency-fixer`  
+**Model:** BiRefNet HR-matting (2048x2048-resolutie)
+
+Herstelt "nep-transparante" PNG's waarbij de achtergrond werd verwijderd maar fringing, halo's of semi-transparante artefacten achterbleven. Gebruikt het hoge-resolutie-mattingmodel van BiRefNet om een schoon alfakanaal te produceren en past vervolgens configureerbare defringe-verwerking toe om kleurverontreiniging langs randen te verwijderen.
+
+**OOM-fallbackketen:** Als BiRefNet HR-matting het beschikbare geheugen overschrijdt, valt de tool automatisch terug op `birefnet-general` en vervolgens op `u2net`.
+
+| Parameter | Type | Standaard | Beschrijving |
+|-----------|------|---------|-------------|
+| `defringe` | number (0-100) | `30` | Sterkte van rand-defringe om kleurverontreiniging te verwijderen |
+| `outputFormat` | `"png"` \| `"webp"` | `"png"` | Uitvoerformaat voor afbeelding |
+| `removeWatermark` | boolean | `false` | Voorbewerking voor watermerkverwijdering toepassen (mediaanfilter) |
+
+```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"}'
+```
+
+---
+
+## Tools met optionele AI-mogelijkheden {#tools-with-optional-ai-capabilities}
+
+De volgende tools zijn geen Python-sidecar-tools, maar gebruiken AI-functies wanneer bepaalde opties zijn ingeschakeld.
+
+### Afbeeldingsverbetering {#image-enhancement}
+
+**Toolroute:** `image-enhancement`  
+**Engine:** Analysegebaseerd (Sharp-histogram en -statistieken)
+
+Analyseert de afbeelding en past automatische correcties toe voor belichting, contrast, witbalans, verzadiging, scherpte en ruis. Ondersteunt scènespecifieke modi.
+
+| Parameter | Type | Standaard | Beschrijving |
+|-----------|------|---------|-------------|
+| `mode` | `"auto"` \| `"portrait"` \| `"landscape"` \| `"low-light"` \| `"food"` \| `"document"` | `"auto"` | Scènemodus voor het afstemmen van correcties |
+| `intensity` | number (0-100) | `50` | Algehele correctiesterkte |
+| `corrections.exposure` | boolean | `true` | Belichtingscorrectie toepassen |
+| `corrections.contrast` | boolean | `true` | Contrastcorrectie toepassen |
+| `corrections.whiteBalance` | boolean | `true` | Witbalanscorrectie toepassen |
+| `corrections.saturation` | boolean | `true` | Verzadigingscorrectie toepassen |
+| `corrections.sharpness` | boolean | `true` | Scherptecorrectie toepassen |
+| `corrections.denoise` | boolean | `true` | Denoising toepassen |
+| `deepEnhance` | boolean | `false` | AI-ruisverwijdering via SCUNet inschakelen (vereist `upscale-enhance`-bundel) |
+
+Er is een aanvullend analyse-endpoint beschikbaar op `POST /api/v1/tools/image/image-enhancement/analyze` dat de gedetecteerde correcties retourneert zonder ze toe te passen.
+
+### Inhoudsbewuste vergroting/verkleining (Seam Carving) {#content-aware-resize-seam-carving}
+
+**Toolroute:** `content-aware-resize`  
+**Engine:** Go `caire`-binary (geen Python: geen GPU-voordeel)
+
+Wijzigt op intelligente wijze het formaat van afbeeldingen door naden met lage energie te verwijderen, met behoud van belangrijke inhoud.
+
+| Parameter | Type | Standaard | Beschrijving |
+|-----------|------|---------|-------------|
+| `width` | number | - | Doelbreedte |
+| `height` | number | - | Doelhoogte |
+| `protectFaces` | boolean | `false` | Gedetecteerde gezichtsregio's beschermen (vereist `face-detection`-bundel) |
+| `blurRadius` | number (0-20) | `4` | Voorvervaging voor energieberekening |
+| `sobelThreshold` | number (1-20) | `2` | Drempel voor randgevoeligheid |
+| `square` | boolean | `false` | Vierkante uitvoer forceren |
@@ -0,0 +1,211 @@
+---
+description: "Referentie voor bewerkingen van de image-engine. Alle Sharp-gebaseerde afbeeldingsverwerkingsbewerkingen en hun parameters."
+i18n_source_hash: 42febdf85fa8
+i18n_provenance: human
+i18n_output_hash: 4749742b6fcc
+---
+
+# Image-engine {#image-engine}
+
+Het `@snapotter/image-engine` pakket verwerkt alle niet-AI-afbeeldingsbewerkingen. Het omhult [Sharp](https://sharp.pixelplumbing.com/) en draait volledig in-process zonder externe afhankelijkheden.
+
+## Bewerkingen {#operations}
+
+### resize {#resize}
+
+Schaal een afbeelding naar specifieke afmetingen of op percentage.
+
+| Parameter | Type | Beschrijving |
+|---|---|---|
+| `width` | number | Doelbreedte in pixels |
+| `height` | number | Doelhoogte in pixels |
+| `fit` | string | `cover`, `contain`, `fill`, `inside` of `outside` |
+| `withoutEnlargement` | boolean | Indien true, worden kleinere afbeeldingen niet opgeschaald |
+| `percentage` | number | Schaal op percentage in plaats van absolute afmetingen |
+
+Je kunt `width`, `height` of beide instellen. Als je er slechts één instelt, wordt de andere berekend om de beeldverhouding te behouden.
+
+### crop {#crop}
+
+Snijd een rechthoekig gebied uit de afbeelding.
+
+| Parameter | Type | Beschrijving |
+|---|---|---|
+| `left` | number | X-offset vanaf de linkerrand |
+| `top` | number | Y-offset vanaf de bovenrand |
+| `width` | number | Breedte van het bijsnijdgebied |
+| `height` | number | Hoogte van het bijsnijdgebied |
+| `unit` | string | `px` (standaard) of `percent` |
+
+### rotate {#rotate}
+
+Draai de afbeelding over een opgegeven hoek.
+
+| Parameter | Type | Beschrijving |
+|---|---|---|
+| `angle` | number | Rotatiehoek in graden (0-360) |
+| `background` | string | Vulkleur voor blootgesteld gebied (standaard: `#000000`). Alleen van toepassing op hoeken die niet 90 graden zijn. |
+
+### flip {#flip}
+
+Spiegel de afbeelding horizontaal, verticaal of beide. Ten minste één moet true zijn.
+
+| Parameter | Type | Beschrijving |
+|---|---|---|
+| `horizontal` | boolean | Spiegel van links naar rechts |
+| `vertical` | boolean | Spiegel van boven naar beneden |
+
+### convert {#convert}
+
+Wijzig het afbeeldingsformaat.
+
+| Parameter | Type | Beschrijving |
+|---|---|---|
+| `format` | string | Doelformaat: `jpg`, `png`, `webp`, `avif`, `tiff`, `gif`, `jxl`, `heic`, `heif`, `bmp`, `ico`, `jp2`, `qoi` |
+| `quality` | number | Compressiekwaliteit (1-100, van toepassing op lossy-formaten) |
+
+De eerste zeven formaten (`jpg` tot en met `jxl`) worden in-process door Sharp gecodeerd. De overige formaten gebruiken externe encoders op de API-laag: `heic`/`heif` via heif-enc, `bmp`/`ico` via ImageMagick, `jp2` via opj_compress en `qoi` via een inline TypeScript-codec.
+
+### compress {#compress}
+
+Verklein de bestandsgrootte met behoud van hetzelfde formaat.
+
+| Parameter | Type | Beschrijving |
+|---|---|---|
+| `quality` | number | Doelkwaliteit (1-100) |
+| `targetSizeBytes` | number | Optionele doelbestandsgrootte in bytes |
+| `format` | string | Optionele format-override |
+
+### strip-metadata {#strip-metadata}
+
+Verwijder EXIF-, IPTC-, XMP- en ICC-metadata uit de afbeelding. Zonder parameters (of `stripAll: true`) wordt alles verwijderd. Geef individuele vlaggen mee voor selectieve verwijdering.
+
+| Parameter | Type | Beschrijving |
+|---|---|---|
+| `stripAll` | boolean | Alle metadata verwijderen (standaard wanneer geen vlaggen zijn ingesteld) |
+| `stripExif` | boolean | EXIF-gegevens verwijderen (inclusief GPS als `stripGps` niet apart is ingesteld) |
+| `stripGps` | boolean | GPS-locatiegegevens verwijderen |
+| `stripIcc` | boolean | ICC-kleurprofiel verwijderen |
+| `stripXmp` | boolean | XMP-metadata verwijderen |
+
+### Kleuraanpassingen {#color-adjustments}
+
+Deze bewerkingen wijzigen de kleureigenschappen van een afbeelding. Elke neemt één numerieke waarde.
+
+| Bewerking | Parameter | Bereik | Beschrijving |
+|---|---|---|---|
+| `brightness` | `value` | -100 tot 100 | Helderheid aanpassen |
+| `contrast` | `value` | -100 tot 100 | Contrast aanpassen |
+| `saturation` | `value` | -100 tot 100 | Kleurverzadiging aanpassen |
+
+### Kleurfilters {#color-filters}
+
+Deze passen een vaste kleurtransformatie toe. Ze nemen geen parameters.
+
+| Bewerking | Beschrijving |
+|---|---|
+| `grayscale` | Omzetten naar grijstinten |
+| `sepia` | Een sepiatint toepassen |
+| `invert` | Alle kleuren omkeren |
+
+### Kleurkanalen {#color-channels}
+
+Pas individuele RGB-kleurkanalen aan. Waarden zijn vermenigvuldigers waarbij 100 = geen wijziging.
+
+| Parameter | Type | Beschrijving |
+|---|---|---|
+| `red` | number | Vermenigvuldiger rood kanaal (0 tot 200, 100 = ongewijzigd) |
+| `green` | number | Vermenigvuldiger groen kanaal (0 tot 200, 100 = ongewijzigd) |
+| `blue` | number | Vermenigvuldiger blauw kanaal (0 tot 200, 100 = ongewijzigd) |
+
+### sharpen {#sharpen}
+
+Eenvoudige verscherping, aangestuurd door één waarde.
+
+| Parameter | Type | Beschrijving |
+|---|---|---|
+| `value` | number | Verscherpingsintensiteit (0 tot 100). Toegewezen aan een Gaussische sigma van 0,5-10. |
+
+### sharpen-advanced {#sharpen-advanced}
+
+Geavanceerde verscherping met drie selecteerbare methoden en een optionele ruisverminderende voorbewerking.
+
+| Parameter | Type | Beschrijving |
+|---|---|---|
+| `method` | string | `adaptive`, `unsharp-mask` of `high-pass` |
+| `sigma` | number | Straal van Gaussische vervaging, 0,5-10 (adaptief) |
+| `m1` | number | Verscherping van vlakke gebieden, 0-10 (adaptief) |
+| `m2` | number | Verscherping van getextureerde gebieden, 0-20 (adaptief) |
+| `x1` | number | Drempel vlak/gekarteld, 0-10 (adaptief) |
+| `y2` | number | Max verheldering (halo-begrenzing), 0-50 (adaptief) |
+| `y3` | number | Max verdonkering (halo-begrenzing), 0-50 (adaptief) |
+| `amount` | number | Intensiteitspercentage, 0-500 (unsharp-mask) |
+| `radius` | number | Straal van vervaging, 0,1-5,0 (unsharp-mask) |
+| `threshold` | number | Minimale randhelderheid, 0-255 (unsharp-mask) |
+| `strength` | number | Sterkte van menging, 0-100 (high-pass) |
+| `kernelSize` | number | `3` of `5` voor 3x3- / 5x5-kernel (high-pass) |
+| `denoise` | string | Ruisverminderende voorbewerking: `off`, `light`, `medium` of `strong` |
+
+Parameters zijn methodespecifiek. Geef alleen de parameters mee die relevant zijn voor de gekozen methode.
+
+### color-blindness {#color-blindness}
+
+Simuleer een kleurzienstoornis met een 3x3-kleurhercombinatiematrix.
+
+| Parameter | Type | Beschrijving |
+|---|---|---|
+| `type` | string | Een van: `protanopia`, `deuteranopia`, `tritanopia`, `protanomaly`, `deuteranomaly`, `tritanomaly`, `achromatopsia`, `blueConeMonochromacy` |
+
+### edit-metadata {#edit-metadata}
+
+Schrijf of verwijder individuele EXIF-/IPTC-metadatavelden zonder het hele blok te verwijderen.
+
+| Parameter | Type | Beschrijving |
+|---|---|---|
+| `artist` | string | EXIF Artist-tag |
+| `copyright` | string | EXIF Copyright-tag |
+| `imageDescription` | string | EXIF ImageDescription-tag |
+| `software` | string | EXIF Software-tag |
+| `dateTime` | string | EXIF DateTime-tag |
+| `dateTimeOriginal` | string | EXIF DateTimeOriginal-tag |
+| `clearGps` | boolean | Alle GPS-tags verwijderen |
+| `fieldsToRemove` | string[] | Lijst met te verwijderen EXIF-veldnamen |
+
+Alle parameters zijn optioneel. Velden die in `fieldsToRemove` worden opgesomd, worden uit het bestaande EXIF-blok verwijderd. Velden die via de benoemde parameters zijn ingesteld, worden geschreven (of overschreven). Binaire/onveilige sleutels zoals MakerNote worden stilzwijgend genegeerd.
+
+## Formaatdetectie {#format-detection}
+
+De engine detecteert invoerformaten automatisch op basis van bestandsheaders, niet alleen op basis van bestandsextensies. Dit betekent dat een `.jpg`-bestand dat eigenlijk een PNG is, correct wordt verwerkt. De detectie gebruikt een meerlaagse aanpak: eerst magic bytes, daarna de bestandsextensie als fallback.
+
+SnapOtter ondersteunt **55+ invoerformaten** en **13 uitvoerformaten**, waaronder 23 camera-RAW-formaten van 20+ merken, professionele formaten (PSD, EPS, OpenEXR, HDR), moderne codecs (JPEG XL, AVIF, HEIC, QOI, JPEG 2000) en wetenschappelijke/gaming-formaten (FITS, DDS). Decodering wordt waar mogelijk native door Sharp afgehandeld, met automatische fallback naar ImageMagick, LibRaw en gespecialiseerde CLI-decoders.
+
+Zie de pagina [Ondersteunde formaten](/nl/guide/supported-formats) voor de volledige lijst.
+
+## Metadata-extractie {#metadata-extraction}
+
+De `info`-tool geeft afbeeldingsmetadata terug. Zie [Afbeeldingsinfo](/nl/tools/image/info) voor de volledige veldreferentie.
+
+```json
+{
+  "filename": "photo.jpg",
+  "fileSize": 2450000,
+  "width": 4032,
+  "height": 3024,
+  "format": "jpeg",
+  "channels": 3,
+  "hasAlpha": false,
+  "colorSpace": "srgb",
+  "density": 72,
+  "isProgressive": false,
+  "hasExif": true,
+  "hasIcc": true,
+  "hasXmp": false,
+  "bitDepth": "8",
+  "pages": 1,
+  "histogram": [
+    { "channel": "red", "min": 0, "max": 255, "mean": 128.45, "stdev": 52.31 },
+    { "channel": "green", "min": 2, "max": 253, "mean": 115.22, "stdev": 48.76 },
+    { "channel": "blue", "min": 0, "max": 250, "mean": 102.89, "stdev": 55.14 }
+  ]
+}
+```
@@ -0,0 +1,702 @@
+---
+description: "Volledige REST API-referentie. Tool-endpoints, batchverwerking, pipelines, bestandsbibliotheek, authenticatie, teams en beheerbewerkingen."
+i18n_source_hash: 8646977f7cc9
+i18n_provenance: machine
+i18n_output_hash: 8f6eabc592c0
+---
+
+# REST API-referentie {#rest-api-reference}
+
+Interactieve API-documentatie met voorbeelden van requests en responses is beschikbaar op [http://localhost:1349/api/docs](http://localhost:1349/api/docs).
+
+Machineleesbare specificaties:
+- `/api/v1/openapi.yaml` - OpenAPI 3.1-spec
+- `/llms.txt` - LLM-vriendelijke samenvatting
+- `/llms-full.txt` - Volledige LLM-vriendelijke documentatie
+
+## Authenticatie {#authentication}
+
+Alle endpoints vereisen authenticatie, tenzij `AUTH_ENABLED=false`.
+
+### Sessietoken {#session-token}
+
+```bash
+# Login
+curl -X POST http://localhost:1349/api/auth/login \
+  -H "Content-Type: application/json" \
+  -d '{"username":"admin","password":"admin"}'
+# Returns: {"token":"<session-token>"}
+
+# Use token
+curl http://localhost:1349/api/v1/tools/image/resize \
+  -H "Authorization: Bearer <session-token>"
+```
+
+Sessies verlopen na 7 dagen (configureerbaar via `SESSION_DURATION_HOURS`).
+
+### API-sleutels {#api-keys}
+
+```bash
+# Create a key (returns key once - store it)
+curl -X POST http://localhost:1349/api/v1/api-keys \
+  -H "Authorization: Bearer <session-token>" \
+  -H "Content-Type: application/json" \
+  -d '{"name":"my-script"}'
+# Returns: {"key":"si_<96 hex chars>","id":"...","name":"my-script"}
+
+# Use the key
+curl http://localhost:1349/api/v1/tools/image/resize \
+  -H "Authorization: Bearer si_<your-key>"
+```
+
+Sleutels krijgen het voorvoegsel `si_` en worden opgeslagen als scrypt-hashes. De ruwe sleutel wordt eenmaal getoond en is daarna nooit meer op te vragen.
+
+### Auth-endpoints {#auth-endpoints}
+
+| Methode | Pad | Toegang | Beschrijving |
+|--------|------|--------|-------------|
+| `POST` | `/api/auth/login` | Publiek | Inloggen, sessietoken ophalen |
+| `POST` | `/api/auth/logout` | Auth | Huidige sessie beëindigen |
+| `GET` | `/api/auth/session` | Auth | Huidige sessie valideren |
+| `POST` | `/api/auth/change-password` | Auth | Eigen wachtwoord wijzigen (maakt alle andere sessies + API-sleutels ongeldig) |
+| `GET` | `/api/auth/users` | Admin | Alle gebruikers weergeven |
+| `POST` | `/api/auth/register` | Admin | Een nieuwe gebruiker aanmaken |
+| `PUT` | `/api/auth/users/:id` | Admin | Rol of team van gebruiker bijwerken |
+| `POST` | `/api/auth/users/:id/reset-password` | Admin | Wachtwoord van gebruiker opnieuw instellen |
+| `DELETE` | `/api/auth/users/:id` | Admin | Een gebruiker verwijderen |
+| `GET` | `/api/v1/config/auth` | Publiek | Controleren of authenticatie is ingeschakeld (`{ authEnabled: bool }`) |
+| `POST` | `/api/auth/mfa/enroll` | Auth | TOTP MFA-registratie starten. Vereist de enterprise-functie `mfa` |
+| `POST` | `/api/auth/mfa/verify` | Auth | MFA-registratie bevestigen met een TOTP-code |
+| `POST` | `/api/auth/mfa/complete` | Publiek | Een openstaande MFA-inlogverificatie voltooien |
+| `POST` | `/api/auth/mfa/disable` | Auth | MFA uitschakelen voor de huidige gebruiker |
+| `POST` | `/api/auth/users/:id/mfa/reset` | Admin (`users:manage`) | MFA opnieuw instellen voor een gebruiker |
+| `GET` | `/api/auth/oidc/login` | Publiek | OIDC-login starten wanneer OIDC is ingeschakeld |
+| `GET` | `/api/auth/oidc/callback` | Publiek | OIDC-autorisatiecallback |
+| `GET` | `/api/auth/saml/metadata` | Publiek | SAML SP-metadata-XML wanneer SAML is ingeschakeld |
+| `GET` | `/api/auth/saml/login` | Publiek | SAML-login starten |
+| `POST` | `/api/auth/saml/callback` | Publiek | SAML assertion consumer service |
+
+Wanneer MFA is ingeschakeld voor een gebruiker, retourneert `POST /api/auth/login` een `{"requiresMfa":true,"mfaToken":"...","mfaRequired":true|false}` in plaats van een sessietoken. Stuur die `mfaToken` samen met een TOTP- of herstelcode naar `/api/auth/mfa/complete`.
+
+### Permissies {#permissions}
+
+| Permissie | Admin | Gebruiker |
+|-----------|:-----:|:----:|
+| Tools gebruiken | ✓ | ✓ |
+| Eigen bestanden/pipelines/API-sleutels | ✓ | ✓ |
+| Bestanden/pipelines/sleutels van alle gebruikers bekijken | ✓ | - |
+| Instellingen schrijven | ✓ | - |
+| Gebruikers & teams beheren | ✓ | - |
+| Branding beheren | ✓ | - |
+
+## Health check {#health-check}
+
+| Methode | Pad | Toegang | Beschrijving |
+|--------|------|--------|-------------|
+| `GET` | `/api/v1/health` | Publiek | Basale health check. Retourneert `{"status":"healthy","version":"..."}` met 200, of `{"status":"unhealthy"}` met 503 als de database onbereikbaar is. |
+| `GET` | `/api/v1/readyz` | Publiek | Readiness-probe. Controleert PostgreSQL, Redis, schijfruimte en S3 indien geconfigureerd. Retourneert 503 wanneer de instance geen verkeer zou moeten ontvangen. |
+| `GET` | `/api/v1/admin/health` | Admin (`system:health`) | Gedetailleerde diagnostiek, inclusief uptime, opslagmodus, databasestatus, queue-status en GPU-beschikbaarheid. |
+
+## Tools gebruiken {#using-tools}
+
+Elke tool volgt hetzelfde patroon:
+
+```bash
+# Single file
+curl -X POST http://localhost:1349/api/v1/tools/<section>/<toolId> \
+  -H "Authorization: Bearer <token>" \
+  -F "file=@input.jpg" \
+  -F 'settings={"width":800,"height":600}'
+
+# Batch (returns ZIP)
+curl -X POST http://localhost:1349/api/v1/tools/<section>/<toolId>/batch \
+  -H "Authorization: Bearer <token>" \
+  -F "files=@a.jpg" \
+  -F "files=@b.jpg" \
+  -F 'settings={...}'
+```
+
+`<section>` is een van `image`, `video`, `audio`, `pdf` of `files`.
+
+- Uploaden gebeurt met `multipart/form-data`.
+- `settings` is een JSON-string met tool-specifieke opties.
+- `clientJobId` is een optioneel formulierveld voor door de aanroeper aangeleverde voortgangscorrelatie.
+- `fileId` is een optioneel formulierveld dat verwijst naar een bestaand item in de bestandsbibliotheek. Wanneer aanwezig, wordt de verwerkte uitvoer opgeslagen als een nieuwe versie en bevat de response `savedFileId`.
+- **Snelle tools** retourneren meestal 200 JSON: `{"jobId":"...","downloadUrl":"/api/v1/download/<jobId>/<filename>","originalSize":1234,"processedSize":567}`. Haal het verwerkte bestand op via `downloadUrl`.
+- **Elke tool in de wachtrij** kan 202 JSON retourneren als deze langlopend is of het synchrone wachtvenster overschrijdt: `{"jobId":"...","async":true}`. Verbind met SSE voor voortgang en download bij voltooiing (zie [Voortgang volgen](#progress-tracking)).
+- **Batch**-routes retourneren een ZIP-archief dat rechtstreeks wordt gestreamd (met `X-Job-Id`-header) voor tools die zijn geregistreerd in het generieke batchregister.
+
+## Tools-referentie {#tools-reference}
+
+### Conversiepresets {#conversion-presets}
+
+De gedeelde catalogus bevat 83 speciale conversiepreset-endpoints zoals `jpg-to-png`, `mov-to-mp4`, `m4a-to-mp3`, `pdf-to-jpg` en `excel-to-csv`. Presets zijn eersteklas tool-routes:
+
+`POST /api/v1/tools/<section>/<presetId>`
+
+Elke preset vergrendelt het uitvoerformaat en delegeert naar een basistool zoals `convert`, `convert-video`, `extract-audio`, `convert-audio`, `image-to-pdf`, `pdf-to-image`, `svg-to-raster` of `convert-spreadsheet`. Zie [Conversiepresets](/nl/tools/conversion-presets) voor de volledige routetabel en optionele instellingen.
+
+### Essentials {#essentials}
+
+| Tool-ID | Naam | Belangrijkste instellingen |
+|---------|------|-------------|
+| `resize` | Formaat wijzigen | `width`, `height`, `fit` (cover/contain/fill/inside/outside), `percentage`, `withoutEnlargement`, plus 23 social media-presets |
+| `crop` | Bijsnijden | `left`, `top`, `width`, `height`, `unit` (px/percent) |
+| `rotate` | Roteren & spiegelen | `angle`, `horizontal` (bool), `vertical` (bool) |
+| `convert` | Converteren | `format` (jpg/png/webp/avif/tiff/gif/heic/heif), `quality` |
+| `compress` | Comprimeren | `mode` (quality/targetSize), `quality` (1–100), `targetSizeKb` |
+
+### Optimalisatie {#optimization}
+
+| Tool-ID | Naam | Belangrijkste instellingen |
+|---------|------|-------------|
+| `optimize-for-web` | Optimaliseren voor web | `format` (webp/jpeg/avif/png), `quality`, `maxWidth`, `maxHeight`, `progressive`, `stripMetadata` |
+| `strip-metadata` | Metadata verwijderen | - |
+| `edit-metadata` | Metadata bewerken | `title`, `description`, `author`, `copyright`, `keywords`, `gps` (lat/lon), `dateTime` |
+| `bulk-rename` | Bulk hernoemen | `pattern` (ondersteunt `{n}`, `{date}`, `{original}`), `startIndex`, `padding` |
+| `image-to-pdf` | Afbeelding naar PDF | `pageSize` (A4/Letter/...), `orientation`, `margin`, `targetSize` ({value, unit}) |
+| `favicon` | Favicon-generator | `padding`, `backgroundColor`, `borderRadius` - genereert alle standaardformaten |
+
+### Aanpassingen {#adjustments}
+
+| Tool-ID | Naam | Belangrijkste instellingen |
+|---------|------|-------------|
+| `adjust-colors` | Kleuren aanpassen | `brightness`, `contrast`, `exposure`, `saturation`, `temperature`, `tint`, `hue`, `sharpness`, `red`, `green`, `blue`, `effect` (none/grayscale/sepia/invert) |
+| `sharpening` | Verscherpen | `method` (adaptive/unsharp-mask/high-pass), `sigma`, `m1`, `m2`, `x1`, `y2`, `y3`, `amount`, `radius`, `threshold`, `strength`, `kernelSize` (3/5), `denoise` (off/light/medium/strong) |
+| `replace-color` | Kleur vervangen | `sourceColor`, `targetColor` (vervanging), `makeTransparent`, `tolerance` |
+| `color-blindness` | Kleurenblindheidssimulatie | `simulationType` (protanopia/deuteranopia/tritanopia/protanomaly/deuteranomaly/tritanomaly/achromatopsia/blueConeMonochromacy, standaard \"deuteranomaly\") |
+| `duotone` | Duotone | `shadow` (hex), `highlight` (hex), `intensity` (0-100) |
+| `pixelate` | Pixeleren | `blockSize` (2-128), `region` ({left, top, width, height} voor gedeeltelijke pixelering) |
+| `vignette` | Vignet | `strength` (0.1-1), `color` (hex), `radius`, `softness`, `roundness`, `centerX`, `centerY` |
+
+### AI-tools {#ai-tools}
+
+Alle AI-tools draaien op je eigen hardware: standaard op CPU, of op NVIDIA CUDA wanneer een ondersteunde NVIDIA-GPU beschikbaar is. Intel/AMD-iGPU-versnelling via VA-API, Quick Sync of OpenCL wordt momenteel niet ondersteund voor AI-inferentie. Geen internet vereist.
+
+| Tool-ID | Naam | AI-model | Belangrijkste instellingen |
+|---------|------|---------|-------------|
+| `remove-background` | Achtergrond verwijderen | rembg (BiRefNet / U2-Net) | `model`, `backgroundType` (transparent/color/gradient/blur/image), `backgroundColor`, `gradientColor1`, `gradientColor2`, `gradientAngle`, `blurEnabled`, `blurIntensity`, `shadowEnabled`, `shadowOpacity` |
+| `upscale` | Afbeelding upscalen | RealESRGAN | `scale` (2/4), `model`, `faceEnhance`, `denoise`, `format`, `quality` |
+| `erase-object` | Objectgum | LaMa (ONNX) | Masker verzonden als tweede bestandsdeel (veldnaam `mask`), `format`, `quality` |
+| `ocr` | OCR / Tekstextractie | PaddleOCR / Tesseract | `quality` (fast/balanced/best), `language`, `enhance` |
+| `blur-faces` | Gezicht / PII vervagen | MediaPipe | `blurRadius`, `sensitivity` |
+| `smart-crop` | Slim bijsnijden | MediaPipe + Sharp | `mode` (subject/face/trim), `strategy` (attention/entropy), `width`, `height`, `padding`, `facePreset` (closeup/head-shoulders/upper-body/half-body), `sensitivity`, `threshold`, `padToSquare`, `padColor`, `targetSize`, `quality` |
+| `image-enhancement` | Afbeelding verbeteren | Op analyse gebaseerd | `mode` (auto/exposure/contrast/color/sharpness), `strength` |
+| `enhance-faces` | Gezicht verbeteren | GFPGAN / CodeFormer | `model` (gfpgan/codeformer), `strength`, `sensitivity`, `centerFace` |
+| `colorize` | AI-inkleuring | DDColor | `intensity`, `model` |
+| `noise-removal` | Ruis verwijderen | Getrapte ruisonderdrukking | `tier` (quick/balanced/quality/maximum), `strength`, `detailPreservation`, `colorNoise`, `format`, `quality` |
+| `red-eye-removal` | Rode ogen verwijderen | Gezichtslandmark + kleuranalyse | `sensitivity`, `strength` |
+| `restore-photo` | Fotorestauratie | Meerstaps-pipeline | `mode` (auto/light/heavy), `scratchRemoval`, `faceEnhancement`, `fidelity`, `denoise`, `denoiseStrength`, `colorize` |
+| `passport-photo` | Pasfoto | MediaPipe-landmarks | Tweefasige flow. Analyse gebruikt multipart `file`; genereren gebruikt JSON met `countryCode`, `bgColor`, `printLayout` (none/4x6/a4), landmarks, afbeeldingsafmetingen |
+| `content-aware-resize` | Content-Aware Resize | Seam carving (caire) | `width`, `height`, `protectFaces`, `blurRadius`, `sobelThreshold`, `square` |
+| `transparency-fixer` | PNG-transparantiehersteller | BiRefNet HR-matting | `defringe` (0-100), `outputFormat` (png/webp) |
+| `background-replace` | Achtergrond vervangen | rembg (BiRefNet) | `backgroundType` (color/gradient), `color` (hex), `gradientColor1`, `gradientColor2`, `gradientAngle`, `feather` (0-20), `format` (png/webp) |
+| `blur-background` | Achtergrond vervagen | rembg (BiRefNet) | `intensity` (1-100), `feather` (0-20), `format` (png/webp) |
+| `ai-canvas-expand` | AI-canvas uitbreiden | LaMa (outpainting) | `extendTop`, `extendRight`, `extendBottom`, `extendLeft` (px), `tier` (fast/balanced/high), `format`, `quality` |
+
+### Watermerk & overlay {#watermark-overlay}
+
+| Tool-ID | Naam | Belangrijkste instellingen |
+|---------|------|-------------|
+| `watermark-text` | Tekstwatermerk | `text`, `font`, `fontSize`, `color`, `opacity`, `position`, `rotation`, `tile` |
+| `watermark-image` | Afbeeldingswatermerk | `opacity`, `position`, `scale` - het tweede bestand is het watermerk |
+| `text-overlay` | Tekstoverlay | `text`, `font`, `fontSize`, `color`, `x`, `y`, `background`, `padding`, `borderRadius` |
+| `compose` | Afbeeldingscompositie | `x`, `y`, `opacity`, `blend` - het tweede bestand wordt bovenop gelegd |
+| `meme-generator` | Meme-generator | `templateId`, `textLayout` (top-bottom/top-only/bottom-only/center/side-by-side), `textBoxes` ([{id, text}]), `fontFamily` (anton/arial-black/comic-sans/montserrat/bebas-neue/permanent-marker/roboto), `fontSize`, `textColor`, `strokeColor`, `textAlign`, `allCaps`. Ondersteunt sjabloonmodus (JSON-body met `templateId`) of aangepaste afbeeldingsmodus (multipart met bestand). |
+
+### Hulpmiddelen {#utilities}
+
+| Tool-ID | Naam | Belangrijkste instellingen |
+|---------|------|-------------|
+| `info` | Afbeeldingsinfo | - (retourneert width, height, format, size, channels, hasAlpha, DPI, EXIF) |
+| `compare` | Afbeeldingen vergelijken | `mode` (side-by-side/overlay/diff), `diffThreshold` - het tweede bestand is het vergelijkingsdoel |
+| `find-duplicates` | Duplicaten zoeken | `threshold` (perceptuele hash-afstand, standaard 8) - meerdere bestanden |
+| `color-palette` | Kleurenpalet | `count` (aantal dominante kleuren), `format` (hex/rgb) |
+| `qr-generate` | QR-codegenerator | `data`, `size`, `margin`, `colorDark`, `colorLight`, `errorCorrectionLevel`, `dotStyle`, `cornerStyle`, `logo` (optioneel bestand) |
+| `barcode-read` | Barcodelezer | - (detecteert automatisch QR, EAN, Code128, DataMatrix, enz.) |
+| `image-to-base64` | Afbeelding naar Base64 | `format` (data-uri/plain), `mimeType` |
+| `html-to-image` | HTML naar afbeelding | `url`, `format` (png/jpg/webp), `quality`, `fullPage`, `devicePreset` (desktop/tablet/mobile/custom), `viewportWidth`, `viewportHeight` |
+| `histogram` | Histogram | `scale` (linear/log) - retourneert een RGB-histogramgrafiek + statistieken per kanaal |
+| `lqip-placeholder` | LQIP-placeholder | `width` (4-64), `blur`, `strategy` (blur/pixelate/solid), `format` (webp/png/jpeg), `quality` |
+| `barcode-generate` | Barcodegenerator | `text`, `type` (code128/ean13/upca/code39/itf14/datamatrix), `scale` (1-8), `includeText` (bool). JSON-body, geen bestandsupload. |
+
+### Layout & compositie {#layout-composition}
+
+| Tool-ID | Naam | Belangrijkste instellingen |
+|---------|------|-------------|
+| `collage` | Collage / raster | `template` (25+ layouts), `gap`, `backgroundColor`, `borderRadius` - meerdere bestanden |
+| `stitch` | Aan elkaar plakken / combineren | `direction` (horizontal/vertical/grid), `gap`, `backgroundColor`, `alignment` - meerdere bestanden |
+| `split` | Afbeelding opsplitsen | `mode` (grid/rows/cols), `rows`, `cols`, `tileWidth`, `tileHeight` |
+| `border` | Rand & kader | `width`, `color`, `style` (solid/gradient/pattern), `borderRadius`, `padding`, `shadow` |
+| `beautify` | Screenshot verfraaien | `backgroundType` (solid/linear-gradient/radial-gradient/image/transparent), `gradientStops`, `padding`, `borderRadius`, `shadowPreset`, `frame` (none/macos-light/macos-dark/windows-light/windows-dark/browser-light/browser-dark/iphone/macbook/ipad/...), `socialPreset` (none/twitter/linkedin/instagram-square/instagram-story/facebook/producthunt), `watermarkText`, `outputFormat` |
+| `circle-crop` | Cirkelvormig bijsnijden | `zoom` (1-5), `offsetX`, `offsetY`, `borderWidth`, `borderColor`, `background` (transparent/hex), `outputSize` |
+| `image-pad` | Afbeelding opvullen | `target` (16:9/9:16/1:1/4:3/3:4/custom), `ratioW`, `ratioH`, `background` (color/transparent/blur), `color` (hex), `padding` (0-50%) |
+| `sprite-sheet` | Sprite sheet | `columns` (1-16), `padding`, `background` (hex), `format` (png/webp/jpeg), `quality` - meerdere bestanden (2-64 afbeeldingen) |
+
+### Formaat & conversie {#format-conversion}
+
+| Tool-ID | Naam | Belangrijkste instellingen |
+|---------|------|-------------|
+| `svg-to-raster` | SVG naar raster | `format` (png/jpeg/webp/avif/tiff/gif/heif), `width`, `height`, `scale`, `dpi`, `background` |
+| `vectorize` | Afbeelding naar SVG | `colorMode` (bw/color), `threshold`, `colorPrecision`, `filterSpeckle`, `pathMode` (none/polygon/spline) |
+| `gif-tools` | GIF-tools | `action` (resize/optimize/reverse/speed/extract-frames/rotate/add-text), actie-specifieke parameters |
+| `gif-webp` | GIF/WebP-converter | `quality` (1-100), `lossless` (bool), `resizePercent` (10-100) |
+
+### Videotools {#video-tools}
+
+| Tool-ID | Naam | Belangrijkste instellingen |
+|---------|------|-------------|
+| `convert-video` | Video converteren | `format` (mp4/mov/webm/avi/mkv), `quality` (high/balanced/small) |
+| `compress-video` | Video comprimeren | `quality` (light/balanced/strong), `resolution` (original/1080p/720p/480p) |
+| `trim-video` | Video inkorten | `startS`, `endS`, `precise` (bool, frame-nauwkeurige knip) |
+| `mute-video` | Video dempen | - |
+| `video-to-gif` | Video naar GIF | `fps` (1-30), `width`, `startS`, `durationS` (max 60s) |
+| `resize-video` | Videoformaat wijzigen | `width`, `height`, `preset` (custom/2160p/1440p/1080p/720p/480p/360p) |
+| `crop-video` | Video bijsnijden | `width`, `height`, `x`, `y` |
+| `rotate-video` | Video roteren | `transform` (cw90/ccw90/180/hflip/vflip) |
+| `change-fps` | FPS wijzigen | `fps` (1-120) |
+| `video-color` | Videokleur | `brightness`, `contrast`, `saturation`, `gamma` |
+| `video-speed` | Videosnelheid | `factor` (0.25-4), `keepPitch` (bool) |
+| `reverse-video` | Video omkeren | - (max 5 minuten) |
+| `video-loudnorm` | Audio normaliseren | - (EBU R128) |
+| `aspect-pad` | Aspect-opvulling | `target` (16:9/9:16/1:1/4:3/3:4), `color` (hex) |
+| `blur-pad` | Blur-opvulling | `target` (16:9/9:16/1:1/4:3/3:4), `blur` (2-50) |
+| `watermark-video` | Video van watermerk voorzien | `text`, `position`, `fontSize`, `opacity`, `color` |
+| `stabilize-video` | Video stabiliseren | `smoothing` (5-60, in frames) |
+| `gif-to-video` | GIF naar video | `format` (mp4/webm/mov) |
+| `video-to-webp` | Video naar WebP | `fps`, `width`, `quality`, `loop` (bool) |
+| `video-to-frames` | Video naar frames | `mode` (all/nth/timestamps), `n`, `timestamps`, `format` (png/jpg) |
+| `merge-videos` | Video's samenvoegen | - (meerdere bestanden, genormaliseerd naar de resolutie van de eerste video) |
+| `replace-audio` | Audio vervangen | - (video- + audiobestand, twee bestanden) |
+| `burn-subtitles` | Ondertitels inbranden | `fontSize` (8-72) - video- + ondertitelbestand |
+| `embed-subtitles` | Ondertitels insluiten | `language` (ISO 639-2/B-code) - video- + ondertitelbestand |
+| `extract-subtitles` | Ondertitels extraheren | - (levert SRT) |
+| `images-to-video` | Afbeeldingen naar video | `secondsPerImage` (0.5-10), `resolution` (1080p/720p/square), `fps` - meerdere bestanden |
+| `video-metadata` | Videometadata opschonen | - |
+| `auto-subtitles` | Automatische ondertitels (AI) | `language` (auto/en/de/fr/es/zh/ja/ko/id/th/vi), `format` (srt/vtt) |
+| `extract-audio` | Audio extraheren | `format` (mp3/wav/m4a/ogg) |
+
+### Audiotools {#audio-tools}
+
+| Tool-ID | Naam | Belangrijkste instellingen |
+|---------|------|-------------|
+| `convert-audio` | Audio converteren | `format` (mp3/wav/ogg/flac/m4a), `bitrateKbps` (32-320) |
+| `trim-audio` | Audio inkorten | `startS`, `endS` |
+| `volume-adjust` | Volume aanpassen | `gainDb` (-30 tot 30) |
+| `normalize-audio` | Audio normaliseren | - (EBU R128, -16 LUFS) |
+| `fade-audio` | Audio faden | `fadeInS` (0-30), `fadeOutS` (0-30) |
+| `reverse-audio` | Audio omkeren | - |
+| `audio-speed` | Audiosnelheid | `factor` (0.25-4) |
+| `pitch-shift` | Toonhoogte verschuiven | `semitones` (-12 tot 12) |
+| `audio-channels` | Audiokanalen | `mode` (stereo-to-mono/mono-to-stereo/swap) |
+| `silence-removal` | Stilte verwijderen | `thresholdDb` (-80 tot -20), `minSilenceS` (0.1-5) |
+| `noise-reduction` | Ruisonderdrukking | `strength` (light/medium/strong) |
+| `merge-audio` | Audio samenvoegen | `format` (mp3/wav/flac/m4a) - meerdere bestanden |
+| `split-audio` | Audio splitsen | `mode` (time/parts/silence), `segmentS`, `parts`, `thresholdDb`, `minSilenceS` |
+| `ringtone-maker` | Ringtone-maker | `startS`, `durationS` (1-30) |
+| `waveform-image` | Golfvormafbeelding | `width`, `height`, `color` (hex) |
+| `audio-metadata` | Audiometadata | `strip` (bool), `title`, `artist`, `album` |
+| `transcribe-audio` | Audio transcriberen (AI) | `language` (auto/en/de/fr/es/zh/ja/ko/id/th/vi), `outputFormat` (txt/srt/vtt) |
+
+### Documenttools {#document-tools}
+
+| Tool-ID | Naam | Belangrijkste instellingen |
+|---------|------|-------------|
+| `merge-pdf` | PDF's samenvoegen | - (meerdere bestanden, tot 20 PDF's) |
+| `split-pdf` | PDF splitsen | `mode` (range/every), `range`, `everyN` (1-500) |
+| `compress-pdf` | PDF comprimeren | `mode` (quality/targetSize), `quality` (1-100), `targetSizeKb` |
+| `rotate-pdf` | PDF roteren | `angle` (90/180/270), `range` (paginabereik) |
+| `extract-pages` | Pagina's extraheren | `range` (qpdf-syntaxis, bijv. \"1-5,8,10-z\") |
+| `remove-pages` | Pagina's verwijderen | `pages` (te verwijderen qpdf-bereik) |
+| `organize-pdf` | PDF ordenen | `order` (qpdf-paginavolgorde, bijv. \"3,1,2,5-z\") |
+| `protect-pdf` | PDF beveiligen | `userPassword`, `ownerPassword` (AES-256) |
+| `unlock-pdf` | PDF ontgrendelen | `password` |
+| `repair-pdf` | PDF repareren | - |
+| `linearize-pdf` | PDF web-optimaliseren | - (lineariseren voor snelle weergave op het web) |
+| `grayscale-pdf` | PDF grijswaarden | - |
+| `pdfa-convert` | PDF/A-conversie | - (archief-PDF/A-2) |
+| `crop-pdf` | PDF bijsnijden | `margin` (0-2000 punten) |
+| `nup-pdf` | N-up-PDF | `perSheet` (2/3/4/8/9/12/16) |
+| `booklet-pdf` | Boekje-PDF | `perSheet` (2/4/6/8) |
+| `watermark-pdf` | PDF van watermerk voorzien | `text`, `position`, `fontSize`, `opacity`, `rotation` |
+| `pdf-page-numbers` | PDF-paginanummers | `position` (bl/bc/br/tl/tc/tr), `fontSize` |
+| `flatten-pdf` | PDF plat maken | - (bakt formulieren en annotaties in) |
+| `redact-pdf` | PDF redigeren | `terms` (string[]), `caseSensitive` (bool) |
+| `sign-pdf` | PDF ondertekenen | Aangepaste multipart-route met PDF `file`, handtekeningbestanden `sig0`, `sig1` en `placements` JSON-array |
+| `pdf-to-text` | PDF naar tekst | - |
+| `pdf-to-word` | PDF naar Word | - |
+| `pdf-metadata` | PDF-metadata | `title`, `author`, `subject`, `keywords` |
+| `convert-document` | Document converteren | `format` (docx/odt/rtf/txt) |
+| `convert-presentation` | Presentatie converteren | `format` (pptx/odp) |
+| `convert-spreadsheet` | Spreadsheet converteren | `format` (xlsx/ods/csv) |
+| `excel-to-pdf` | Excel naar PDF | - |
+| `word-to-pdf` | Word naar PDF | - |
+| `powerpoint-to-pdf` | PowerPoint naar PDF | - |
+| `html-to-pdf` | HTML naar PDF | - (externe resources uitgeschakeld) |
+| `markdown-to-docx` | Markdown naar Word | - |
+| `markdown-to-html` | Markdown naar HTML | - |
+| `markdown-to-pdf` | Markdown naar PDF | - (externe resources uitgeschakeld) |
+| `epub-convert` | EPUB converteren | `format` (pdf/docx/html/md) |
+| `to-epub` | Converteren naar EPUB | - (accepteert .docx, .md, .html, .txt) |
+| `ocr-pdf` | PDF-OCR (AI) | `quality` (fast/balanced/best), `language` (auto/en/de/fr/es/zh/ja/ko), `pages` |
+| `pdf-to-image` | PDF naar afbeelding | `pages` (all/range), `format`, `dpi`, `quality` |
+| `pdf-to-jpg` | PDF naar JPG | `pages`, `dpi`, `quality`, `colorMode` |
+| `pdf-to-png` | PDF naar PNG | `pages`, `dpi`, `quality`, `colorMode` |
+| `pdf-to-tiff` | PDF naar TIFF | `pages`, `dpi`, `quality`, `colorMode` |
+
+### Bestandstools {#file-tools}
+
+| Tool-ID | Naam | Belangrijkste instellingen |
+|---------|------|-------------|
+| `chart-maker` | Grafiekmaker | `kind` (bar/line/pie), `title`, `width`, `height` |
+| `csv-excel` | CSV naar Excel | `sheet` (werkbladnummer voor XLSX-invoer) - bidirectioneel |
+| `csv-json` | CSV naar JSON | `pretty` (bool) - bidirectioneel |
+| `json-xml` | JSON naar XML | `pretty` (bool) - bidirectioneel |
+| `split-csv` | CSV splitsen | `rowsPerFile` (1-1000000), `keepHeader` (bool) |
+| `merge-csvs` | CSV's samenvoegen | - (meerdere bestanden, overeenkomende kolommen) |
+| `yaml-json` | YAML / JSON | - (bidirectioneel) |
+| `xml-to-csv` | XML naar CSV | - (vindt automatisch herhalende elementen) |
+| `excel-to-csv` | Excel naar CSV | speciale conversiepreset ondersteund door `convert-spreadsheet` |
+| `create-zip` | ZIP maken | - (meerdere bestanden, 2-50 bestanden) |
+| `extract-zip` | ZIP uitpakken | - (beschermd tegen zip-bommen) |
+
+### HTML naar afbeelding {#html-to-image}
+
+Leg een webpagina vast als afbeelding. Anders dan andere tools accepteert dit endpoint `application/json` in plaats van multipart-formuliergegevens (geen bestandsupload nodig).
+
+**Endpoint:** `POST /api/v1/tools/image/html-to-image`
+
+**Content-Type:** `application/json`
+
+| Parameter | Type | Standaard | Beschrijving |
+|-----------|------|---------|-------------|
+| `url` | string | (vereist) | Vast te leggen URL (alleen http/https) |
+| `format` | string | `"png"` | Uitvoerformaat: `jpg`, `png`, `webp` |
+| `quality` | number | `90` | Kwaliteit 1-100 (alleen JPG/WebP) |
+| `fullPage` | boolean | `false` | Volledige scrollbare pagina vastleggen |
+| `devicePreset` | string | `"desktop"` | `desktop`, `tablet`, `mobile`, `custom` |
+| `viewportWidth` | number | `1280` | Aangepaste viewport-breedte 320-3840 |
+| `viewportHeight` | number | `720` | Aangepaste viewport-hoogte 320-2160 |
+
+**Voorbeeld:**
+
+```bash
+curl -X POST http://localhost:1349/api/v1/tools/image/html-to-image \
+  -H "Authorization: Bearer $TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{"url": "https://snapotter.com", "format": "png", "devicePreset": "desktop"}'
+```
+
+**Response:**
+
+```json
+{
+  "jobId": "uuid",
+  "downloadUrl": "/api/v1/download/{jobId}/screenshot.png",
+  "originalSize": 0,
+  "processedSize": 54321
+}
+```
+
+### Tool-subroutes {#tool-sub-routes}
+
+Sommige tools stellen aanvullende endpoints beschikbaar naast de standaard `POST /api/v1/tools/<section>/<toolId>`:
+
+| Methode | Pad | Beschrijving |
+|--------|------|-------------|
+| `GET` | `/api/v1/tools/popular` | Populaire tool-ID's retourneren, met terugval naar een samengestelde standaardlijst wanneer er weinig gebruiksdata is |
+| `POST` | `/api/v1/tools/image/remove-background/effects` | Achtergrondeffecten toepassen (color/gradient/blur/shadow) zonder AI opnieuw uit te voeren. Gebruikt een gecacht masker van de oorspronkelijke verwijdering. |
+| `POST` | `/api/v1/tools/image/edit-metadata/inspect` | Bestaande EXIF/IPTC/XMP-metadata uit een afbeelding lezen |
+| `POST` | `/api/v1/tools/image/strip-metadata/inspect` | Metadatavelden inspecteren vóór het verwijderen |
+| `POST` | `/api/v1/tools/image/passport-photo/analyze` | Fase 1: AI-gezichtsdetectie + achtergrondverwijdering. Retourneert gezichtslandmarks en gecachte data. |
+| `POST` | `/api/v1/tools/image/passport-photo/generate` | Fase 2: bijsnijden, formaat wijzigen en tegelen met behulp van gecachte analyse. Geen nieuwe AI-run. |
+| `POST` | `/api/v1/tools/image/gif-tools/info` | GIF-metadata ophalen (aantal frames, afmetingen, duur) |
+| `POST` | `/api/v1/tools/pdf/pdf-to-image/info` | PDF-metadata ophalen (aantal pagina's, afmetingen) |
+| `POST` | `/api/v1/tools/pdf/pdf-to-image/preview` | Een voorbeeld van een specifieke PDF-pagina genereren |
+| `POST` | `/api/v1/tools/pdf/pdf-to-jpg/info` | PDF-metadata ophalen voor de speciale JPG-preset |
+| `POST` | `/api/v1/tools/pdf/pdf-to-jpg/preview` | Een voorbeeld van een PDF-pagina genereren voor de JPG-preset |
+| `POST` | `/api/v1/tools/pdf/pdf-to-png/info` | PDF-metadata ophalen voor de speciale PNG-preset |
+| `POST` | `/api/v1/tools/pdf/pdf-to-png/preview` | Een voorbeeld van een PDF-pagina genereren voor de PNG-preset |
+| `POST` | `/api/v1/tools/pdf/pdf-to-tiff/info` | PDF-metadata ophalen voor de speciale TIFF-preset |
+| `POST` | `/api/v1/tools/pdf/pdf-to-tiff/preview` | Een voorbeeld van een PDF-pagina genereren voor de TIFF-preset |
+| `POST` | `/api/v1/tools/image/svg-to-raster/batch` | Meerdere SVG's in batch naar raster converteren |
+| `POST` | `/api/v1/tools/image/image-enhancement/analyze` | Afbeeldingskwaliteit analyseren en verbeteringsaanbevelingen retourneren |
+| `POST` | `/api/v1/tools/image/optimize-for-web/preview` | Lichtgewicht voorbeeld voor live parameterafstemming. Retourneert een geoptimaliseerde afbeelding met formaatheaders. |
+
+## Batchverwerking {#batch-processing}
+
+Pas een generieke batch-geschikte tool tegelijk toe op meerdere bestanden. Retourneert een ZIP-archief. Aangepaste routes voor meerdere bestanden of meerdere stappen, zoals PDF-ondertekening, PDF-OCR en PDF-naar-afbeelding-preset-routes, gebruiken hun eigen endpointcontract in plaats van de generieke `/batch`-route.
+
+```bash
+curl -X POST http://localhost:1349/api/v1/tools/image/compress/batch \
+  -H "Authorization: Bearer <token>" \
+  -F "files=@a.jpg" \
+  -F "files=@b.jpg" \
+  -F "files=@c.jpg" \
+  -F 'settings={"quality":80}'
+```
+
+Concurrency wordt bepaald door `CONCURRENT_JOBS` (standaard: automatisch gedetecteerd op basis van CPU-cores). `MAX_BATCH_SIZE` beperkt het aantal bestanden per batch (standaard: 100; stel 0 in voor onbeperkt).
+
+## Pipelines {#pipelines}
+
+### Een pipeline uitvoeren {#execute-a-pipeline}
+
+```bash
+# Single file
+curl -X POST http://localhost:1349/api/v1/pipeline/execute \
+  -H "Authorization: Bearer <token>" \
+  -F "file=@input.jpg" \
+  -F 'pipeline={"steps":[
+    {"toolId":"resize","settings":{"width":1200}},
+    {"toolId":"compress","settings":{"quality":80}},
+    {"toolId":"watermark-text","settings":{"text":"© 2025"}}
+  ]}'
+
+# Batch (multiple files → ZIP)
+curl -X POST http://localhost:1349/api/v1/pipeline/batch \
+  -H "Authorization: Bearer <token>" \
+  -F "files=@a.jpg" \
+  -F "files=@b.jpg" \
+  -F 'pipeline={"steps":[{"toolId":"resize","settings":{"width":800}}]}'
+```
+
+De uitvoer van elke stap is de invoer van de volgende stap. Pipelines staan standaard 20 stappen toe, configureerbaar via `MAX_PIPELINE_STEPS`. Stel `MAX_PIPELINE_STEPS=0` in om de limiet te verwijderen.
+
+### Pipelines opslaan en beheren {#save-and-manage-pipelines}
+
+| Methode | Pad | Beschrijving |
+|--------|------|-------------|
+| `POST` | `/api/v1/pipeline/save` | Een benoemde pipeline opslaan (`name`, `description`, `steps[]`) |
+| `GET` | `/api/v1/pipeline/list` | Opgeslagen pipelines weergeven (admins zien alles; gebruikers zien de eigen) |
+| `DELETE` | `/api/v1/pipeline/:id` | Verwijderen (eigenaar of admin) |
+| `GET` | `/api/v1/pipeline/tools` | Tool-ID's weergeven die geldig zijn voor pipelinestappen |
+
+## Voortgang volgen {#progress-tracking}
+
+Langlopende taken, tools in de wachtrij, batchtaken en pipelines geven realtime voortgang door via Server-Sent Events. De voortgangsstroom is publiek en gekoppeld aan de job-ID, dus clients hoeven geen Authorization-header te sturen om deze te lezen.
+
+```bash
+# Connect to the SSE stream (jobId is in the JSON response body from the tool endpoint)
+curl -N http://localhost:1349/api/v1/jobs/<jobId>/progress
+```
+
+Event-formaat:
+```
+data: {"jobId":"...","type":"single","phase":"processing","stage":"Upscaling","percent":42}
+data: {"jobId":"...","type":"single","phase":"complete","percent":100,"result":{"downloadUrl":"/api/v1/download/..."}}
+data: {"jobId":"...","type":"batch","status":"processing","completedFiles":2,"totalFiles":5,"failedFiles":0,"errors":[]}
+```
+
+Je kunt annulering aanvragen voor een taak in de wachtrij of een lopende taak met `POST /api/v1/jobs/:jobId/cancel`. De response is `{"canceled":true|false}`.
+
+## Bestandsbibliotheek {#file-library}
+
+Persistente bestandsopslag met versiegeschiedenis.
+
+| Methode | Pad | Beschrijving |
+|--------|------|-------------|
+| `POST` | `/api/v1/upload` | Bestanden uploaden naar de werkruimte (tijdelijke verwerking) |
+| `POST` | `/api/v1/files/upload` | Bestanden uploaden naar de persistente bestandsbibliotheek |
+| `POST` | `/api/v1/files/save-result` | Een tool-verwerkingsresultaat opslaan als een nieuwe bestandsversie |
+| `GET` | `/api/v1/files` | Opgeslagen bestanden weergeven (gepagineerd, met zoekfunctie) |
+| `GET` | `/api/v1/files/:id` | Bestandsmetadata + versieketen ophalen |
+| `GET` | `/api/v1/files/:id/download` | Bestand downloaden |
+| `GET` | `/api/v1/files/:id/thumbnail` | 300px JPEG-thumbnail ophalen |
+| `DELETE` | `/api/v1/files` | Bestanden en hun versieketens in bulk verwijderen (body: `{ ids: [...] }`) |
+| `POST` | `/api/v1/fetch-urls` | Externe URL's ophalen in de werkruimte voor URL-gebaseerde imports |
+| `POST` | `/api/v1/preview` | Een browsercompatibele WebP-preview genereren (voor HEIC/HEIF/RAW-formaten) |
+| `GET` | `/api/v1/files/:id/preview` | Een gecachte of gegenereerde browsercompatibele preview streamen voor een opgeslagen PDF, Office-document, video of audiobestand |
+| `POST` | `/api/v1/preview/generate` | Een on-demand MP4- of MP3-preview genereren voor een geüpload mediabestand zonder het eerst op te slaan |
+| `GET` | `/api/v1/download/:jobId/:filename` | Een verwerkt bestand downloaden uit een werkruimte |
+
+Om een tool-resultaat automatisch op te slaan in de bibliotheek, voeg je `fileId` toe als multipart-formulierveld dat verwijst naar een bestaand bibliotheekbestand. Het verwerkte resultaat wordt opgeslagen als een nieuwe versie.
+
+## API-sleutelbeheer {#api-key-management}
+
+| Methode | Pad | Toegang | Beschrijving |
+|--------|------|--------|-------------|
+| `POST` | `/api/v1/api-keys` | Auth | Nieuwe sleutel genereren - eenmaal getoond |
+| `GET` | `/api/v1/api-keys` | Auth | Sleutels weergeven (name, id, lastUsedAt - niet de ruwe sleutel) |
+| `DELETE` | `/api/v1/api-keys/:id` | Auth | Sleutel verwijderen |
+
+## Teams {#teams}
+
+| Methode | Pad | Toegang | Beschrijving |
+|--------|------|--------|-------------|
+| `GET` | `/api/v1/teams` | Admin (`teams:manage`) | Teams weergeven |
+| `POST` | `/api/v1/teams` | Admin (`teams:manage`) | Team aanmaken |
+| `PUT` | `/api/v1/teams/:id` | Admin (`teams:manage`) | Team hernoemen |
+| `DELETE` | `/api/v1/teams/:id` | Admin (`teams:manage`) | Team verwijderen (het standaardteam of teams met leden kunnen niet worden verwijderd) |
+
+## Instellingen {#settings}
+
+Runtime key-value-configuratie (leesbaar door elke geauthenticeerde gebruiker, alleen schrijfbaar door admin).
+
+| Methode | Pad | Beschrijving |
+|--------|------|-------------|
+| `GET` | `/api/v1/settings` | Alle instellingen ophalen |
+| `PUT` | `/api/v1/settings` | Instellingen in bulk bijwerken (JSON-body met key-value-paren) |
+| `GET` | `/api/v1/settings/:key` | Een specifieke instelling ophalen op sleutel |
+
+Bekende sleutels: `disabledTools` (JSON-array van tool-ID's), `enableExperimentalTools` (bool-string), `loginAttemptLimit` (getal).
+
+## Voorkeuren {#preferences}
+
+Gebruikersvoorkeuren staan los van instance-instellingen. Elke geauthenticeerde gebruiker kan de eigen voorkeurenmap lezen en bijwerken.
+
+| Methode | Pad | Beschrijving |
+|--------|------|-------------|
+| `GET` | `/api/v1/preferences` | De voorkeuren van de huidige gebruiker ophalen als `{ "preferences": { ... } }` |
+| `PUT` | `/api/v1/preferences` | Een of meer voorkeurssleutels voor de huidige gebruiker upserten |
+
+## Rollen {#roles}
+
+Beheer van aangepaste rollen met gedetailleerde permissies.
+
+| Methode | Pad | Toegang | Beschrijving |
+|--------|------|--------|-------------|
+| `GET` | `/api/v1/roles` | Admin (`audit:read`) | Alle rollen weergeven met aantallen gebruikers |
+| `POST` | `/api/v1/roles` | Admin (`security:manage`) | Een aangepaste rol aanmaken (`name`, `description`, `permissions`) |
+| `PUT` | `/api/v1/roles/:id` | Admin (`security:manage`) | Een aangepaste rol bijwerken (ingebouwde rollen kunnen niet worden gewijzigd) |
+| `DELETE` | `/api/v1/roles/:id` | Admin (`security:manage`) | Een aangepaste rol verwijderen (ingebouwde rollen kunnen niet worden verwijderd; getroffen gebruikers keren terug naar de rol `user`) |
+
+Beschikbare permissies (17): `tools:use`, `files:own`, `files:all`, `apikeys:own`, `apikeys:all`, `pipelines:own`, `pipelines:all`, `settings:read`, `settings:write`, `users:manage`, `teams:manage`, `features:manage`, `system:health`, `audit:read`, `compliance:manage`, `webhooks:manage`, `security:manage`.
+
+## Auditlog {#audit-log}
+
+Alleen voor admins bestemd endpoint voor het beoordelen van beveiligingsrelevante acties.
+
+| Methode | Pad | Toegang | Beschrijving |
+|--------|------|--------|-------------|
+| `GET` | `/api/v1/audit-log` | Admin (`audit:read`) | Gepagineerd auditlog met optionele filters |
+
+Query-parameters:
+
+| Parameter | Beschrijving |
+|-----------|-------------|
+| `page` | Paginanummer (standaard: 1) |
+| `limit` | Vermeldingen per pagina (standaard: 50, max: 100) |
+| `action` | Filteren op actietype (bijv. `ROLE_CREATED`, `ROLE_DELETED`) |
+| `ip` | Filteren op bron-IP-adres |
+| `from` | Vermeldingen filteren na deze ISO 8601-datum |
+| `to` | Vermeldingen filteren vóór deze ISO 8601-datum |
+
+## Analytics {#analytics}
+
+| Methode | Pad | Toegang | Beschrijving |
+|--------|------|--------|-------------|
+| `GET` | `/api/v1/config/analytics` | Publiek | De effectieve analytics-configuratie ophalen (PostHog-sleutel, Sentry-DSN, sample rate). Sleutels, DSN en instance-ID zijn leeg wanneer analytics uit staat, hetzij door de compile-time-bake, hetzij door de instance-instelling `analyticsEnabled`. |
+| `POST` | `/api/v1/feedback` | Auth | Expliciete gebruikersfeedback indienen bij het geconfigureerde PostHog-project als `feedback_submitted`. De route respecteert de analytics-gate, beperkt de frequentie van inzendingen, verwijdert contactvelden tenzij `contactOk` waar is, en accepteert nooit bestandsinhoud, bestandsnamen, uploadpaden of ruwe private foutmeldingstekst. Wanneer analytics is uitgeschakeld, retourneert de route `{ "ok": true, "accepted": false }`. |
+| `PUT` | `/api/v1/settings` | Admin (`settings:write`) | De instance-brede opt-out instellen. Stuur een JSON-body `{ "analyticsEnabled": "false" }` om analytics voor iedereen uit te schakelen, of `"true"` om deze weer in te schakelen. |
+
+## Features / AI-bundels {#features-ai-bundles}
+
+Beheer AI-feature-bundels (installeer/verwijder AI-modelpakketten in de Docker-omgeving). Geef bij het inschakelen van een tool vanuit aangepaste automatisering de voorkeur aan het tool-niveau-installatie-endpoint: sommige AI-tools hebben meer dan één gedeelde bundel nodig, en dit endpoint slaat reeds geïnstalleerde bundels over en zet alleen de ontbrekende in de wachtrij.
+
+| Methode | Pad | Toegang | Beschrijving |
+|--------|------|--------|-------------|
+| `GET` | `/api/v1/features` | Auth | Alle feature-bundels en hun installatiestatus weergeven |
+| `POST` | `/api/v1/admin/features/:bundleId/install` | Admin (`features:manage`) | Een feature-bundel installeren (async, retourneert `jobId` voor voortgangsvolging) |
+| `POST` | `/api/v1/admin/tools/:toolId/features/install` | Admin (`features:manage`) | Elke bundel installeren die een tool vereist; retourneert de queued/skipped-status per bundel |
+| `POST` | `/api/v1/admin/features/:bundleId/uninstall` | Admin (`features:manage`) | Een feature-bundel verwijderen en modelbestanden opruimen |
+| `GET` | `/api/v1/admin/features/disk-usage` | Admin (`features:manage`) | Het totale schijfgebruik van AI-modellen ophalen |
+| `POST` | `/api/v1/admin/features/import` | Admin (`features:manage`) | Een offline AI-bundelarchief importeren |
+
+## Beheerbewerkingen {#admin-operations}
+
+Operationele endpoints voor observability, support, gebruiksrapportage en backupstatus.
+
+| Methode | Pad | Toegang | Beschrijving |
+|--------|------|--------|-------------|
+| `GET` | `/api/v1/admin/log-level` | Admin (`settings:write`) | Het huidige runtime-logniveau lezen |
+| `POST` | `/api/v1/admin/log-level` | Admin (`settings:write`) | Het runtime-logniveau wijzigen (`fatal`, `error`, `warn`, `info`, `debug`, `trace` of `silent`) |
+| `GET` | `/api/v1/metrics` | Admin (`system:health`) | Prometheus-metrics in tekstformaat |
+| `GET` | `/api/v1/admin/support-bundle` | Admin (`system:health`) | Een geredigeerde diagnostische supportbundel-ZIP downloaden |
+| `GET` | `/api/v1/admin/usage` | Admin (`audit:read`) | Gegevens voor het gebruiksdashboard, met optionele `days`-queryparameter |
+| `GET` | `/api/v1/admin/backup-status` | Admin (`system:health`) | Metadata en actualiteitsstatus van de laatste backup lezen |
+| `POST` | `/api/v1/admin/backup-status` | Admin (`system:health`) | Een voltooide backup registreren (`type`, optioneel `sizeBytes`, optioneel `notes`) |
+
+## Enterprise-API's {#enterprise-apis}
+
+Deze routes zijn licentiegebonden door de bijbehorende enterprise-functie. Ze vereisen nog steeds de vermelde SnapOtter-permissie.
+
+| Methode | Pad | Toegang | Beschrijving |
+|--------|------|--------|-------------|
+| `GET` | `/api/v1/enterprise/audit/export` | Admin (`audit:read`) | Auditvermeldingen exporteren als JSON of CSV met filters |
+| `GET` | `/api/v1/enterprise/config/export` | Admin (`system:health`) | Geredigeerde instance-configuratie, aangepaste rollen en teams exporteren |
+| `POST` | `/api/v1/enterprise/config/import` | Admin (`system:health`) | Configuratie importeren, met optionele dry run |
+| `GET` | `/api/v1/enterprise/ip-allowlist` | Admin (`security:manage`) | Geconfigureerde CIDR-allowlist lezen |
+| `PUT` | `/api/v1/enterprise/ip-allowlist` | Admin (`security:manage`) | CIDR-allowlist bijwerken met bescherming tegen zelf-buitensluiting |
+| `GET` | `/api/v1/enterprise/legal-hold` | Admin (`compliance:manage`) | Legal holds voor gebruikers en teams weergeven |
+| `PUT` | `/api/v1/enterprise/legal-hold` | Admin (`compliance:manage`) | Een legal hold op een gebruiker of team toepassen of opheffen |
+| `POST` | `/api/v1/enterprise/scim/token` | Admin (`users:manage`) | Een SCIM-bearertoken genereren, eenmaal geretourneerd |
+| `DELETE` | `/api/v1/enterprise/scim/token` | Admin (`users:manage`) | Het huidige SCIM-bearertoken intrekken |
+| `GET` | `/api/v1/enterprise/siem/config` | Admin (`webhooks:manage`) | SIEM-forwardingconfiguratie lezen |
+| `PUT` | `/api/v1/enterprise/siem/config` | Admin (`webhooks:manage`) | SIEM-forwardingconfiguratie bijwerken |
+| `GET` | `/api/v1/enterprise/webhooks` | Admin (`webhooks:manage`) | Webhook-bestemmingen weergeven |
+| `POST` | `/api/v1/enterprise/webhooks` | Admin (`webhooks:manage`) | Een webhook-bestemming aanmaken |
+| `PUT` | `/api/v1/enterprise/webhooks/:index` | Admin (`webhooks:manage`) | Een webhook-bestemming bijwerken |
+| `DELETE` | `/api/v1/enterprise/webhooks/:index` | Admin (`webhooks:manage`) | Een webhook-bestemming verwijderen |
+| `POST` | `/api/v1/enterprise/webhooks/:index/test` | Admin (`webhooks:manage`) | Een test-webhook-payload versturen |
+| `POST` | `/api/v1/enterprise/users/:id/export` | Admin (`compliance:manage`) | Een GDPR-gebruikersexporttaak starten |
+| `GET` | `/api/v1/enterprise/users/:id/export/:jobId` | Admin (`compliance:manage`) | GDPR-exportstatus en download-URL lezen |
+| `DELETE` | `/api/v1/enterprise/users/:id/purge` | Admin (`compliance:manage`) | De gegevens van een gebruiker na bevestiging permanent verwijderen |
+| `DELETE` | `/api/v1/enterprise/teams/:id/purge` | Admin (`compliance:manage`) | De gegevens van een team na bevestiging permanent verwijderen |
+| `GET` | `/api/v1/admin/version` | Admin (`system:health`) | App-, build-, Node- en schemaversiemetadata lezen |
+| `GET` | `/api/v1/admin/migrations/pending` | Admin (`system:health`) | Meegeleverde migraties vergelijken met toegepaste migraties |
+| `GET` | `/api/v1/admin/upgrade-check` | Admin (`system:health`) | Upgrade-gereedheidscontroles uitvoeren |
+
+### SCIM 2.0 {#scim-2-0}
+
+SCIM-discovery-endpoints zijn publiek. User- en group-endpoints vereisen het hierboven gegenereerde SCIM-bearertoken.
+
+| Methode | Pad | Toegang | Beschrijving |
+|--------|------|--------|-------------|
+| `GET` | `/api/v1/scim/v2/ServiceProviderConfig` | Publiek | SCIM-servercapaciteiten |
+| `GET` | `/api/v1/scim/v2/Schemas` | Publiek | SCIM-schema-discovery |
+| `GET` | `/api/v1/scim/v2/ResourceTypes` | Publiek | SCIM-resourcetype-discovery |
+| `GET` | `/api/v1/scim/v2/Users` | SCIM-token | Gebruikers weergeven, met optioneel SCIM-filter |
+| `POST` | `/api/v1/scim/v2/Users` | SCIM-token | Een gebruiker aanmaken |
+| `GET` | `/api/v1/scim/v2/Users/:id` | SCIM-token | Een gebruiker ophalen |
+| `PUT` | `/api/v1/scim/v2/Users/:id` | SCIM-token | Een gebruiker vervangen |
+| `DELETE` | `/api/v1/scim/v2/Users/:id` | SCIM-token | Een gebruiker soft-deactiveren |
+| `GET` | `/api/v1/scim/v2/Groups` | SCIM-token | Teams weergeven als SCIM-groepen |
+| `POST` | `/api/v1/scim/v2/Groups` | SCIM-token | Een team aanmaken |
+| `GET` | `/api/v1/scim/v2/Groups/:id` | SCIM-token | Een team ophalen |
+| `PUT` | `/api/v1/scim/v2/Groups/:id` | SCIM-token | Een team en groepslidmaatschap vervangen |
+| `DELETE` | `/api/v1/scim/v2/Groups/:id` | SCIM-token | Een team verwijderen |
+
+## Meme-sjablonen {#meme-templates}
+
+Ondersteunende API voor de meme-generatortool.
+
+| Methode | Pad | Toegang | Beschrijving |
+|--------|------|--------|-------------|
+| `GET` | `/api/v1/meme-templates` | Auth | Alle beschikbare meme-sjablonen weergeven met tekstvakposities |
+| `GET` | `/api/v1/meme-templates/full/:filename` | Auth | Sjabloonafbeelding op volledige grootte serveren |
+| `GET` | `/api/v1/meme-templates/thumbs/:filename` | Auth | Sjabloonthumbnail serveren |
+| `GET` | `/api/v1/meme-templates/fonts/:filename` | Auth | Fontbestand serveren dat wordt gebruikt voor het renderen van meme-tekst |
+
+## Foutresponses {#error-responses}
+
+Alle fouten retourneren JSON:
+
+```json
+{
+  "error": "Human-readable message",
+  "code": "MACHINE_READABLE_CODE"
+}
+```
+
+| Status | Betekenis |
+|--------|---------|
+| 400 | Ongeldig verzoek / validatie mislukt |
+| 401 | Niet geauthenticeerd |
+| 403 | Onvoldoende permissies |
+| 404 | Resource niet gevonden |
+| 413 | Bestand te groot (zie `MAX_UPLOAD_SIZE_MB`) |
+| 422 | Verwerking mislukt na validatie |
+| 429 | Rate-limited (zie `RATE_LIMIT_PER_MIN`) |
+| 501 | Vereiste AI-feature-bundel is niet geïnstalleerd (`FEATURE_NOT_INSTALLED`) |
+| 500 | Interne serverfout |