API الصور: الضغط وتغيير الأبعاد والتحويل
غيّر أبعاد الصور واقتصها ودوّرها واضغطها وفق جودة محددة أو حجم مستهدف بالبايت، وحوّلها إلى JPG أو PNG أو WebP أو AVIF في استدعاء pipeline واحد.
إجابة مختصرة
أرسل POST /api/v1/pipeline/ مع sourceKey وخطوة {"operation":"image","pipeline":[…]} تسرد ما يصل إلى 8 عمليات: resize (maxWidth, maxHeight)، وcrop (x, y, width, height)، وrotate (degrees)، وcompress (quality 1–100 أو targetBytes)، وconvert (jpg, png, webp, avif). وللصور الموجودة بالفعل في مستنداتي استخدم /documents/{documentId}/process/ مع {"operation":"image","pipeline":[…]}.
الضغط للويب
يحدّ مسار المعالجة المعتاد لصور المنتجات من الأبعاد ويحوّلها إلى WebP. في اختبارنا، تحولت صورة PNG بحجم 224 KB إلى WebP بحجم 30 KB وعرض 400 بكسل في نحو 4 ثوانٍ.
curl -X POST 'https://maxscanner.app/api/v1/pipeline/' \
-H "Authorization: Bearer $MAXSCANNER_API_KEY" \
-H 'Content-Type: application/json' \
-d '{ "sourceKey": "users/<id>/media/inbox/…-photo.png", "steps": [ { "operation": "image", "pipeline": [ { "operation": "resize", "maxWidth": 1600 }, { "operation": "compress", "quality": 75, "format": "webp" } ] } ] }'الوصول إلى حجم ملف مستهدف
كثيرًا ما تشترط بوابات الرفع حجمًا "أقل من 200 KB". استخدم compress مع targetBytes بدلًا من quality؛ إذ يبحث العامل عن أعلى جودة تناسب الحجم المطلوب. ويجب أن تقع القيم المستهدفة بين الحدين الأدنى والأقصى اللذين تسمح بهما API (حتى 20 MB).
{ "operation": "image", "pipeline": [ { "operation": "resize", "maxWidth": 1200 }, { "operation": "compress", "targetBytes": 204800, "format": "jpg" } ] }ربط خطوات الصور مع PDF وOCR
يمكن أن تستمر مسارات المعالجة بعد خطوة الصورة: أضف {"operation":"convert","format":"pdf"} لتضمين النتيجة في ملف PDF، أو {"operation":"ocr","format":"pdf"} لجعلها قابلة للبحث. وعندما تحتاج الخطوة التالية إلى ذلك، تُخرج خطوة الصورة ملف PNG تلقائيًا.
الأسئلة الشائعة
هل يزيل الضغط البيانات الوصفية؟
لا تحتفظ الصور المعاد ترميزها ببيانات EXIF مثل الموقع الجغرافي (GPS)، وهذا عادةً ما تريده للصور العامة.
أي صيغة أختار؟
WebP لمواقع الويب، وJPG حيث يكون التوافق هو الأهم، وPNG للقطات الشاشة والرسوم الخطية، وAVIF للحصول على أصغر الملفات عندما يستخدم جمهورك متصفحات حديثة.