تحويل النص إلى كلام
ولّد كلاماً عربياً متدفقاً من النص عبر نقطة نهاية الصوت.
أرسل طلب POST /v1/audio/speech بمفتاح Bearer يملك نطاق tts. تتبع نقطة النهاية صيغة طلبات الصوت المألوفة في OpenAI، وتبث الصوت الناتج في جسم الاستجابة.
curl --fail --show-error https://api.sawtakarabi.ai/v1/audio/speech \
-H "Authorization: Bearer $SAWTAK_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "arabic-tts-1",
"input": "مرحباً بك",
"response_format": "wav"
}' \
--output speech.wavحقول الطلب
| الحقل | مطلوب | الوصف |
|---|---|---|
model | نعم | معرّف نموذج الكلام العربي. |
input | نعم | النص المراد توليد كلام له. |
voice | لا | معرّف صوت من دليل الأصوات. اتركه لاستخدام الصوت الافتراضي. |
response_format | لا | pcm للصوت الخام، أو wav لتدفق WAV. |
sample_rate | لا | معدل إخراج PCM المطلوب عند دعمه. |
enhance_pronunciation | لا | قيمة منطقية (true/false). تطبيق التشكيل الآلي (الحركات) المكيّف حسب لهجة الصوت على النص العربي قبل التوليد لتحسين دقة النطق ومخارج الحروف. يُحافظ على تشكيلك الأصلي ويكمل الحروف المتبقية فقط. الافتراضي false. |
إعداد النص
تتحقق الخدمة من الطلب قبل إرساله إلى عامل الكلام. قسّم المقاطع الطويلة جداً عند نهايات الجمل الطبيعية، ولا تقطع الكلمات. تتم تسوية النصوص تلقائياً بالافتراض، ويمكنك تفعيل enhance_pronunciation: true لتطبيق التشكيل الآلي المكيّف وضمان أعلى دقة في مخارج الحروف.
استخدام صوت مخصص
أنشئ صوتاً خاصاً من خلال استنساخ الصوت، وانتظر حتى تصبح حالته جاهزة، ثم ضع معرّفه في voice. إذا لم يكن الصوت متاحاً للحساب الموثق، تعيد الواجهة خطأً بدلاً من الرجوع بصمت إلى صوت آخر.
لأخطاء الاستجابة وإعادة المحاولة، راجع الأخطاء وحدود الطلبات.