تحويل الصوت إلى نص بشكل متزامن (يعيد النص المفرّغ في طلب واحد، حتى 10 دقائق)

POST https://api.echonova.ai/v1/speech-to-text/sync

تحوّل ملفًا صوتيًا مرفوعًا حتى 10 دقائق و150 ميجابايت إلى نص في طلب واحد، وتعيد النص المفرّغ مع الرصيد المخصوم.

Headers

Authorization string مطلوب

كلمة ⁦Bearer⁩ ثم مسافة ثم مفتاح ⁦API⁩ الذي يبدأ بـ ⁦ek_⁩. أنشئ المفاتيح في البوابة من المطورون، ثم مفاتيح واجهة برمجة التطبيقات.

متن الطلب

multipart/form-data

file file مطلوب

الملف الصوتي (حتى 10 دقائق و150 ميجابايت).

language string اختياري

`auto` يترك الخدمة تحدد اللغة، وهي حاليًا العربية، وتتعامل أيضًا مع الكلام المختلط والإنجليزي الواضح. و`ar` للعربية والكلام المختلط بين العربية والإنجليزية. و`en` للكلام الإنجليزي فقط. العربية المرسلة بـ `en` تخرج مشوّشة.

auto، ar أو enالافتراضي auto

numbers_as_digits boolean اختياري

اكتب الأرقام المنطوقة بالأرقام (صفر واحد واحد → 011). اضبطه على `false` لإبقائها كلمات. ينطبق على العربية فقط، ولا تُحوَّل تفريغات الإنجليزية أبدًا.

الافتراضي true

identify_speakers boolean اختياري

تحديد من يتكلم ومتى: تعرض المهمة المكتملة حينها المتحدثين، والنص المفرّغ مقسّمًا إلى مقاطع موقّتة، يحمل كل منها المتحدث الخاص به. احذف الحقل أو أرسل `false` للحصول على النص المفرّغ وحده.

الافتراضي false

الاستجابة

200 application/json كل استجابة تستخدم هذا الغلاف.

data object

النتيجة.

success boolean

قيمته ⁦true⁩ عند نجاح الطلب.

statusCode integer

يكرر رمز حالة ⁦HTTP⁩.

errorMessage string or null

قيمته ⁦null⁩ عند النجاح.

الأخطاء

الغلاف نفسه، مع ⁦success⁩ بقيمة ⁦false⁩ و ⁦data⁩ بقيمة ⁦null⁩. كل الأخطاء

POST /v1/speech-to-text/sync

curl -X POST "https://api.echonova.ai/v1/speech-to-text/sync" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@audio.mp3;type=audio/mpeg"

{
  "data": {
    "jobId": "66e3f2a1c9d4b8a1f0e12345",
    "status": "completed",
    "transcription": "مرحبا بكم في إيكونوڤا",
    "durationSeconds": 15.51,
    "language": "ar",
    "numbersAsDigits": true,
    "identifySpeakers": true,
    "segments": [
      {
        "start": 0.38,
        "end": 4.12,
        "text": "السلام عليكم، كيف حالك؟",
        "speaker": "spk0"
      }
    ],
    "speakers": [
      {
        "id": "spk0",
        "talkTime": 88.1
      }
    ],
    "creditsConsumed": 26
  },
  "success": true,
  "statusCode": 200,
  "errorMessage": null
}