تجريبي
توثيق تحويل النص العربي إلى كلام
تصفّح التوثيق
تحويل النص إلى كلام
POST /v1/audio/speech
modelstringاستخدم arabic tts مع حزم OpenAI.
inputstringالنص المراد نطقه. محسوب حسب الحرف.
voicestringمعرّف من صفحة الأصوات. اتركه فارغًا لاستخدام الصوت الافتراضي دون عينة مرجعية.
response_formatstringيجب أن يكون "pcm"، PCM أحادي 16-بت خام هو الصيغة الوحيدة التي ننتجها.
sample_ratenumberمعدل إخراج اختياري بين 8000 و48000 هرتز. الافتراضي 24000 هرتز.
| الحقل | النوع | ملاحظات |
|---|---|---|
| model | string | استخدم arabic tts مع حزم OpenAI. |
| input | string | النص المراد نطقه. محسوب حسب الحرف. |
| voice | string | معرّف من صفحة الأصوات. اتركه فارغًا لاستخدام الصوت الافتراضي دون عينة مرجعية. |
| response_format | string | يجب أن يكون "pcm"، PCM أحادي 16-بت خام هو الصيغة الوحيدة التي ننتجها. |
| sample_rate | number | معدل إخراج اختياري بين 8000 و48000 هرتز. الافتراضي 24000 هرتز. |
curl --fail --show-error https://api.sawtakarabi.ai/v1/audio/speech \
-H "Authorization: Bearer sk_ar_live_..." \
-H "Content-Type: application/json" \
-d '{"model":"arabic tts","input":"مرحبا بك","voice":"9287b630-bc5f-574d-8c38-5f525c2b4ca3","response_format":"pcm"}' \
--output speech.pcmجسم الاستجابة هو صوت PCM خام أحادي القناة بدقة 16 بت وبترتيب Little-Endian، من دون ترويسة WAV. يعاد معدل الإخراج الفعلي في X-Sample-Rate؛ استخدم هذه القيمة لتشغيل الصوت بالسرعة الصحيحة.