مرجع API المباشرة عبر HTTP
مرجع على مستوى المخطط لتكاملات Batch وHTTP المتدفق.
استخدم هذا المرجع عندما تحتاج إلى مسارات HTTP الدقيقة، أو المعاملات، أو أجسام الطلب، أو أشكال الاستجابة، أو أمثلة الطلبات المولّدة. لاتباع تكامل موجّه باستخدام SDK بالإصدار 0.18.0، ابدأ من البدء السريع أو أدلة API.
اختر حسب دورة حياة الإدخال
| سير العمل | حالة الإدخال | الاستخدام الأنسب |
|---|---|---|
| النسخ الدفعي Batch | تسجيل طويل ومكتمل | الاجتماعات والبودكاست والمقابلات والأرشيفات التي تُعالج كأعمال غير متزامنة |
| النسخ السريع Fast | وحدة صوت مكتملة ومحدودة | أدوار الوكلاء الحساسة للزمن والأوامر الصوتية والعبارات الحوارية القصيرة |
| ASR الفوري | الصوت ما زال يصل | الميكروفونات والمكالمات والتدفقات التي تحتاج إلى نتائج جزئية ونهائية |
| تحويل النص إلى كلام | الإدخال نص والإخراج صوت | إنشاء تدفق صوت PCM16 من النص |
اضبط الوصول
احصل على مفتاح API عبر مسار الوصول المعتمد في مؤسستك. احتفظ بالمفتاح في خادم موثوق، واستخدم المضيف ومسار الخدمة المهيأين لبيئتك. راجع المصادقة قبل إتاحة التكامل للمستخدمين.
export API_URL="https://api.voice.humain.com"
export API_KEY="YOUR_API_KEY"| API | المسار الأساسي |
|---|---|
| Batch API | /v1 |
| Realtime HTTP API | /realtime |
أرسل طلبًا آمنًا
يوفر استعلام للقراءة فقط عن معرّف عمل غير موجود عمدًا دليلاً تشخيصيًا غير معدّل للحالة من دون إنشاء عمل:
curl --include "$API_URL/v1/transcribe/00000000-0000-4000-8000-000000000000" \
--header "x-api-key: $API_KEY" \
--header "Origin: $API_URL"- يتوافق
404مع البحث عن العمل غير الموجود، لكنه لا يثبت وحده صلاحية بيانات الاعتماد وقدرة Batch. - يشير
401إلى أن المفتاح مفقود أو غير صالح لمسار الطلب. - يشير
403إلى رفض الوصول؛ تحقق من القيم المهيأة عبر مسار الوصول المعتمد في مؤسستك.
أقسام المرجع
Batch API
أرسل تسجيلات طويلة ومكتملة، ثم استعلم عن المهمة حتى يصل إلى حالة نهائية.
Realtime HTTP API
استخدم HTTP المتدفق للنسخ السريع أو ASR الحي أو تمييز المتحدثين أو TTS.
الحدود التشغيلية
- قد يعيد إرسال عمل Batch الحالة
429عند نفاد سعة معالجة الصوت. تعامل معها كضغط سعة واستخدم بيانات السعة المعادة عند توفرها. - لا تعد محاولة رفع ملف ذي نتيجة ملتبسة بلا تحقق. سجّل نتيجة الطلب في طبقة الأعمال حتى لا ينشئ انقضاء المهلة أعمالًا مكررة من دون ملاحظة.
- استخدم استعلامًا محدودًا لأعمال Batch وتوقف عند
doneأوfailedأوcleared. - تختلف قواعد التأطير ودورة الحياة بين HTTP وSocket.IO. اتبع صفحة وسيلة النقل التي تستخدمها فعلًا.
الوصول عبر Markdown وLLM
- استخدم `/ar/api-reference/md` لقراءة هذه الصفحة بصيغة Markdown الخام.
- ألحق مسار عملية، مثل `/ar/api-reference/md/batch/submit-transcription-job`، لقراءة عملية واحدة.
- استخدم `/llms-full.txt` لحزمة الوثائق الثنائية اللغة كاملة.