ForHosting KIT · الفيديو

احسب توقيتات متساوية للصور المصغرة للفيديو

يمكنكم تخطيط مجموعة واضحة من صور المعاينة قبل فك ترميز أي إطار من الفيديو. أدخلوا مدة الفيديو وعدد الصور المصغرة المطلوب، فتحسب الأداة توقيتات حتمية ومتساوية التباعد بوحدة الثانية.

● Betaمجاني · داخل متصفحك
استخدمها من الويبAPIالبريدTelegramالتطبيق قريبًا

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

اختاروا نقاطاً ممثلة بعيداً عن طرفي الفيديو

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

تعرفوا إلى طريقة الحساب وحدودها

يستخدم الإدخال وحدة الثانية ويقبل مدد الفيديو الكسرية، وهذا مهم لأن بيانات الوسائط الوصفية نادراً ما تنتهي عند ثانية صحيحة. عند طلب عدة صور، يساوي الفاصل المدة الصالحة —أي المدة الكلية ناقص ثانيتين— مقسومة على العدد المطلوب ناقص واحد. ويُحسب كل توقيت بإضافة الفاصل مضروباً في موضعه الذي يبدأ من الصفر إلى أول ثانية آمنة. تُقرب النتائج إلى ست منازل عشرية كحد أقصى للمحافظة على ثبات خرج JSON مع إبقاء دقة ما دون الثانية اللازمة عادة لاستخراج المعاينات. يجب أن تزيد المدة على ثانيتين، لأن المقطع الأقصر لا يترك مجالاً يستبعد الثانية الأولى والأخيرة معاً. كما يجب أن يكون العدد صحيحاً ولا يقل عن واحد؛ فالعدد صفر أو السالب لا يصنع خطة ذات معنى ويؤدي إلى خطأ في الإدخال. وتمنع الحدود العليا إنشاء مصفوفات ضخمة بلا حاجة. تحسب الأداة المواضع فقط، ولا تفحص الإطارات أو تكتشف المشاهد أو تحدد إطارات المفتاح أو تضمن انتقال مفكك الترميز إلى الجزء المطلوب من الثانية بدقة تامة.

استخدموا التوقيتات ضمن سير عمل الصور المصغرة

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

إنشاء شريط معاينة للمشغل

أنشئوا مواضع متوقعة للصور التي تظهر عندما ينتقل المشاهد عبر الشريط الزمني للفيديو.

تخطيط لوحة قصصية للفيديو

أنشئوا لوحة صور مأخوذة بانتظام من دون اختيار الإطارات السوداء في البداية أو شاشات النهاية.

جدولة استخراج الإطارات دفعة واحدة

مرروا مصفوفة ثابتة من التوقيتات إلى مهمة FFmpeg أو عامل وسائط أو مسار معالجة الملفات المرفوعة.

ما التكلفة؟

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

لماذا تُستبعد الثانية الأولى والأخيرة؟

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

ماذا يحدث عند طلب صورة مصغرة واحدة؟

تعيد الحاسبة منتصف الفيديو، وهو يقع داخل النافذة الآمنة لكل مدة تقبلها الأداة.

هل تستخرج هذه الأداة الصور المصغرة؟

لا، فهي تعيد التوقيتات فقط. استخدموا النتيجة مع مفكك ترميز فيديو أو أداة لاستخراج الإطارات.

هل تدعم الأداة كسور الثانية؟

نعم. يمكن أن تتضمن المدة والتوقيتات كسوراً، ويُقرب الخرج إلى ست منازل عشرية كحد أقصى.

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

POSThttps://api.kit.forhosting.com/video/thumbnail-timestamps

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

curl -X POST https://api.kit.forhosting.com/video/thumbnail-timestamps \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"duration_seconds":120,"count":5}'
{
  "duration_seconds": 120,
  "count": 5
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "video.thumbnail_timestamps",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

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

لكل طلب$0.002

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

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

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