عرض مهام تحويل الكلام إلى نص

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

تعرض مهام API في مساحة عمل هذا المفتاح، مقسّمة إلى صفحات باستخدام `offset` و`limit`. يحتاج المفتاح إلى وصول إلى تحويل الكلام إلى نص.

Headers

Authorization string مطلوب

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

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

offset integer اختياري

عدد المهام التي تُتخطّى.

0 أو أكثرالافتراضي 0

limit integer اختياري

عدد المهام التي تُعاد.

من 1 إلى 100الافتراضي 20

الاستجابة

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

data object

النتيجة.

items array of objects

العناصر في هذه الصفحة.

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.

total number

العدد الإجمالي للعناصر.

success boolean

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

statusCode integer

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

errorMessage string or null

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

الأخطاء

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

GET /v1/speech-to-text/jobs

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

{
  "data": {
    "items": [
      {
        "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"
      }
    ],
    "total": 1
  },
  "success": true,
  "statusCode": 200,
  "errorMessage": null
}