حزم 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/sdk | npm install @humain-voice/[email protected] | Node.js أو Bun (ES2021) |
| Python | humain-voice (الاستيراد humain_voice) | python -m pip install humain-voice==0.18.1 | Python 3.10 أو أحدث |
| المتصفح (Voice Agent) | @humain-voice/agent | npm install @humain-voice/[email protected] livekit-client | المتصفحات الحديثة |
| Go | قريبًا |
العملاء حسب سير العمل
لكل سير عمل عميله الخاص. لاختيار سير العمل، راجع المفاهيم.
| سير العمل | صنف JavaScript | صنف Python |
|---|---|---|
| النسخ الدفعي | BatchTranscribeClient | stt.BatchTranscribeClient |
| النسخ السريع | FastTranscriptionClient | stt.FastTranscriptionClient |
| النسخ الفوري | RealtimeClient | stt.RealtimeClient |
| التمييز المباشر | RealtimeDiarizationClient | stt.RealtimeDiarizationClient |
| تحويل النص إلى كلام | TTSClient | tts.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، تراجع وأعد المحاولة. راجع رموز الأخطاء.