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

نسّق فصول البودكاست بعلامات HH:MM:SS

حوّلوا قائمة عناوين فصول البودكاست وأوقات البدء إلى علامات فصول موحّدة وجاهزة للنسخ. أدخلوا بداية كل فصل في صورة عدد صحيح من الثواني، فيحوّلها المنسّق إلى HH:MM:SS متبوعة بالعنوان. ويتحقق كذلك من أن كل فصل يبدأ بعد سابقه، فيكشف الأوقات المكررة أو غير المرتبة قبل وصولها إلى ملاحظات الحلقة أو لوحة الاستضافة أو تسليم الإنتاج أو مسار النشر.

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

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

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

جهّزوا العناوين وأوقات البدء

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

افهموا التنسيق والتحقق من الترتيب

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

انشروا العلامات وأتمتوا استخدامها

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

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

إعداد وصف الحلقة

حوّلوا ورقة الفصول المعتمدة تحريرياً إلى علامات موحّدة يمكن لصقها في الملاحظات أو نموذج النشر.

مراجعة تسليم الإنتاج

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

توحيد مسار مؤتمت

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

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

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

يمكنكم تشغيل الأداة مجاناً في المتصفح على هذه الصفحة. تبلغ تكلفة كل مطالبة API مقدار $0.002.

ما النسق الذي تنتجه؟

يأتي كل سطر بالصيغة HH:MM:SS - العنوان، مع عرض الساعات والدقائق والثواني برقمين على الأقل.

هل يمكن أن يبدأ فصلان في الوقت نفسه؟

لا. يجب أن تتزايد أوقات البدء تزايداً صارماً، بحيث يبدأ كل فصل بعد الفصل السابق.

هل يجب أن يبدأ الفصل الأول عند الصفر؟

لا. يقبل المنسّق أي بداية غير سالبة، مع احتمال أن تفرض خدمة استضافة معينة قاعدة نشر خاصة بها.

هل يمكن إدخال أجزاء عشرية من الثانية؟

لا. يجب أن تكون أوقات البدء ثواني صحيحة لتجنب التقريب الخفي والحفاظ على ناتج لا لبس فيه.

هل تتغير عناوين الفصول؟

تُحذف المسافات الخارجية فقط، وتبقى صياغة العنوان كما هي. أما العناوين التي تتضمن فواصل أسطر فتُرفض.

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/audio/podcast-chapter-timestamps

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

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

curl -X POST https://api.kit.forhosting.com/audio/podcast-chapter-timestamps \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"chapters":[{"title":"Welcome","start_time":0},{"title":"The main interview","start_time":95},{"title":"Listener questions","start_time":3725}]}'

const res = await fetch("https://api.kit.forhosting.com/audio/podcast-chapter-timestamps", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "chapters": [
      {
        "title": "Welcome",
        "start_time": 0
      },
      {
        "title": "The main interview",
        "start_time": 95
      },
      {
        "title": "Listener questions",
        "start_time": 3725
      }
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/audio/podcast-chapter-timestamps",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "chapters": [
        {
            "title": "Welcome",
            "start_time": 0
        },
        {
            "title": "The main interview",
            "start_time": 95
        },
        {
            "title": "Listener questions",
            "start_time": 3725
        }
    ]
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/audio/podcast-chapter-timestamps", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"chapters":[{"title":"Welcome","start_time":0},{"title":"The main interview","start_time":95},{"title":"Listener questions","start_time":3725}]}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"chapters":[{"title":"Welcome","start_time":0},{"title":"The main interview","start_time":95},{"title":"Listener questions","start_time":3725}]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/audio/podcast-chapter-timestamps", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "chapters": [
    {
      "title": "Welcome",
      "start_time": 0
    },
    {
      "title": "The main interview",
      "start_time": 95
    },
    {
      "title": "Listener questions",
      "start_time": 3725
    }
  ]
}

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

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

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

الأسعار

لكل طلب$0.002

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

الحدود

`max_chapters`	500
`max_start_time`	359999999

الأخطاء

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

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