المطورون / كلام إلى نص
حذف مهمة تحويل الكلام إلى نص منتهية ومقطعها الصوتي
https://api.echonova.ai/v1/speech-to-text/jobs/{jobId}تحذف مهمة API مكتملة أو فاشلة في مساحة عمل هذا المفتاح، مع مقطعها الصوتي، أيًا كان المفتاح الذي أنشأها. المهمة التي لا تزال قيد التنفيذ تُرجع الرمز `400`، والمهمة التابعة لمساحة عمل أخرى تُرجع الرمز `404`. يحتاج المفتاح إلى وصول إلى تحويل الكلام إلى نص.
Headers
كلمة Bearer ثم مسافة ثم مفتاح API الذي يبدأ بـ ek_. أنشئ المفاتيح في البوابة من المطورون، ثم مفاتيح واجهة برمجة التطبيقات.
معاملات المسار
`jobId` الذي أعادته API عند إنشاء المهمة.
الاستجابة
200 application/json كل استجابة تستخدم هذا الغلاف.
النتيجة.
`true` بعد حذف المهمة.
قيمته true عند نجاح الطلب.
يكرر رمز حالة HTTP.
قيمته null عند النجاح.
الأخطاء
الغلاف نفسه، مع success بقيمة false و data بقيمة null. كل الأخطاء
متى يحدث. `jobId` ليس معرّفًا سداسيًا عشريًا من 24 خانة.
الحل. استخدم المعرّف كما أعاده طلب الإنشاء تمامًا.
متى يحدث. المهمة في حالة `pending` أو `processing`؛ ولا يُحذف إلا مهمة مكتملة `completed` أو فاشلة `failed`.
الحل. انتظر حتى تنتهي المهمة، ثم احذفها.
متى يحدث. header `Authorization` مفقود، أو قيمته لا تبدأ بـ `Bearer ek_...`، أو أن الرمز لا يطابق أي مفتاح، أو أن المفتاح محذوف أو معطّل، أو أن حسابه مغلق.
الحل. أرسل `Authorization: Bearer ek_...` بمفتاح API مفعّل.
متى يحدث. مساحة العمل التي يتبعها المفتاح ليس لديها اشتراك.
الحل. تحقّق من خطة مساحة العمل في البوابة.
متى يحدث. حالة الاشتراك ليست نشطة ولا تجريبية.
الحل. جدّد الاشتراك.
متى يحدث. المفتاح مقيّد، وتحويل الكلام إلى نص ليس من الخدمات المسموح بها له.
الحل. عدّل المفتاح وامنحه تحويل الكلام إلى نص، أو استخدم مفتاحًا آخر.
متى يحدث. معرّف المهمة غير معروف، أو أن المهمة تتبع مساحة عمل أخرى، أو أنها أُنشئت من البوابة.
الحل. استخدم `jobId` من مهام API في مساحة العمل هذه.
متى يحدث. المفتاح أرسل أكثر من 100 طلب إلى نقطة نهاية واحدة خلال 60 ثانية، أو أن عنوان IP واحدًا أرسل أكثر من 100 طلب إلى نقطة نهاية واحدة خلال 60 ثانية (يُحسب حد عنوان IP قبل فحص المفتاح، لذلك قد يرد الخادم دون أي مفتاح)؛ و header `Retry-After` يحمل عدد الثواني المطلوب انتظارها.
الحل. انتظر عدد الثواني المذكور في `Retry-After`، ثم أعد المحاولة.
متى يحدث. خطأ لم تصنّفه API.
الحل. تحقّق من الطلب، ثم أعد المحاولة بعد لحظة قصيرة؛ وتواصل مع الدعم إذا تكرر الخطأ.
متى يحدث. تعذّر حذف المقطع الصوتي المخزّن للمهمة؛ وتبقى المهمة.
الحل. أعد محاولة الحذف بعد لحظة قصيرة.
متى يحدث. انقطاع مؤقت داخل API.
الحل. أعد المحاولة بعد لحظة قصيرة.
متى يحدث. انتهاء مهلة مؤقت داخل API.
الحل. أعد المحاولة بعد لحظة قصيرة.
curl -X DELETE "https://api.echonova.ai/v1/speech-to-text/jobs/{jobId}" \
-H "Authorization: Bearer YOUR_API_KEY"{
"data": {
"deleted": true
},
"success": true,
"statusCode": 200,
"errorMessage": null
}