المطورون / نص إلى كلام

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

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

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

Headers

Authorization string مطلوب

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

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

jobId string مطلوب

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

الاستجابة

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

data object

النتيجة.

success boolean

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

statusCode integer

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

errorMessage string or null

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

الأخطاء

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

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

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

{
  "data": {
    "id": "66e5f0c2a1b2c3d4e5f60718",
    "status": "completed",
    "text": "الطقس اليوم جميل والسماء صافية في المدينة",
    "voiceId": "66e5ef3a9c1d2b4f8a7e6c01",
    "audioUrl": "https://storage.example.com/tts/tts-output.wav?X-Amz-Signature=...",
    "durationSeconds": 3.4,
    "creditsConsumed": 41,
    "error": null,
    "createdAt": "2026-09-15T10:21:04.512Z"
  },
  "success": true,
  "statusCode": 200,
  "errorMessage": null
}