تحويل ملف صوتي إلى نص

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

تبدأ مهمة تحويل الكلام إلى نص لملف صوتي مرفوع حتى 10 دقائق و150 ميجابايت، وتعيد `jobId` الخاص بها. احصل على النص المفرّغ من `GET /v1/speech-to-text/jobs/{jobId}`، أو من حدث `job.completed` في Webhook.

Headers

Authorization string مطلوب

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

متن الطلب

multipart/form-data

file file مطلوب

الملف الصوتي (mp3، wav، m4a، webm، ogg). حتى 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

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

{
  "data": {
    "jobId": "66e5f0c2a1b2c3d4e5f60718",
    "status": "processing"
  },
  "success": true,
  "statusCode": 200,
  "errorMessage": null
}