ForHosting KIT · تحرير الصور وتحليلها

حساب أحجام الصور المصغرة مع الحفاظ على نسبة الأبعاد

يحوّل مولّد المقاسات هذا أبعاد الصورة الأصلية إلى مجموعة جاهزة من أبعاد الصور المصغرة.

● Betaمجاني · داخل متصفحك

استخدمها من الويبAPIالبريدTelegramالتطبيق قريبًا

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

ابدؤوا بأبعاد الصورة الأصلية والعروض المطلوبة

أدخلوا عرض الصورة الأصلية وارتفاعها بوصفهما عددين صحيحين موجبين مقاسين بالبكسل. بعد ذلك، قدّموا قائمة تحتوي على عرض مستهدف واحد على الأقل. تقبل الحاسبة حتى مئة عرض في الطلب الواحد، وهو عدد يكفي لإعداد مجموعات مفصلة من الصور المتجاوبة، أو إعدادات مسبقة لنظام إدارة المحتوى، أو قوائم أصول للمتاجر، من دون إنشاء مهمة غير محدودة. للترتيب دلالة مهمة؛ فالنتائج تظهر بالترتيب نفسه الذي طلبتموه، وتبقى العروض المكررة مكررة. يسهّل ذلك مطابقة الاستجابة مع قائمة موجودة من نقاط توقف التخطيط أو مهام التصدير. استخدموا أبعاد المصدر الفعلية بالبكسل بدلًا من نسبة مبسطة كلما أمكن. تصف صورة بأبعاد 4032 في 3024 ونسبة 4 إلى 3 الشكل نفسه، لكن الأبعاد الحقيقية تجعل الطلب أوضح وتقلل احتمال عكس العرض والارتفاع. يجب أن تكون جميع الأبعاد أعدادًا صحيحة موجبة. ترفض الأداة الصفر، والقيم السالبة، والكسور العشرية، والسلاسل النصية، والأبعاد الناقصة، والقوائم الفارغة، والقوائم التي تتجاوز الحد المعلن بدل تصحيحها ضمنيًا.

افهموا كيفية حساب ارتفاع كل صورة مصغرة

تضرب الحاسبة كل عرض مستهدف في ارتفاع الصورة الأصلية، ثم تقسم الناتج على عرض الصورة الأصلية. تطبّق هذه العملية معامل قياس واحدًا على المحورين، فتحافظ على نسبة أبعاد المصدر ولا تسمح بتمديد الصورة أو ضغطها. ولأن أبعاد البكسل يجب أن تكون أعدادًا صحيحة، يُقرّب كل ارتفاع محسوب إلى أقرب عدد صحيح وفق قاعدة JavaScript القياسية. على سبيل المثال، ينتج عن مصدر بأبعاد 1920 في 1080 وعرض مطلوب قدره 800 بكسل ارتفاع قدره 450 بكسل. قد تنتج بعض نسب المصدر والعروض المستهدفة ارتفاعات كسرية؛ ويمكن أن يؤدي التقريب إلى فرق ضئيل جدًا في النسبة الظاهرة، وهذا أمر لا مفر منه في الصور النقطية. تتضمن الاستجابة أبعاد المصدر، والنسبة العددية بين العرض والارتفاع، وسجلًا لكل عرض مطلوب. تحسب هذه القدرة الأبعاد فقط؛ فهي لا تنزّل الصورة، ولا تفحصها، ولا تقتصها، ولا تضغطها، ولا تزيد حدتها، ولا تغيّر حجمها فعليًا، كما لا تضمن جودة مقبولة عند تكبير مصدر صغير.

استخدموا النتيجة في مسارات العمل المتجاوبة والآلية

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

حالات الاستخدام

تخطيط مجموعة صور متجاوبة

احسبوا الارتفاع الموافق لكل نقطة توقف قبل إنشاء نسخ الصور المخصصة للسمة srcset.

تحديد إعدادات الصور المصغرة في نظام إدارة المحتوى

حوّلوا نسبة أبعاد الأصل وقائمة العروض التحريرية إلى أبعاد متسقة مكوّنة من أعداد صحيحة من البكسلات.

إعداد مهام تغيير الحجم على دفعات

أنشئوا خطة أبعاد مرتبة تستطيع أداة أخرى تنفيذها من دون تكرار حسابات نسبة الأبعاد.

الأسئلة الشائعة

ما تكلفة الاستخدام؟

تبلغ تكلفة API مقدار $0.002 لكل طلب، ويمكن أيضًا تشغيل الحاسبة في المتصفح.

كيف يُحسب كل ارتفاع؟

يُضرب كل عرض مستهدف في ارتفاع المصدر ويُقسم على عرض المصدر، ثم يُقرّب الناتج إلى أقرب بكسل صحيح.

هل تغيّر هذه الأداة حجم الصورة؟

لا. تعيد الأداة خطة أبعاد فقط، ولا تقرأ بكسلات الصورة أو ترفعها أو تقتصها أو تحولها.

هل يمكن إرسال قائمة عروض فارغة؟

لا. يلزم عرض مستهدف واحد على الأقل، وتؤدي القائمة الفارغة إلى خطأ يفيد بأن الإدخال غير صالح.

هل تُحذف العروض المستهدفة المكررة؟

لا. يُحفظ ترتيب الإدخال والقيم المكررة لكي يطابق كل سجل ناتج القائمة المطلوبة مباشرة.

للمطوّرين — الوصول عبر API

كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.

الـEndpoint

POSThttps://api.kit.forhosting.com/image/thumbnail-set

صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.

استدعِ الخدمة من بيئتك

curl -X POST https://api.kit.forhosting.com/image/thumbnail-set \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"width":1920,"height":1080,"target_widths":[1200,800,320]}'

const res = await fetch("https://api.kit.forhosting.com/image/thumbnail-set", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "width": 1920,
    "height": 1080,
    "target_widths": [
      1200,
      800,
      320
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/image/thumbnail-set",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "width": 1920,
    "height": 1080,
    "target_widths": [
        1200,
        800,
        320
    ]
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/image/thumbnail-set", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"width":1920,"height":1080,"target_widths":[1200,800,320]}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"width":1920,"height":1080,"target_widths":[1200,800,320]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/image/thumbnail-set", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "width": 1920,
  "height": 1080,
  "target_widths": [
    1200,
    800,
    320
  ]
}

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

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "image.thumbnail_set",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.

الأسعار

لكل طلب$0.002

السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.

الحدود

`max_mb`	15
`max_megapixels`	12

الأخطاء

HTTP	الرمز	المعنى
`401`	`unauthorized`	مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك.
`402`	`insufficient_balance`	رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة.
`404`	`unknown_type`	نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب.
`429`	`rate_limited`	تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة.

اطّلع على توثيق KIT الكامل ←