التبكسل

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

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

POST /api/v1/tools/image/pixelate

يقبل بيانات نموذج متعدد الأجزاء مع ملف صورة وحقل JSON باسم settings.

المعاملات

المعامل	النوع	مطلوب	القيمة الافتراضية	الوصف
blockSize	integer	لا	12	حجم كتلة البكسل (2-128)؛ القيم الأكبر تنتج تبكسلًا أخشن
region	object	لا	-	تقييد التبكسل بمستطيل (انظر أدناه)

كائن المنطقة

الحقل	النوع	مطلوب	الوصف
left	integer	نعم	الإزاحة اليسرى بالبكسل (>= 0)
top	integer	نعم	الإزاحة العلوية بالبكسل (>= 0)
width	integer	نعم	عرض المنطقة بالبكسل (>= 1)
height	integer	نعم	ارتفاع المنطقة بالبكسل (>= 1)

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

تبكسل الصورة بالكامل:

curl -X POST http://localhost:1349/api/v1/tools/image/pixelate \
  -H "Authorization: Bearer si_your-api-key" \
  -F "[email protected]" \
  -F 'settings={"blockSize": 20}'

تبكسل منطقة محددة:

curl -X POST http://localhost:1349/api/v1/tools/image/pixelate \
  -H "Authorization: Bearer si_your-api-key" \
  -F "[email protected]" \
  -F 'settings={"blockSize": 16, "region": {"left": 100, "top": 50, "width": 200, "height": 150}}'

مثال على الاستجابة

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/photo.jpg",
  "originalSize": 2450000,
  "processedSize": 2380000
}

ملاحظات

• عند حذف region، تُبكسل الصورة بالكامل.
• إحداثيات المنطقة بالبكسل نسبةً إلى الركن العلوي الأيسر للصورة. يجب أن تقع المنطقة ضمن حدود الصورة.
• تطابق صيغة الإخراج صيغة الإدخال. تُفكّ ترميزات مدخلات HEIC وRAW وPSD وSVG تلقائيًا قبل المعالجة.