ساحة التجربة

التفريغ النصي فورًا أو عبر قائمة الانتظار

ما تفعله صفحة تحويل الكلام إلى نص خلف كل حالة في سطر الحالة، وكم تنتظر، وما يحدث عندما تغادر الصفحة، ومتى يجيب API في استدعاء واحد بدلًا من ذلك.

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

كل تفريغ نصي من الصفحة هو مهمة

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

سطر الحالة ما يحدث هل خُصم الرصيد؟
جارٍ تجهيز الصوت…، مع شريط متحرك يحوّل المتصفح ملف MP3 أو M4A أو AAC أو WEBM إلى WAV قبل إرساله. أما الملفات الأخرى فتتجاوز هذه الحالة. لا
جارٍ الرفع…، مع نسبة مئوية يرسل المتصفح الملف. لا
جارٍ التحويل…، يتبعه اسم الملف وصل الملف. وبعد أن يجتاز الفحوص التي تجري بعد الرفع، يُخصم الرصيد ويُنتَج النص المفرّغ. نعم، بعد اجتياز الفحوص

الصفحة لا تقدّم تقديرًا للوقت. المقطع القصير يعود غالبًا خلال ثوانٍ، أما الملف الذي تبلغ مدته ساعة فلا.

ويتيح API الشكل الآخر أيضًا: يعيد POST /v1/speech-to-text/sync النص المفرّغ في الاستجابة نفسها للملفات التي لا تتجاوز 10 دقائق، ويعمل POST /v1/speech-to-text مثل الصفحة، فيقبل الملفات نفسها ويتيح لك الاستعلام الدوري أو استقبال Webhook. وتستخدم الصفحة الشكل الثاني دائمًا. راجع الاستدعاءات المتزامنة وغير المتزامنة لتختار بينهما في الكود.

كم تنتظر الصفحة

تنتظر الصفحة النص المفرّغ مدة تصل إلى 65 دقيقة من لحظة قبول الملف. لكن المهمة التي لم تُنتج شيئًا تُغلق قبل ذلك بوقت طويل:

  • التفريغ النصي الذي يظل يعمل بعد 10 دقائق من قبول الملف يُعلَّم فاشلًا خلال 5 دقائق بعدها، أي بعد 15 دقيقة من القبول على الأكثر.
  • يعرض سطر الحالة عندها السبب Job timed out — AI server did not respond، متبوعًا برمز خطأ بين قوسين مربعين، ويظهر زر حاول مرة أخرى بجانب زر تحويل إلى نص.
  • يُستردّ الرصيد الذي خُصم لتلك المهمة.

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

وإذا بلغت الصفحة حدّها الخاص البالغ 65 دقيقة أولًا، يعرض سطر الحالة السبب Timeout has occurred. وتكون المهمة التي كانت تنتظرها قد أُغلقت قبل ذلك.

مغادرة الصفحة

أثناء رفع الملف أو تحويله، تبقى منطقة الرفع وتسجيل وزر تحويل إلى نص مقفلة. تبقى الصفحة مفتوحة، فتستطيع قراءة نص مفرّغ سابق من النصوص على اليمين أثناء الانتظار. وعندما يصل النص المفرّغ يظهر على بطاقة النص.

أما مغادرة الصفحة أو إعادة تحميلها فأمر مختلف. تستمر المهمة في العمل ويبقى رصيدها مخصومًا، لكن الصفحة لا تعود تنتظرها: يذهب النص المفرّغ إلى المكتبة، وتبدأ صفحة كلام إلى نص ببطاقة نص فارغة في زيارتك التالية. لتحتفظ بالنص المفرّغ على الصفحة، ابقَ فيها حتى تظهر البطاقة النص المفرّغ.

مثال تطبيقي

تسحب محاضرة مدتها 40 دقيقة بصيغة MP3 وتُفلتها في الصفحة عند الساعة 10:00 وتضغط تحويل إلى نص. يعرض سطر الحالة جارٍ تجهيز الصوت… لحظة بينما يحوّل المتصفح الملف، ثم تنتقل النسبة في جارٍ الرفع… إلى 100%، وعند 10:01 يتحول إلى جارٍ التحويل… مع اسم الملف. تفتح نصًا مفرّغًا سابقًا من النصوص وتقرأه على البطاقة أثناء الانتظار.

إذا جهز النص المفرّغ عند 10:07، يظهر على بطاقة النص، ويتحدّث عدّاد الرصيد في الشريط الجانبي. وإذا لم يصل شيء حتى 10:11، تُعلَّم المهمة فاشلة عند 10:16 على الأكثر، ويعرض سطر الحالة Job timed out — AI server did not respond، ويُستردّ الرصيد المخصوم. قسّم المحاضرة إلى ملفين وفرّغ كل واحد منهما.

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

هل يُفرَّغ المقطع القصير فورًا؟

يُفرَّغ بسرعة، لكنه يمر بالمسار نفسه الذي يمر به الملف الطويل: القبول ثم الانتظار. ولا يعيد النص المفرّغ في استدعاء واحد إلا POST /v1/speech-to-text/sync في API.

هل أستطيع رفع ملف ثانٍ بينما الأول ما زال قيد المعالجة؟

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

هل يُخصم الرصيد وأنا أنتظر؟

يُخصم الرصيد بعد وصول الملف واجتيازه الفحوص التي تجري بعد الرفع، في بداية حالة جارٍ التحويل…. ويُستردّ إذا فشلت المهمة، بما في ذلك انتهاء مهلتها.

ماذا لو أغلقت علامة التبويب في المتصفح؟

تكتمل المهمة وحدها، ويُحفظ النص المفرّغ في المكتبة. ولا يُخصم الرصيد مرتين.

هل أستطيع أن أعرف إلى أين وصل التفريغ النصي؟

لا. لسطر الحالة الحالات المذكورة أعلاه، ولا تظهر نسبة إلا أثناء الرفع. ويصل النص المفرّغ كاملًا دفعة واحدة.