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

معاملات الترويسة

معاملات الجسم

imageUrl
string
مطلوب
عنوان URL للصورة المراد تغيير حجمها. يجب أن يبدأ بـ https://
platform
array
مطلوب
منصة الوسائط الاجتماعية التي سيُغيَّر حجم الـ URL لها. راجع خيارات المنصة للتفاصيل.
file
object
أرسل ملف الوسائط كائن نموذج multipart form-data. مطلوب إذا لم يكن imageUrl موجودًا.
watermark
object
عنوان URL وموضع اختياري للعلامة المائية التي ستُطبَّق على الصورة بعد تغيير حجمها. ستظهر العلامة المائية افتراضيًا في الزاوية اليمنى السفلى للصورة. راجع العلامة المائية للتفاصيل.
effects
string
غيّر الشفافية والألوان وما إلى ذلك. راجع خيارات التأثيرات للتفاصيل.
dimensions
object
كائن يحدد width وheight لتغيير الحجم. في حال الاقتطاع، يمكنك اختياريًا تحديد إحداثيات x وy للمركز. الافتراضي هو مركز الصورة.
الأبعاد
العرض والارتفاع مطلوبان إذا لم تُحدَّد المنصة.
mode
string
افتراضي:"resize"
القيمة: resize أو blur أو crop. راجع الوضع للتفاصيل.
convertToJpg
boolean
يحول تلقائيًا إلى ملف JPG، مثلًا من PNG إلى JPG. سيُستخدم مستوى جودة 75%. راجع التحويل إلى JPG للتفاصيل.
convertToWebP
boolean
يحول تلقائيًا إلى ملف 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
مثال صورة مع تشويش: Background with Blur

العلامة المائية

نظرة عامة على العلامة المائية

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

موضع العلامة المائية

يمكن أن يكون موضع العلامة المائية أحد التالي:
  • north
  • northeast
  • east
  • southeast
  • south
  • southwest
  • west
  • northwest
  • center

خيارات التأثيرات

القيمة الست عشرية للون

قيمة ست عشرية للون خلفية التشويش. تنطبق فقط إذا كان "mode": "blur". قيمة سلسلة، على سبيل المثال "#A020F0" مثال JSON لخلفية ملونة:
خلفية ملونة
مثال صورة بخلفية ملونة: Add Colored Background

اللون: تدرج رمادي، Sepia، عكس (Invert)

يمكنك تغيير اللون الأساسي للصورة بتحديد grayscale أو sepia أو invert. الحقل "blur": true غير مطلوب ولا ينبغي استخدامه إذا لم ترغب في وجود خلفية. مثال JSON لتدرج رمادي:
Grayscale
مثال صورة بتدرج رمادي: Add 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
مثال التحويل إلى WebP:
Convert to WebP