ForHosting KIT · الصوت والكلام: تفريغ ونطق

حساب الطوابع الزمنية لإعلانات البودكاست

حوّل مدة حلقة البودكاست وثلاثة مواضع إعلانية محددة بالنسب المئوية إلى طوابع زمنية دقيقة وجاهزة للإنتاج.

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

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

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

حوّل نسب الحملة إلى أوقات جاهزة للتحرير

تحدد الخطط الإعلانية للبودكاست المواضع بالنسب المئوية في كثير من الأحيان، لأن الموضع النسبي ينتقل بسهولة بين حلقات تختلف مدتها. يسهل توحيد توجيه مثل «ضع إعلان المنتصف عند 50 بالمئة»، لكن المحرر أو نظام النشر يظل بحاجة إلى رمز زمني دقيق. تضرب هذه الحاسبة مدة الحلقة في كل نسبة مطلوبة، ثم تعيد الإزاحة الناتجة بالثواني مع طابع زمني مقروء بصيغة HH:MM:SS.mmm. أدخل المدة الكاملة بالثواني، ثم نسبة لكل من إعلان البداية والمنتصف والنهاية. في حلقة مدتها 3,600 ثانية، تصبح نسبة 2.5 بالمئة 90 ثانية، ونسبة 50 بالمئة 1,800 ثانية، ونسبة 97.5 بالمئة 3,510 ثوانٍ. تربط النتائج المسماة كل موضع بوظيفته الصحيحة، مما يقلل احتمال نسخ القيمة إلى حقل غير مناسب. وبما أن العملية الحسابية حتمية في كل مرة، تصلح المخرجات لملاحظات الإنتاج وبيانات الإدراج وجداول الموافقة ومسارات العمل الآلية التي تحتاج إلى علامات إعلانية متسقة في كامل فهرس الحلقات.

افهم الدقة والحدود والتحقق من المدخلات

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

استخدم النتائج في سير إنتاج البودكاست

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

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

إعداد ورقة إدراج الإعلانات

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

توحيد المواضع عبر سلسلة كاملة

طبّق السياسة النسبية نفسها لإعلانات البداية والمنتصف والنهاية على حلقات تختلف مدتها النهائية كل أسبوع.

تغذية مسار نشر آلي

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

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

ما تكلفة استخدام الحاسبة عبر API؟

يكلف كل طلب API مقدار $0.002. ويمكنك أيضاً إجراء الحساب في المتصفح باستخدام المنطق الحتمي نفسه.

ما الوحدة المطلوبة لمدة الحلقة؟

أدخل المدة الكاملة بالثواني. ويمكن استخدام أجزاء من الثانية إذا كان المصدر يوفر دقة أقل من ثانية واحدة.

هل يمكن أن تكون النسبة 0 أو 100 تماماً؟

نعم. تشير 0 إلى بداية الحلقة، بينما تشير 100 إلى لحظة نهايتها بدقة.

ماذا يحدث إذا خرجت النسبة عن النطاق المسموح؟

يعيد الطلب خطأ مدخلات غير صالحة يحدد حقل النسبة المعني. ولا تُقص القيم أو تعدل لتدخل في النطاق.

ما دقة الطوابع الزمنية الناتجة؟

تحتفظ الإزاحات الرقمية بما يصل إلى ست خانات عشرية، ويُقرب الرمز الزمني المقروء إلى أقرب جزء من ألف من الثانية.

هل تحلل الأداة صوت البودكاست أو ترفعه؟

لا. تستخدم الأداة المدة والنسب التي تقدمها فقط، ولا تستقبل ملفاً صوتياً أو تحلله أو تخزنه.

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/audio/podcast-ad-slot-timing

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

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

curl -X POST https://api.kit.forhosting.com/audio/podcast-ad-slot-timing \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"duration_seconds":3600,"pre_roll_percent":2.5,"mid_roll_percent":50,"post_roll_percent":97.5}'

const res = await fetch("https://api.kit.forhosting.com/audio/podcast-ad-slot-timing", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "duration_seconds": 3600,
    "pre_roll_percent": 2.5,
    "mid_roll_percent": 50,
    "post_roll_percent": 97.5
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/audio/podcast-ad-slot-timing",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "duration_seconds": 3600,
    "pre_roll_percent": 2.5,
    "mid_roll_percent": 50,
    "post_roll_percent": 97.5
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/audio/podcast-ad-slot-timing", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"duration_seconds":3600,"pre_roll_percent":2.5,"mid_roll_percent":50,"post_roll_percent":97.5}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"duration_seconds":3600,"pre_roll_percent":2.5,"mid_roll_percent":50,"post_roll_percent":97.5}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/audio/podcast-ad-slot-timing", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "duration_seconds": 3600,
  "pre_roll_percent": 2.5,
  "mid_roll_percent": 50,
  "post_roll_percent": 97.5
}

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

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

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

الأسعار

لكل طلب$0.002

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

الحدود

`max_mb`	200
`max_minutes`	180

الأخطاء

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

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