أدلة API

نظرة عامة على API المباشرة

قرر متى تستدعي HUMAIN Voice بلا SDK، واختر واجهة REST للنسخ الدفعي أو البث عبر HTTP أو Socket.IO لكل سير عمل.

متى تستدعي API مباشرة

تغلّف حزم SDK لـJavaScript وPython واجهة REST للنسخ الدفعي وSocket.IO. استدعِ API بنفسك عندما:

  • لا تتوفر حزمة SDK للغتك؛
  • لا تستطيع بيئة التشغيل إبقاء WebSocket مفتوحًا، فتحتاج إلى مسارات البث عبر HTTP التي لا تستدعيها أي حزمة SDK؛
  • تحتاج إلى ميزة في البروتوكول لا تعرضها حزم SDK، مثل تفرع التمييز في Socket.IO الذي يعيد النص والمتحدثين المباشرين من تدفق واحد.

تصادق كل وسيلة نقل بـx-api-key من الخلفية (ويحتاج Socket.IO أيضًا إلى ترويسة Origin)؛ راجع المصادقة. لاختيار سير العمل نفسه، راجع المفاهيم.

وسائط النقل حسب سير العمل

سير العملوسيلة النقلالدليل
النسخ الدفعيREST: أرسل مهمة ثم استعلم دوريًاواجهة REST للنسخ الدفعي
النسخ السريعSocket.IO audio_file، أو HTTP sttSocket.IO · البث عبر HTTP
النسخ الفوريSocket.IO audio_stream، أو HTTP stt-streamSocket.IO · البث عبر HTTP
تمييز المتحدثين المباشرSocket.IO diarization_stream (أو التفرع على audio_stream)، أو HTTP diarization-streamSocket.IO · البث عبر HTTP
تحويل النص إلى كلامSocket.IO tts: PCM قابل للتشغيل بتردد 24 kHz، أو HTTP tts: تسجيل مؤطر بتردد 16 kHz لا يمكن تشغيله بموثوقية، أو POST /v1/audio/speech: ملف MP3 أو WAV أو PCM كامل واحد (على voice-dev اليوم)Socket.IO · البث عبر HTTP · واجهة OpenAI المتوافقة

للصوت المباشر، يقارن الصوت المباشر عبر API بين Socket.IO والبث عبر HTTP. رموز الأخطاء والحدود وقواعد إعادة المحاولة لكل وسيلة نقل في الأخطاء والحدود.

المواصفات

السطحالمرجع
واجهة REST للنسخ الدفعي (OpenAPI)مرجع Batch API
البث عبر HTTP (OpenAPI)مرجع Realtime HTTP API
Socket.IO (AsyncAPI)أحداث Realtime · النسخ السريع · TTS

نسخ Markdown لكل صفحة مدرجة في المقدمة.

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

في هذه الصفحة