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

يوفر واجهة برمجة التطبيقات لتوليد النص إلى كلام (TTS) واجهة بسيطة وفعّالة لتحويل النص إلى كلام يبدو طبيعيًا ومنطقيًا.

مسار الوصول

POST /audio/v1/text-to-speech

جسم الطلب

• prompt (string, مطلوب): النص المُدخل الذي سيتم تحويله إلى كلام.
• voiceId (string, مطلوب): معرّف الصوت الذي سيتم استخدامه لتوليد الكلام. يتم قبول معرفات الأصوات التالية:
  • 52f254abbd463029dd655422 أنثى
  • e1fb08ee7177e52425b96a49 ذكر
  • 3695e87db7f5059a13c3ec9e ذكر
  • b054b7a4a1dbabba96a691dd أنثى
  • 127de703d939930eb0a85420 أنثى
  • 68e53488394f7e26aa66a57f ذكر
  • b38d58df9133fc82798fa8b5 ذكر
  • 55b829b051ad61983f8e3579 أنثى
  • dfc9b361cb98b238cf816ab3 ذكر
  • e09406111fbb6c20e4cc5ebc أنثى
  • de84f730320dea1fc5e139b4 ذكر
  • 21c1658c7c9290b069a30b75 أنثى
  • 65b53fb9492bb30ef542b16d ذكر
  • 4681e2025560678d8a344cbe ذكر
  • 620f8886ee8a435c1aa66010 ذكر
  • 8015b0357f6da0e72043cf6f أنثى
  • 753b5470f2294f7eedb9a5af ذكر
  • 73108b4aaaf6e8bf118cae48 أنثى
  • 700eebf16fe75784f3c45f9a ذكر
  • e387eee06b3892c72c69d5a2 ذكر

مثال

الطلب

POST /audio/v1/text-to-speech
Content-Type: application/json
x-access-key: YOUR_ACCESS_KEY
{
    "prompt": "<النص المُدخل>",
    "voiceId": "<أحد معرّفات الأصوات>"
}

الاستجابة

نجاح

HTTP/1.1 200 OK
Content-Type: audio/mpeg
 
[البيانات الصوتية الثنائية]

خطأ

HTTP/1.1 400 Bad Request
Content-Type: application/json
{
    "success": false,
    "message": "<رسالة خطأ تحتوي على التفاصيل>"
}