Files
SnapOtter/apps/docs/ar/api/ai.md
T
SnapOtterandGitHub 4963ab3bbd feat(docs-i18n): translate all documentation into 20 languages
All 181 docs markdown files translated into 20 languages (apps/docs/<locale>/**). Companion to the i18n code PR; admin-merged because the file count exceeds GitHub's per-PR CI trigger limit. Validated by pnpm i18n:check (all surfaces, 0 stale/missing) and a clean all-locale docs build.
2026-07-11 13:52:47 +08:00

29 KiB

description, i18n_source_hash, i18n_provenance, i18n_output_hash
description i18n_source_hash i18n_provenance i18n_output_hash
مرجع محرك الذكاء الاصطناعي مع جميع أدوات التعلم الآلي المحلية. إزالة الخلفية، وتحسين الدقة، وقراءة النصوص (OCR)، واكتشاف الوجوه، وترميم الصور، والمزيد. 14728c1dcd05 machine 7aeaaf9da34e

مرجع محرك الذكاء الاصطناعي

تربط الحزمة @snapotter/ai بين Node.js وعملية Python جانبية دائمة لجميع عمليات التعلم الآلي. تبقى عملية الموزّع نشطة بين الطلبات لأداء بدء دافئ سريع. يُكتشف NVIDIA CUDA تلقائيًا عند بدء التشغيل ويُستخدم عند توفره؛ وإلا فإن أدوات الذكاء الاصطناعي تعمل على وحدة المعالجة المركزية.

تسريع وحدة معالجة الرسومات المدمجة من Intel/AMD عبر VA-API أو Quick Sync أو OpenCL غير مدعوم لاستدلال الذكاء الاصطناعي حاليًا. تعيين /dev/dri داخل حاوية لا يسرّع أدوات Python الجانبية هذه ما لم تتوفر وحدة معالجة رسومات NVIDIA قادرة على تشغيل CUDA.

19 أداة ذكاء اصطناعي تعمل عبر Python الجانبية موزّعة على أربع طرائق (صورة، وصوت، وفيديو، ومستند)، بالإضافة إلى أداتين ذواتَي قدرات ذكاء اصطناعي اختيارية. تعمل جميع النماذج محليًا، ولا حاجة للإنترنت بعد التنزيل الأولي للنموذج.

البنية المعمارية

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)

يستبدل ملف تعريف موزّع "docs" منفصل قائمةَ السماح الخاصة بالذكاء الاصطناعي بنصوص معالجة المستندات (doc_pagecount، doc_health، doc_flatten، doc_redact، doc_text، doc_to_word، doc_metadata، doc_html_pdf) ويتجاوز عمليات استيراد التعلم الآلي الثقيلة.

المهل الزمنية: 300 ثانية افتراضيًا؛ وتحصل قراءة النصوص (OCR) وإزالة الخلفية بـ BiRefNet على 600 ثانية.

حزم الميزات

تُحزَّم نماذج الذكاء الاصطناعي حسب حزمة التبعيات المشتركة، وليس أرشيفًا واحدًا لكل أداة. يمكن لحزمة الميزات أن تُفعّل عدة أدوات عندما تستخدم العائلة نفسها من النماذج، أو حزم Python (wheels)، أو المكتبات الأصلية. يبقي هذا صورة Docker الخاصة بالإصدار أصغر ويتجنب تخزين نسخ مكررة من نماذج تنعيم الخلفية، واكتشاف الوجوه، وقراءة النصوص، والترميم، والكلام نفسها.

تشحن صورة Docker التطبيقَ إضافةً إلى وقت التشغيل المشترك. تُنزَّل أرشيفات النماذج الكبيرة عند الطلب إلى وحدة التخزين الدائمة /data/ai، ثم تُعاد استخدامها من قِبل كل أداة تحتاجها. إذا كانت الحزمة مثبّتة بالفعل لأن أداة أخرى احتاجتها، فإن تفعيل أداة جديدة معتمدة عليها لا يُعيد تنزيل تلك الحزمة.

تتطلب كل أداة ذكاء اصطناعي حزمة ميزات واحدة أو أكثر قبل أن تتمكن من العمل. تُثبِّت واجهة المسؤول حسب الأداة عبر POST /api/v1/admin/tools/:toolId/features/install، التي تحلّ قائمة الحزم الكاملة، وتتجاوز الحزم المثبّتة بالفعل، وتُدرِج فقط التنزيلات المفقودة في قائمة الانتظار. على سبيل المثال، تفعيل صورة جواز السفر على نسخة جديدة يُدرِج background-removal وface-detection في قائمة الانتظار؛ أما تفعيلها بعد تثبيت إزالة الخلفية بالفعل فيُدرِج face-detection فقط.

الحزمة الحجم مجموعة التبعيات المشتركة الأدوات التي تستخدمها
background-removal 4-5 GB تنعيم الخلفية rembg / BiRefNet remove-background, passport-photo, transparency-fixer, background-replace, blur-background
face-detection 200-300 MB اكتشاف الوجوه والمعالم في MediaPipe blur-faces, red-eye-removal, smart-crop
object-eraser-colorize 1-2 GB الرسم الداخلي/الخارجي بـ LaMa و DDColor erase-object, colorize, ai-canvas-expand
upscale-enhance 5-6 GB RealESRGAN و GFPGAN / CodeFormer وإزالة التشويش upscale, enhance-faces, noise-removal
photo-restoration 4-5 GB مسار إصلاح الخدوش والترميم restore-photo
ocr 5-6 GB حزمة قراءة النصوص PaddleOCR / Tesseract ocr, ocr-pdf
transcription ~600 MB نماذج تحويل الكلام إلى نص faster-whisper transcribe-audio, auto-subtitles

أدوات ذات تبعيات عبر عدة حزم:

الأداة الحزم المطلوبة السبب
passport-photo background-removal، face-detection يزيل الخلفية، ثم يستخدم معالم الوجه لتأطير القص وفق قواعد صور جواز السفر والهوية.
enhance-faces upscale-enhance، face-detection يكتشف الوجوه قبل تشغيل تحسين GFPGAN أو CodeFormer على مناطق الوجه المحددة.

تتوفر الأداة فقط عندما تكون جميع حزمها المطلوبة مثبّتة. عمليات التثبيت الجزئية صالحة وتُعالَج تدريجيًا: تُعاد استخدام الحزم المثبّتة، وتُعرَض الحزم المفقودة على أنها تنزيلات، وتُشغَّل عمليات التثبيت المُدرَجة في قائمة الانتظار واحدة تلو الأخرى بحيث لا تُعدَّل بيئة Python المشتركة بالتزامن.


إزالة الخلفية

مسار الأداة: remove-background
النموذج: rembg مع BiRefNet (الافتراضي) أو متغيرات U2-Net

المعامل النوع الافتراضي الوصف
model نص - متغير النموذج (تجاوز اختياري)
backgroundType نص "transparent" أحد: transparent، color، gradient، blur، image
backgroundColor نص - لون سداسي عشري لخلفية موحّدة
gradientColor1 نص - لون التدرّج الأول
gradientColor2 نص - لون التدرّج الثاني
gradientAngle رقم - زاوية التدرّج بالدرجات
blurEnabled منطقي - تفعيل تأثير طمس الخلفية
blurIntensity رقم (0-100) - شدة الطمس
shadowEnabled منطقي - تفعيل الظل المُسقَط على الموضوع
shadowOpacity رقم (0-100) - تعتيم الظل
outputFormat نص - تنسيق الإخراج: png أو webp أو avif
edgeRefine عدد صحيح (0-3) - مستوى تنقيح الحواف
decontaminate منطقي - إزالة تسرّب الألوان من الحواف

استبدال الخلفية

مسار الأداة: background-replace
النموذج: rembg / BiRefNet (مشترك مع remove-background)

يزيل الخلفية ويستبدلها بلون موحّد أو تدرّج لوني.

المعامل النوع الافتراضي الوصف
backgroundType "color" | "gradient" "color" وضع الخلفية
color نص "#ffffff" لون الخلفية السداسي العشري (عندما يكون backgroundType هو color)
gradientColor1 نص - لون التدرّج السداسي العشري الأول
gradientColor2 نص - لون التدرّج السداسي العشري الثاني
gradientAngle عدد صحيح (0-360) 180 زاوية التدرّج بالدرجات
feather عدد صحيح (0-20) 0 نصف قطر تنعيم الحواف
format "png" | "webp" "png" تنسيق الإخراج

طمس الخلفية

مسار الأداة: blur-background
النموذج: rembg / BiRefNet (مشترك مع remove-background)

يطمس الخلفية مع إبقاء الموضوع حادًا.

المعامل النوع الافتراضي الوصف
intensity عدد صحيح (1-100) 50 شدة الطمس
feather عدد صحيح (0-20) 0 نصف قطر تنعيم الحواف
format "png" | "webp" "png" تنسيق الإخراج

تحسين دقة الصورة

مسار الأداة: upscale
النموذج: RealESRGAN (مع الرجوع إلى Lanczos عند عدم التوفر)

المعامل النوع الافتراضي الوصف
scale رقم 2 عامل تحسين الدقة
model نص "auto" متغير النموذج
faceEnhance منطقي false تطبيق مرور تحسين الوجه بـ GFPGAN
denoise رقم 0 قوة إزالة التشويش
format نص "auto" تجاوز تنسيق الإخراج
quality رقم 95 جودة الإخراج (1-100)

قراءة النصوص (OCR) / استخراج النص

مسار الأداة: ocr
النماذج: Tesseract (سريع)، PaddleOCR PP-OCRv5 (متوازن)، PaddleOCR-VL 1.5 (الأفضل)

المعامل النوع الافتراضي الوصف
quality "fast" | "balanced" | "best" "balanced" طبقة المعالجة
language نص "auto" اللغة: auto، en، de، fr، es، zh، ja، ko
enhance منطقي true معالجة الصورة مسبقًا لتحسين دقة قراءة النصوص
engine نص - مهمَل. يعيّن tesseract إلى fast، وpaddleocr إلى balanced

يُرجِع نتائج مهيكلة مع مربعات إحاطة، ودرجات ثقة، وكتل نص مستخرجة.

قراءة نصوص PDF

مسار الأداة: ocr-pdf
النماذج: نظام الطبقات نفسه المستخدم في قراءة نصوص الصور

يستخرج النص من مستندات PDF الممسوحة ضوئيًا باستخدام قراءة النصوص المدعومة بالذكاء الاصطناعي، صفحة بصفحة.

المعامل النوع الافتراضي الوصف
quality "fast" | "balanced" | "best" "balanced" طبقة المعالجة
language نص "auto" اللغة: auto، en، de، fr، es، zh، ja، ko
pages نص "all" تحديد الصفحات: "all"، "1-3"، "1,3,5"

طمس الوجوه / المعلومات الشخصية

مسار الأداة: blur-faces
النموذج: اكتشاف الوجوه بـ MediaPipe

المعامل النوع الافتراضي الوصف
blurRadius رقم (1-100) 30 نصف قطر طمس غاوس
sensitivity رقم (0-1) 0.5 عتبة ثقة الاكتشاف

تحسين الوجه

مسار الأداة: enhance-faces
النماذج: GFPGAN، CodeFormer

المعامل النوع الافتراضي الوصف
model "auto" | "gfpgan" | "codeformer" "auto" نموذج التحسين
strength رقم (0-1) 0.8 قوة التحسين
sensitivity رقم (0-1) 0.5 عتبة اكتشاف الوجه
onlyCenterFace منطقي false تحسين الوجه الأكثر مركزية فقط

التلوين بالذكاء الاصطناعي

مسار الأداة: colorize
النموذج: DDColor (مع الرجوع إلى OpenCV DNN)

يحوّل الصور بالأبيض والأسود أو ذات التدرّج الرمادي إلى ألوان كاملة.

المعامل النوع الافتراضي الوصف
intensity رقم (0-1) 1.0 قوة تشبّع الألوان
model "auto" | "ddcolor" | "opencv" "auto" متغير النموذج

إزالة التشويش

مسار الأداة: noise-removal
النموذج: SCUNet (مسار إزالة تشويش متدرّج)

المعامل النوع الافتراضي الوصف
tier "quick" | "balanced" | "quality" | "maximum" "balanced" طبقة المعالجة
strength رقم (0-100) 50 قوة إزالة التشويش
detailPreservation رقم (0-100) 50 مقدار التفاصيل المراد الحفاظ عليها؛ القيمة الأعلى تُبقي نسيجًا أكثر
colorNoise رقم (0-100) 30 قوة تقليل تشويش الألوان
format نص "original" تنسيق الإخراج: original، png، jpeg، webp، avif، jxl
quality رقم (1-100) 90 جودة ترميز الإخراج

إزالة العين الحمراء

مسار الأداة: red-eye-removal

يكتشف معالم الوجه، ويحدد مناطق العينين، ويصحح فرط تشبّع القناة الحمراء.

المعامل النوع الافتراضي الوصف
sensitivity رقم (0-100) 50 عتبة اكتشاف البكسل الأحمر
strength رقم (0-100) 70 قوة التصحيح
format نص - تجاوز تنسيق الإخراج (اختياري)
quality رقم (1-100) 90 جودة الإخراج

ترميم الصور

مسار الأداة: restore-photo

مسار متعدد الخطوات للصور القديمة أو التالفة: اكتشاف الخدوش/التمزقات وإصلاحها، وتحسين الوجه، وإزالة التشويش، والتلوين الاختياري.

المعامل النوع الافتراضي الوصف
scratchRemoval منطقي true اكتشاف الخدوش والتمزقات وإصلاحها
faceEnhancement منطقي true تطبيق مرور تحسين الوجه
fidelity رقم (0-1) 0.7 قوة تحسين الوجه (الأعلى = أكثر تحفظًا)
denoise منطقي true تطبيق مرور إزالة التشويش
denoiseStrength رقم (0-100) 25 قوة إزالة التشويش
colorize منطقي false التلوين بعد الترميم
colorizeStrength رقم (0-100) 85 شدة التلوين

صورة جواز السفر

مسار الأداة: passport-photo
النماذج: معالم الوجه بـ MediaPipe + إزالة الخلفية بـ BiRefNet

سير عمل من مرحلتين: التحليل (اكتشاف الوجه + إزالة الخلفية) ثم التوليد (القص، وتغيير الحجم، والتبليط). يدعم أكثر من 37 دولة عبر 6 مناطق.

المرحلة 1: التحليل

POST /api/v1/tools/image/passport-photo/analyze

يقبل ملف صورة (متعدد الأجزاء). يُرجِع بيانات معالم الوجه، ومعاينة بترميز base64، وأبعاد الصورة.

المرحلة 2: التوليد

POST /api/v1/tools/image/passport-photo/generate

يقبل جسم JSON يحتوي على نتائج المرحلة 1 إضافةً إلى إعدادات التوليد:

المعامل النوع الافتراضي الوصف
jobId نص (مطلوب) معرّف المهمة من المرحلة 1
filename نص (مطلوب) اسم الملف الأصلي من المرحلة 1
countryCode نص (مطلوب) رمز الدولة ISO (مثل US، GB، IN)
documentType نص "passport" نوع المستند
bgColor نص "#FFFFFF" لون الخلفية السداسي العشري
printLayout نص "none" تخطيط الطباعة: none، 4x6، a4، letter
maxFileSizeKb رقم 0 الحد الأقصى لحجم الملف بالكيلوبايت (0 = بلا حد)
dpi رقم (72-1200) 300 دقة الإخراج DPI
customWidthMm رقم - عرض مخصص بالمليمتر (يتجاوز مواصفات الدولة)
customHeightMm رقم - ارتفاع مخصص بالمليمتر (يتجاوز مواصفات الدولة)
zoom رقم (0.5-3) 1 عامل التكبير
adjustX رقم 0 تعديل الموضع الأفقي
adjustY رقم 0 تعديل الموضع الرأسي
landmarks كائن (مطلوب) المعالم من المرحلة 1
imageWidth رقم (مطلوب) عرض الصورة من المرحلة 1
imageHeight رقم (مطلوب) ارتفاع الصورة من المرحلة 1

محو الأجسام (الرسم الداخلي)

مسار الأداة: erase-object
النموذج: LaMa عبر ONNX Runtime

يُرسَل القناع كـجزء ملف ثانٍ (اسم الحقل mask)، وليس بترميز base64. تشير البكسلات البيضاء في القناع إلى المناطق المراد محوها. يُرسَل الإعدادان format وquality كحقول نموذج علوية المستوى.

المعامل النوع الافتراضي الوصف
file ملف (مطلوب) الصورة المصدر (متعددة الأجزاء)
mask ملف (مطلوب) صورة القناع (متعددة الأجزاء، اسم الحقل mask، الأبيض = محو)
format نص "auto" تنسيق الإخراج: auto، png، jpg، jpeg، webp، tiff، gif، avif، heic، heif، jxl
quality عدد صحيح (1-100) 95 جودة الإخراج

مُسرَّع بـ CUDA عند توفر وحدة معالجة رسومات NVIDIA.

توسيع اللوحة بالذكاء الاصطناعي

مسار الأداة: ai-canvas-expand
النموذج: الرسم الخارجي القائم على LaMa

يوسّع لوحة الصورة في أي اتجاه ويملأ المناطق الجديدة بمحتوى مولّد بالذكاء الاصطناعي يطابق الصورة الموجودة.

المعامل النوع الافتراضي الوصف
extendTop عدد صحيح 0 البكسلات المراد تمديدها في الأعلى
extendRight عدد صحيح 0 البكسلات المراد تمديدها على اليمين
extendBottom عدد صحيح 0 البكسلات المراد تمديدها في الأسفل
extendLeft عدد صحيح 0 البكسلات المراد تمديدها على اليسار
tier "fast" | "balanced" | "high" "balanced" طبقة الجودة
format نص "auto" تنسيق الإخراج: auto، png، jpg، jpeg، webp، tiff، gif، avif، heic، heif، jxl
quality عدد صحيح (1-100) 95 جودة الإخراج

يجب أن يكون اتجاه تمديد واحد على الأقل أكبر من 0.

القص الذكي

مسار الأداة: smart-crop
النموذج: اكتشاف الوجوه بـ MediaPipe (وضع الوجه فقط)

المعامل النوع الافتراضي الوصف
mode نص "subject" استراتيجية القص: subject، face، trim
strategy "attention" | "entropy" "attention" استراتيجية وضع الموضوع
width عدد صحيح - عرض الإخراج
height عدد صحيح - ارتفاع الإخراج
padding عدد صحيح (0-50) 0 نسبة الحشو حول الموضوع
facePreset نص "head-shoulders" التأطير المُعَدّ مسبقًا عند mode=face
sensitivity رقم (0-1) 0.5 عتبة اكتشاف الوجه
threshold عدد صحيح (0-255) 30 عتبة اكتشاف الخلفية (وضع التشذيب)
padToSquare منطقي false حشو النتيجة المُشذَّبة إلى مربع
padColor نص "#ffffff" لون الخلفية للحشو المربّع
targetSize عدد صحيح - الحجم المستهدف للإخراج المحشو (بالبكسل)
quality عدد صحيح (1-100) - جودة الإخراج

تُقبَل القيم القديمة mode وهي attention وcontent وتُعيَّن إلى subject وtrim على التوالي.

الإعدادات المسبقة للوجه:

الإعداد المسبق الأفضل لِـ
closeup لقطات الرأس
head-shoulders صور الملف الشخصي
upper-body LinkedIn / رسمي
half-body الجزء العلوي الكامل من الجسم

نسخ الصوت

مسار الأداة: transcribe-audio
النموذج: faster-whisper

يحوّل الكلام إلى نص. يدعم تنسيقات إخراج النص العادي و SRT و VTT.

المعامل النوع الافتراضي الوصف
language نص "auto" اللغة: auto، en، de، fr، es، zh، ja، ko، id، th، vi
outputFormat "txt" | "srt" | "vtt" "txt" تنسيق الإخراج

الترجمات التلقائية

مسار الأداة: auto-subtitles
النموذج: faster-whisper (يستخرج الصوت من الفيديو، ثم ينسخه)

يولّد ملفات ترجمة من مسار الصوت في الفيديو.

المعامل النوع الافتراضي الوصف
language نص "auto" اللغة: auto، en، de، fr، es، zh، ja، ko، id، th، vi
format "srt" | "vtt" "srt" تنسيق ملف الترجمة للإخراج

مُصلِح شفافية PNG

مسار الأداة: transparency-fixer
النموذج: تنعيم BiRefNet عالي الدقة (بدقة 2048x2048)

يصلح ملفات PNG "الشفافة الزائفة" حيث أُزيلت الخلفية لكنها تركت وراءها هُدبًا، أو هالات، أو عيوبًا شبه شفافة. يستخدم نموذج التنعيم عالي الدقة من BiRefNet لإنتاج قناة ألفا نظيفة، ثم يطبّق معالجة إزالة هُدب قابلة للتهيئة لإزالة تلوث الألوان على طول الحواف.

سلسلة الرجوع عند نفاد الذاكرة (OOM): إذا تجاوز تنعيم BiRefNet عالي الدقة الذاكرة المتاحة، ترجع الأداة تلقائيًا إلى birefnet-general، ثم إلى u2net.

المعامل النوع الافتراضي الوصف
defringe رقم (0-100) 30 قوة إزالة هُدب الحواف لإزالة تلوث الألوان
outputFormat "png" | "webp" "png" تنسيق صورة الإخراج
removeWatermark منطقي false تطبيق معالجة مسبقة لإزالة العلامة المائية (مرشّح وسيط)
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"}'

أدوات ذات قدرات ذكاء اصطناعي اختيارية

الأدوات التالية ليست أدوات Python جانبية لكنها تستخدم ميزات الذكاء الاصطناعي عند تفعيل خيارات معينة.

تحسين الصورة

مسار الأداة: image-enhancement
المحرك: قائم على التحليل (المدرج التكراري والإحصاءات في Sharp)

يحلّل الصورة ويطبّق تصحيحات تلقائية للتعريض، والتباين، وتوازن الأبيض، والتشبّع، والحدة، والتشويش. يدعم أوضاعًا خاصة بالمشهد.

المعامل النوع الافتراضي الوصف
mode "auto" | "portrait" | "landscape" | "low-light" | "food" | "document" "auto" وضع المشهد لضبط التصحيحات
intensity رقم (0-100) 50 قوة التصحيح الإجمالية
corrections.exposure منطقي true تطبيق تصحيح التعريض
corrections.contrast منطقي true تطبيق تصحيح التباين
corrections.whiteBalance منطقي true تطبيق تصحيح توازن الأبيض
corrections.saturation منطقي true تطبيق تصحيح التشبّع
corrections.sharpness منطقي true تطبيق تصحيح الحدة
corrections.denoise منطقي true تطبيق إزالة التشويش
deepEnhance منطقي false تفعيل إزالة التشويش بالذكاء الاصطناعي عبر SCUNet (يتطلب حزمة upscale-enhance)

تتوفر نقطة نهاية تحليل إضافية عند POST /api/v1/tools/image/image-enhancement/analyze تُرجِع التصحيحات المكتشفة دون تطبيقها.

تغيير الحجم المدرك للمحتوى (نحت الأطراف)

مسار الأداة: content-aware-resize
المحرك: ثنائي caire بلغة Go (ليس Python، لا فائدة من وحدة معالجة الرسومات)

يغيّر حجم الصور بذكاء عن طريق إزالة الأطراف منخفضة الطاقة، مع الحفاظ على المحتوى المهم.

المعامل النوع الافتراضي الوصف
width رقم - العرض المستهدف
height رقم - الارتفاع المستهدف
protectFaces منطقي false حماية مناطق الوجه المكتشفة (يتطلب حزمة face-detection)
blurRadius رقم (0-20) 4 طمس مسبق لحساب الطاقة
sobelThreshold رقم (1-20) 2 عتبة حساسية الحواف
square منطقي false فرض إخراج مربّع