ForHosting KIT · الفيديو

تحققوا من توافق أبعاد الفيديو مع متطلبات المنصة

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

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

شغّل الأداة مجانًا اطّلع على الـAPI

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

وتوضح لكم هل تتطابق الأبعاد، أم أن المصدر الأضيق يحتاج إلى أشرطة جانبية، أم أن جانبي المصدر الأعرض سيتعرضان للقص. لا يجري رفع الفيديو أو فك ترميزه؛ أدخلوا النسبة والمنصة وموضع النشر لتحصلوا على نتيجة حتمية تصلح للتخطيط والتحقق ومسارات النشر الآلي.

اختاروا وجهة النشر قبل الحكم على المصدر

يرتبط توافق نسبة الأبعاد بموضع النشر، لا باسم المنصة وحده. يستخدم فيديو YouTube المعتاد إطاراً أفقياً، بينما يستخدم YouTube Shorts إطاراً عمودياً. ويفصل Instagram كذلك بين منشور الصورة الرأسية والمنشور المربع وReels وStories. اختاروا التركيبة الدقيقة التي تمثل مكان ظهور المادة، ثم أدخلوا نسبة الفيديو المعروضة بصيغة العرض:الارتفاع، مثل 16:9 أو 9:16 أو 4:5 أو 1:1. وتُقبل القيم العشرية للأنماط الأقل شيوعاً. توحد الأداة اسمي المنصة والموضع بالأحرف الصغيرة، ثم تبحث عن الإطار المعلن وتقارن النسبتين رقمياً. وهي لا تفحص اسم الملف أو الدقة أو وسم التدوير أو تدفق الوسائط المرمز. إذا احتوى تسجيل الهاتف على بيانات وصفية للاتجاه، فحددوا الأبعاد بعد تطبيق التدوير وأرسلوا نسبة العرض الفعلية. تُرفض التركيبات غير المدعومة بوضوح، ولذلك لا يستطيع المسار الآلي تطبيق قاعدة منشور على قصة بالخطأ أو استعارة معيار منصة أخرى.

افهموا نتائج التطابق والأشرطة والقص

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

نفذوا الفحص قبل النشر وتحويل الترميز

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

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

تحققوا من المواد قبل جدولة النشر

ضعوا علامة على المقاس غير المتوافق قبل أن ترسل قائمة النشر الفيديو إلى الموضع المختار.

اختاروا النسخة الأصلية الملائمة

قارنوا المصدر بالوجهة ووجهوا المهمة إلى نسخة أفقية أو مربعة أو رأسية ملائمة.

أنشئوا قاعدة للمراجعة التحريرية

أرسلوا نتائج القص لفحص الحواف ونتائج الأشرطة لاختيار الخلفية أو التكوين المناسب.

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

ماذا تعني نتيجة التطابق؟

تعني أن النسبة المقدمة لها الشكل الرقمي نفسه للمتطلب المخزن لهذه المنصة وموضع النشر.

لماذا تشير الأداة إلى وجود أشرطة؟

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

ماذا يعني القص في هذه النتيجة؟

يعني أن المصدر أعرض من الوجهة، ولذلك سيزيل الملء المركزي جزءاً من الجانبين الأيمن والأيسر.

هل ترفع الأداة الفيديو أو تعدله؟

لا. فهي تقارن النسب فقط، ولا تستقبل الوسائط أو تفك ترميزها أو تخزنها أو تغير حجمها أو تقصها أو تحولها.

ما تكلفة الفحص عبر API؟

تبلغ تكلفة كل طلب API ‏$0.002. ولا توجد رسوم متغيرة لمعالجة الوسائط لأن الفيديو لا يُنقل.

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/video/video-aspect-platform-check

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

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

curl -X POST https://api.kit.forhosting.com/video/video-aspect-platform-check \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ratio":"16:9","platform":"youtube","placement":"video"}'

const res = await fetch("https://api.kit.forhosting.com/video/video-aspect-platform-check", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "ratio": "16:9",
    "platform": "youtube",
    "placement": "video"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/video/video-aspect-platform-check",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "ratio": "16:9",
    "platform": "youtube",
    "placement": "video"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/video/video-aspect-platform-check", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"ratio":"16:9","platform":"youtube","placement":"video"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"ratio":"16:9","platform":"youtube","placement":"video"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/video/video-aspect-platform-check", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "ratio": "16:9",
  "platform": "youtube",
  "placement": "video"
}

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

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

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

الأسعار

لكل طلب$0.002

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

الحدود

`max_mb`	500
`max_minutes`	60
`max_megapixels`	3.9

الأخطاء

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

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