مقدمة
اختر مسار HUMAIN Voice المناسب، ثم اتبع أقصر طريق إلى تكامل جاهز للإنتاج.
تحوّل HUMAIN Voice التسجيلات الكاملة أو الصوت المباشر إلى نص، وتولّد الكلام من النص. ابدأ هنا لاختيار مسار واحد؛ ويتولى البدء السريع تعليمات التثبيت وأول طلب.
اختر حسب الصوت والنتيجة
| ما لديك أو ما تحتاجه | استخدم | ابدأ هنا |
|---|---|---|
| اجتماع أو بودكاست أو تسجيل طويل كامل آخر | يرفع النسخ الدفعي الملف ويستعلم عن نتيجة نهائية. | البدء السريع |
| وحدة صوت كاملة تحتاج نتيجة حساسة للكمون، مثل دور محادثة واحد لوكيل | يرسل النسخ السريع الصوت كاملاً عبر Socket.IO. وهو ليس بثًا مباشرًا للميكروفون، وليس مسار التسجيلات الطويلة أو البودكاست. | دليل SDK |
| صوت لا يزال ينتجه ميكروفون أو مكالمة أو خط وسائط | يبث النسخ الفوري PCM16 ويعيد نتائج مؤقتة ونهائية. | البدء السريع |
| نص يجب تحويله إلى كلام قابل للتشغيل | يعيد تحويل النص إلى كلام PCM16؛ وتكتب الوصفة حاوية WAV. | وصفة TTS إلى WAV |
| وقت تشغيل بلا SDK منشور، أو تحكم على مستوى البروتوكول | تستخدم API المباشرة REST أو بث HTTP أو Socket.IO من خلفية موثوقة. | أدلة API |
إذا كان الصوت موجودًا بالفعل ولم تكن متأكدًا، فاختر Batch. اختر Realtime فقط عندما يجب وصول النتائج بينما لا يزال الصوت يُنتج.
قبل أن تبدأ
- تستهدف هذه الوثائق SDK JavaScript وPython بالإصدار
0.18.0. - احصل على
API_KEYعبر مسار الوصول في مؤسستك. يعرض هذا الموقعAPI_URLالمهيأ لبيئته. - يستخدم عملاء Socket.IO المسار
/socket.ioافتراضيًا؛ مرّرAPI_PATHفقط عندما يستخدم النشر مسارًا مخصصًا. وتتطلب نقطة النهاية القديمةsautech.humain.comالمسار/realtime/socket.io. احتفظ بمفتاح API في بيئة خادم موثوقة.
يغطي البدء السريع التثبيت بإصدار مثبت، وإعداد الصوت، ومتغيرات البيئة، وأول طلبي Batch وRealtime مختبرين.
من أول طلب إلى الإنتاج
- أكمل البدء السريع لـBatch أو Realtime.
- استخدم دليل SDK الخاص باللغة، أو استخدم أدلة API لتكامل مباشر.
- أضف تسميات المتحدثين أو الترجمات أو خرج TTS قابلاً للتشغيل من الوصفات.
- تعامل مع الأخطاء المنظمة والمهل وإعادة المحاولة المحدودة عبر الأخطاء وحدود المعدل.
نفّذ أول طلب
ثبت SDK 0.18.0 وأكمل مسار Batch أو Realtime مختبرًا.
اختر عميل SDK
راجع كل عميل وخيار ومهلة واستجابة وقاعدة دورة حياة منشورة.
افحص عقود API
استخدم مخططات HTTP المتحقق منها وتوثيق العمليات المولد.
الوصول القابل للقراءة آليًا
- يسرد
/llms.txtنقاط دخول الوثائق؛ ويحتوي/llms-full.txtحزمة Markdown الكاملة. - تستخدم صفحات Markdown السردية
/ar/md/<slug>، مثل/ar/md/quickstart. - تستخدم صفحات مرجع API المولدة
/ar/api-reference/md/<slug>.