ربط واجهة FasihTTS REST API لتوليد الصوت العربي

مسار ربط من الخادم يشمل المصادقة ومعرفات الأصوات والصوت بترميز base64 والأخطاء وإعادة المحاولة الآمنة.

أبسط طلب

أنشئ مفتاح API من لوحة التحكم واستدع الواجهة من كود خادم موثوق. لا تضع المفتاح داخل حزمة المتصفح العامة.

curl -X POST https://api.fasihtts.com/v1/tts \
  -H "content-type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "text": "مرحبًا بكم في فصيح",
    "dialect": "ar-msa",
    "voice": "ar-msa-formal-male-1"
  }'

معالجة الاستجابة

تحتوي الاستجابة الناجحة بصيغة JSON على audioContent بترميز base64 وصيغة مثل mp3 أو wav. فك الترميز على الخادم واحفظ الملف بالامتداد ونوع MIME المناسبين، ثم أرسل للعميل رابطًا قصير الصلاحية إن أمكن.

تحقق قبل الإرسال

استخدم ‎/v1/dialects و‎/v1/voices كدليل عام بدل اختراع المعرفات.
تأكد من أن الصوت المختار تابع للهجة المختارة.
ارفض النص الفارغ وطبّق حدود الطول الخاصة بمنتجك قبل استدعاء الواجهة.

إعادة المحاولة والاستخدام

أعد المحاولة فقط للأخطاء المؤقتة مع تأخير محدود، وتجنب المحاولات المتوازية للإجراء نفسه. يسجل فصيح استخدام التوليد الناجح، ولا تخصم المحاولات الفاشلة من رصيد الحروف. احتفظ بمرجع الطلب في سجلاتك للدعم.

جرّب فصيح