حزم SDK

نظرة عامة على SDK

اختر حزمة SDK من HUMAIN Voice للغة خادمك، وثبّتها، وتعرّف على العميل الخاص بكل سير عمل.

تغلّف حزمتا SDK لـ JavaScript وPython واجهة REST للنسخ الدفعي وSocket.IO. للبث عبر HTTP، استدعِ واجهة البث عبر HTTP مباشرة. ولنداء تحويل نص إلى كلام متوافق مع OpenAI (POST /v1/audio/speech)، راجع دليل الكلام المتوافق مع OpenAI (على voice-dev اليوم).

حزم SDK المتاحة

اللغةالحزمةالتثبيتبيئة التشغيل
JavaScript وTypeScript@humain-voice/sdknpm install @humain-voice/[email protected]Node.js أو Bun (ES2021)
Pythonhumain-voice (الاستيراد humain_voice)python -m pip install humain-voice==0.18.1Python 3.10 أو أحدث
المتصفح (Voice Agent)@humain-voice/agentnpm install @humain-voice/[email protected] livekit-clientالمتصفحات الحديثة
Goقريبًا

العملاء حسب سير العمل

لكل سير عمل عميله الخاص. لاختيار سير العمل، راجع المفاهيم.

سير العملصنف JavaScriptصنف Python
النسخ الدفعيBatchTranscribeClientstt.BatchTranscribeClient
النسخ السريعFastTranscriptionClientstt.FastTranscriptionClient
النسخ الفوريRealtimeClientstt.RealtimeClient
التمييز المباشرRealtimeDiarizationClientstt.RealtimeDiarizationClient
تحويل النص إلى كلامTTSClienttts.TTSClient
جلسات Voice Agent (تجريبي)AgentClient (من @humain-voice/sdk/agent، الإصدار 0.19.0-beta.1 أو أحدث)agent.AgentClient (الإصدار 0.19.0b2 أو أحدث)

السلوك المشترك

  • شغّل كل SDK على خادم، واحتفظ بمفتاح API هناك. إعدادات الاتصال في المصادقة.
  • أنشئ العميل، واستخدمه، ثم أغلقه: finally في JavaScript، وasync with في Python.
  • تحمل الأخطاء الحقلين code وretryable من ErrorResponse. تفرّع على code، لا على نص الرسالة أبدًا.
  • عند TTS_INPUT_NOT_ALLOWED، غيّر النص قبل إعادة المحاولة. عند TTS_MODERATION_UNAVAILABLE، تراجع وأعد المحاولة. راجع رموز الأخطاء.

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

في هذه الصفحة