نظرة عامة على API المباشرة
اختر أعمال Batch أو الصوت الكامل السريع أو البث المباشر أو TTS لتكامل HUMAIN Voice مباشر.
استخدم هذه الأدلة عندما لا يملك وقت التشغيل SDK منشورًا، أو تحتاج تحكمًا على مستوى البروتوكول، أو تحتاج تشخيص سلوك النقل. ينبغي لتطبيقات JavaScript وPython أن تبدأ عادة من أدلة SDK.
اختر حسب دورة حياة الإدخال
| الإدخال والنتيجة | السطح المباشر | ابدأ من | أبقِ هذا مفتوحًا كعقد |
|---|---|---|---|
| اجتماع أو بودكاست أو أرشيف أو تسجيل طويل مكتمل آخر يمكن أن ينتهي بصورة غير متزامنة | Batch REST: ارفع مرة، واستلم jobId، ثم استعلم | دليل Batch REST | Batch OpenAPI |
| وحدة صوت مكتملة حساسة للكمون، مثل دور محادثة واحد | النسخ السريع: أرسل الوحدة كاملة عبر Socket.IO audio_file أو HTTP متعدد الأجزاء /realtime/http/stt | دليل Socket.IO أو دليل Realtime HTTP | Fast AsyncAPI أو Realtime HTTP OpenAPI |
| صوت لا يزال يصل، مع نص مباشر أو مقاطع متحدثين | البث المباشر: audio_stream / diarization_stream عبر Socket.IO، أو بث HTTP مؤطر | نظرة عامة على نقل Realtime | Realtime AsyncAPI وRealtime HTTP OpenAPI |
| نص يجب أن يصبح كلامًا | TTS: tts / tts_audio عبر Socket.IO، أو TTS مباشر عبر HTTP مع قيد التأطير الموثق | دليل Socket.IO؛ استخدم Realtime HTTP فقط عند الحاجة إلى HTTP | TTS AsyncAPI أو Realtime HTTP OpenAPI |
يستهلك Batch والنسخ السريع كلاهما صوتًا مكتملًا. اختر Batch للوسائط الطويلة، وFast فقط لوحدة مكتملة محدودة يهم كمونها. لا تجعل أحداث النتائج إدخال Fast فوريًا. اختر Realtime فقط ما دام الصوت يصل.
الوسائط الطويلة: Batch REST
أرسل تسجيلاً كاملاً، واستعلم بمهلة، وتعامل مع done وfailed وcleared.
الأحداث: Socket.IO
نفذ STT السريع للصوت الكامل، أو STT المباشر، أو التمييز، أو اكتشاف الأصوات، أو TTS المؤطر.
بلا Socket.IO: Realtime HTTP
استخدم عمليات الملف الكامل متعددة الأجزاء أو HTTP المؤطرة، والتزم بقيد حدود TTS عبر HTTP.
دورة الحياة المباشرة والتعافي
وفّق النتائج المؤقتة، وأنهِ التدفقات، وتعافَ بصورة محافظة بعد الانقطاع.
المتطلبات المشتركة
- احصل على
API_KEYعبر مسار المصادقة، واستخدمAPI_URLالمعروض لهذه البيئة. يستخدم SDK المسار/socket.ioافتراضيًا؛ ولا تستنتج تجاوزًا من بيئة أخرى. - أرسل
x-api-keyفي كل طلب HTTP محمي واتصال Socket.IO. احتفظ به في خلفية موثوقة؛ فلا تستطيع شيفرة المتصفح إبقاء مفتاح API سريًا. - ضع مهلاً محدودة للاتصال والطلب والقراءة والاستعلام والنتيجة النهائية. تحقق من حالة HTTP قبل تحليل النجاح، وأغلق كل بث أو مقبس.
| السطح | عقد الصوت أو الخرج المطلوب |
|---|---|
| Batch REST | رفع ملف multipart/form-data واحد |
| النسخ السريع | ملف مشفر مكتمل واحد في حزمة Socket.IO أو طلب HTTP متعدد الأجزاء |
| ASR المباشر والتمييز | PCM16 little-endian، بتردد 16 kHz وأحادي القناة؛ يحتوي كل جسم إدخال ترويسة التحكم الموثقة ذات 18 بايت |
| TTS عبر Socket.IO | PCM16 خام مؤطر little-endian، بتردد 24 kHz وأحادي؛ يبدأ الصوت بعد ترويسة الإطار ذات 17 بايت |
| TTS عبر HTTP | تسجيل بروتوكول بلا فواصل تحمل إطاراته النظرية PCM16 بتردد 16 kHz؛ ولا يستطيع العميل العام استعادة حدود الإطارات أو صوت قابل للتشغيل |
تجيب الأدلة والمراجع عن أسئلة مختلفة
| استخدم | عندما تحتاج إلى |
|---|---|
| دليل API | اختيار النقل، وتسلسل الطلب، وقواعد دورة الحياة، وتسوية النتائج، والتنظيف، والتنبيهات التشغيلية |
| مرجع OpenAPI المولد | مسار HTTP وطريقته ومصادقته ومعاملاته وجسمه وحالاته ومخططات استجابته بدقة |
| مرجع AsyncAPI المولد | أسماء أحداث Socket.IO وحقول الحمولات وتخطيطات البايت الثنائية وأمان الاتصال بدقة |
اقرأ الدليل أولاً، ثم أبقِ المرجع المولد المطابق بجانب تنفيذك. إذا بدا أنهما يختلفان في سلوك البروتوكول المباشر، فعامل المواصفة المولدة المتحقق منها كعقد وأبلغ عن انحراف الدليل.
الخطوات التالية
- تحقق من العنوان والمفتاح الصادرين بلا رفع صوت.
- اختر صفًا واحدًا أعلاه وأكمل أصغر طلب ممثل له.
- أضف معالجة الأخطاء المنظمة وإعادة المحاولة المحدودة من الأخطاء وحدود المعدل.