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

مثال صورة بعلامة مائية في الموضع southeast:

مثال صورة بخلفية ملونة:

مثال صورة بتدرج رمادي:

مثال التحويل إلى WebP:
معاملات الترويسة
معاملات الجسم
عنوان URL للصورة المراد تغيير حجمها. يجب أن يبدأ بـ
https://منصة الوسائط الاجتماعية التي سيُغيَّر حجم الـ URL لها. راجع خيارات المنصة
للتفاصيل.
أرسل ملف الوسائط كائن نموذج multipart form-data. مطلوب إذا لم يكن
imageUrl موجودًا.عنوان URL وموضع اختياري للعلامة المائية التي ستُطبَّق على الصورة بعد تغيير حجمها. ستظهر العلامة المائية
افتراضيًا في الزاوية اليمنى السفلى للصورة. راجع العلامة المائية
للتفاصيل.
غيّر الشفافية والألوان وما إلى ذلك. راجع خيارات التأثيرات
للتفاصيل.
كائن يحدد
width وheight لتغيير الحجم. في حال الاقتطاع، يمكنك اختياريًا تحديد إحداثيات x وy للمركز.
الافتراضي هو مركز الصورة.الأبعاد
العرض والارتفاع مطلوبان إذا لم تُحدَّد المنصة.
يحول تلقائيًا إلى ملف JPG، مثلًا من PNG إلى JPG. سيُستخدم مستوى جودة 75%.
راجع التحويل إلى JPG للتفاصيل.
يحول تلقائيًا إلى ملف WebP، مثلًا من PNG إلى WebP. سيُستخدم مستوى جودة 75%.
راجع التحويل إلى WebP للتفاصيل.
خيارات المنصة
حدّد منصة كسلسلة نصية لاستخدام الأبعاد المحددة مسبقًا للصورة، أو يمكنك تحديد أبعادك الخاصة باستخدام حقلdimensions.
على سبيل المثال، سيؤدي "platform": "facebook" إلى تعيين أبعاد الصورة إلى عرض 1200 بكسل وارتفاع 630 بكسل.
facebook: عرض 1200 بكسل، ارتفاع 630 بكسل.instagram: عرض 1080 بكسل، ارتفاع 1080 بكسل.instagram_landscape: عرض 1080 بكسل، ارتفاع 680 بكسل.instagram_portrait: عرض 1080 بكسل، ارتفاع 1920 بكسل.instagram_special: عرض 1080 بكسل، ارتفاع 800 بكسل.linkedin: عرض 1200 بكسل، ارتفاع 627 بكسل.pinterest: عرض 1080 بكسل، ارتفاع 1920 بكسل.tiktok: عرض 1080 بكسل، ارتفاع 1920 بكسل.twitter: عرض 1600 بكسل، ارتفاع 900 بكسل.
mode مضبوطًا على crop مع حقول dimensions وxCoordinate وyCoordinate.
الوضع
Resize
Resize هو الوضع الافتراضي الذي سيُغيّر أبعاد الصورة مع الحفاظ على نسبة العرض إلى الارتفاع. غيّر حجم الصورة إلى الأبعاد المحددة دون اقتطاع أي محتوى. مثال JSON:Resize
dimensions:
Resize مع أبعاد
platform أو حقلي الأبعاد width وheight.
Crop
سيقتطع Crop الصورة إلى الأبعاد المحددة. افتراضيًا، سيكون إحداثي المركز هو مركز الصورة. يمكنك أيضًا تحديد إحداثيات x/y الخاصة بك. مثال JSON:Crop
dimensions:
Crop مع أبعاد
platform أو حقلي الأبعاد width وheight.
للاقتطاع المربع، إذا كان width أو height أقل من أبعاد الصورة المُقدَّمة، فستُستخدم القيمة الأصغر من width أو height. على سبيل المثال، إذا كانت الصورة 1200x800 وكان الاقتطاع المطلوب 1080x1080، فستكون الصورة المُعادة 800x800.
Blur
سيُكرر تأثير Blur الصورة كخلفية ويُطبّق تشويشًا (blur) على الصورة. مثال JSON للتشويش:Blur

العلامة المائية
نظرة عامة على العلامة المائية
يمكنك إضافة علامة مائية إلى الصورة بتوفير URL يجب أن يبدأ بـhttps:// وموضع اختياري.
ستظهر العلامة المائية افتراضيًا في الزاوية اليمنى السفلى من الصورة — southeast.
نوصي بصورة PNG ذات خلفية شفافة.
مثال JSON للعلامة المائية:
Watermark

موضع العلامة المائية
يمكن أن يكون موضع العلامة المائية أحد التالي:northnortheasteastsoutheastsouthsouthwestwestnorthwestcenter
خيارات التأثيرات
القيمة الست عشرية للون
قيمة ست عشرية للون خلفية التشويش. تنطبق فقط إذا كان"mode": "blur". قيمة سلسلة، على سبيل المثال "#A020F0"
مثال JSON لخلفية ملونة:
خلفية ملونة

اللون: تدرج رمادي، Sepia، عكس (Invert)
يمكنك تغيير اللون الأساسي للصورة بتحديدgrayscale أو sepia أو invert. الحقل "blur": true غير مطلوب ولا ينبغي استخدامه إذا لم ترغب في وجود خلفية.
مثال JSON لتدرج رمادي:
Grayscale

الشفافية
اضبط شفافية الصورة. مدى القيمة الرقمية: 0 - 1. مثال JSON للشفافية:Opacity
الجودة
بالنسبة لصور JPG أو JPEG، حدّد جودة الصورة، أو مقدار الضغط. كلما انخفض الرقم زاد الضغط لكن قلّت جودة الصورة. كلما زاد الرقم قلّ الضغط لكن زادت جودة الصورة. مدى القيمة الرقمية: 0 - 100. مثال JSON للجودة:Quality
التحويل إلى JPG أو WebP
يتيح لك الخيارانconvertToJpg وconvertToWebP تحويل الصور من صيغتها الأصلية (مثل PNG) إلى صيغة JPG أو WebP على التوالي.
افتراضيًا، ستكون للصور المحوَّلة إعدادات جودة 75%.
يمكنك تخصيص مستوى الضغط باستخدام معامل quality في كائن التأثيرات.
لاحظ أنه إذا كانت الصورة المصدر بالفعل بصيغة JPG واستخدمت convertToJpg، فسيقوم API ببساطة بتغيير حجم الصورة إلى الأبعاد التي حددتها دون تغيير الصيغة.
مثال التحويل إلى JPG:
Convert to JPG
Convert to WebP
