أدلة 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 مهل منفصلة؛ راجع المهل. |
| SDK | JavaScript و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).
حدود الجلسة ومهل الخادم: حدود النسخ، وحدود التمييز، والمهل.