تفاصيل مهمة تحويل الكلام إلى نص

GET https://api.echonova.ai/v1/speech-to-text/jobs/{jobId}

تعيد مهمة API واحدة في مساحة عمل هذا المفتاح، مع نصها المفرّغ بعد اكتمالها، أيًا كان المفتاح الذي أنشأها. المهمة التابعة لمساحة عمل أخرى تُرجع الرمز `404`. يحتاج المفتاح إلى وصول إلى تحويل الكلام إلى نص.

Headers

Authorization string مطلوب

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

معاملات المسار

jobId string مطلوب

`jobId` الذي أعادته API عند إنشاء المهمة.

الاستجابة

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

data object

النتيجة.

id string

معرّف المهمة.

status string

`pending` أو `processing` أو `completed` أو `failed`.

transcription string

النص المفرّغ. لا يظهر حتى تكتمل المهمة.

durationSeconds number

مدة المقطع الصوتي بالثواني. تقدير أثناء المعالجة، ثم المدة المقاسة بعد الاكتمال.

language string

اللغة التي طُلب بها التفريغ النصي.

numbersAsDigits boolean

هل كُتبت الأرقام المنطوقة بالأرقام. المهام التي سبقت هذا الخيار تظهر `true`.

identifySpeakers boolean

هل طُلب تحديد المتحدثين عبر `identify_speakers`. المهام التي سبقت هذا الخيار تظهر `false`.

segments array of objects

النص المفرّغ في مقاطع موقّتة، لكل منها المتحدث الخاص به، مرتّبة حسب `start`. فارغة ما لم يُحدَّد المتحدثون.

speakers array of objects

المتحدثون الذين سُمعوا، بترتيب ظهورهم الأول. فارغة ما لم يُحدَّد المتحدثون.

creditsConsumed integer

الرصيد المخصوم، رقم صحيح.

error string

سبب فشل المهمة. لا يظهر إلا إذا كانت `status` تساوي `failed`.

createdAt string

وقت إنشاء المهمة بصيغة ISO 8601 بالتوقيت UTC.

success boolean

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

statusCode integer

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

errorMessage string or null

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

الأخطاء

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

GET /v1/speech-to-text/jobs/{jobId}

curl "https://api.echonova.ai/v1/speech-to-text/jobs/{jobId}" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "data": {
    "id": "66e3f2a1c9d4b8a1f0e12346",
    "status": "completed",
    "transcription": "مرحبا بكم في إيكونوڤا",
    "durationSeconds": 312.4,
    "language": "ar",
    "numbersAsDigits": true,
    "identifySpeakers": true,
    "segments": [
      {
        "start": 0.38,
        "end": 4.12,
        "text": "السلام عليكم، كيف حالك؟",
        "speaker": "spk0"
      }
    ],
    "speakers": [
      {
        "id": "spk0",
        "talkTime": 88.1
      }
    ],
    "creditsConsumed": 521,
    "error": null,
    "createdAt": "2026-09-15T10:21:04.512Z"
  },
  "success": true,
  "statusCode": 200,
  "errorMessage": null
}