Files
SnapOtter/apps/docs/ar/tools/image/noise-removal.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

3.6 KiB

description, i18n_source_hash, i18n_provenance, i18n_output_hash
description i18n_source_hash i18n_provenance i18n_output_hash
إزالة الضوضاء والحبيبات المدعومة بالذكاء الاصطناعي مع خيارات جودة متعددة المستويات. f0dfc876e0e0 human 660ad3ea66a7

إزالة الضوضاء

إزالة الضوضاء والحبيبات المدعومة بالذكاء الاصطناعي مع خيارات جودة متعددة المستويات، باستخدام الوحدة الجانبية لـ Python (نموذج SCUNet).

نقطة نهاية الـ API

POST /api/v1/tools/image/noise-removal

المعالجة: غير متزامنة (تُرجع 202، استعلم عن /api/v1/jobs/{jobId}/progress لمعرفة الحالة عبر SSE)

حزمة النموذج: upscale-enhance (5-6 غيغابايت)

المعاملات

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

مثال على الطلب

curl -X POST http://localhost:1349/api/v1/tools/image/noise-removal \
  -F "file=@noisy-photo.jpg" \
  -F 'settings={"tier":"quality","strength":60,"detailPreservation":70,"colorNoise":40}'

الاستجابة

الاستجابة الأولية (202 Accepted)

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

التقدّم (SSE على /api/v1/jobs/{jobId}/progress)

event: progress
data: {"phase":"processing","stage":"Denoising...","percent":65}

النتيجة النهائية (عبر SSE)

{
  "phase": "complete",
  "percent": 100,
  "result": {
    "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "downloadUrl": "/api/v1/download/{jobId}/noisy-photo_denoised.jpg",
    "originalSize": 500000,
    "processedSize": 380000
  }
}

ملاحظات

  • يتطلب تثبيت حزمة النموذج upscale-enhance (5-6 غيغابايت).
  • تُوازن مستويات الجودة بين السرعة والجودة: quick هو الأسرع مع إزالة أساسية للضوضاء، بينما يستخدم maximum النهج الأكثر شمولًا متعدد المرات.
  • يُعد المعامل detailPreservation حاسمًا للأجسام ذات الملمس (القماش، الشعر، أوراق النبات). القيم الأعلى تمنع مزيل الضوضاء من طمس التفاصيل الدقيقة.
  • عند ضبط format على "original"، تطابق صيغة الإخراج صيغة ملف الإدخال.
  • يدعم صيغ الإدخال HEIC/HEIF وRAW وTGA وPSD وEXR وHDR عبر فك الترميز التلقائي.