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

إزالة الضوضاء والحبيبات المدعومة بالذكاء الاصطناعي مع خيارات جودة متعددة المستويات، باستخدام الوحدة الجانبية لـ 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 "[email protected]" \
  -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 عبر فك الترميز التلقائي.