أدلة API

الصوت المباشر عبر API

اختر Socket.IO أو البث عبر HTTP لإرسال الصوت المباشر إلى HUMAIN Voice للنسخ الفوري أو تمييز المتحدثين المباشر.

تقبل وسيلتا النقل ترويسة الإطار نفسها ذات 18 بايت وصوت PCM16 little-endian بتردد 16 kHz وأحادي القناة، وتعيدان حقول النتائج نفسها. للمقطع المكتمل، استخدم النسخ الدفعي أو السريع بدلًا منهما.

Socket.IO أم البث عبر HTTP

Socket.IOالبث عبر HTTP
الاتصالWebSocket واحد يحمل كل التدفقات.طلب POST واحد لكل إطار إلى stt-stream أو diarization-stream، وطلب واحد قيد التنفيذ لكل UUID تدفق.
التأطير3,200 بايت (100 ms) لكل إطار بوتيرة الزمن الحقيقي.نحو 32,000 بايت (1 s) لكل POST؛ ضع الصوت في طابور أثناء انتظار POST.
النتائجحدثا transcription_result وdiarization_result على الاتصال المرسل، موجهان حسب id.NDJSON في استجابة كل POST، فتصل التحديثات على الاستجابات المفتوحة فقط (مرة كل إطار مدته 1 s تقريبًا). تبقى الاستجابة الأخيرة مفتوحة حتى is_final: true.
النص والمتحدثون معًاتفرع التمييز: اضبط البت 2 في كل إطار audio_stream.لا تفرع. شغّل stt-stream وdiarization-stream على الصوت نفسه ووفّق بينهما حسب الزمن.
الحدودالتدفق الذي يتوقف عن إرسال الصوت ينتهي بالخطأ ASR_STREAM_EXPIRED.لجلسات HTTP وتدفقات ASR مهل منفصلة؛ راجع المهل.
SDKJavaScript وPython؛ ولا يعرض SDK 0.18.1 التفرع.لا يوجد.
اختره عندماتستخدم SDK أو تحتاج إلى التفرع.لا تستطيع بيئة التشغيل إبقاء WebSocket مفتوحًا.

تخطيطات الإطارات وقيم العلامات: إطارات Socket.IO وإطارات HTTP.

دورة حياة الجلسة

  • البدء. أنشئ UUID جديدًا واضبط بت البدء في الإطار الأول. في HTTP، يفتح أول POST الجلسة (البث عبر HTTP).
  • الإرسال. أرسل الإطارات بالترتيب فور وصول الصوت، وطبّق كل نتيجة بوصفها الحالة الراهنة لـid الخاص بها (نتائج التدفق).
  • الإنهاء. اضبط بت النهاية في آخر إطار صوت، ثم واصل القراءة حتى is_final: true أو حتى موعدك النهائي (النسخ الفوري). مع التفرع، انتظر النتيجتين النهائيتين.
  • التعافي. تُبقي الجلسة حية على وسيلتي النقل عند تقييد SESSION_BYTE_RATE_EXCEEDED: انتظر ثم أعد إرسال الإطار نفسه. أي فشل آخر أو انقطاع أو POST ملغى ينهي التدفق: احتفظ بالنتائج المثبتة، وأسقط المؤقتة، وابدأ تدفقًا جديدًا بـUUID جديد (إعادة المحاولة بأمان، انقطاعات Socket.IO).

حدود الجلسة ومهل الخادم: حدود النسخ، وحدود التمييز، والمهل.

الخطوات التالية

في هذه الصفحة