---
title: تحويل النص إلى كلام
description: ولّد كلاماً عربياً متدفقاً من النص عبر نقطة نهاية الصوت.
---

أرسل طلب `POST /v1/audio/speech` بمفتاح Bearer يملك نطاق `tts`. تتبع نقطة النهاية صيغة طلبات الصوت المألوفة في OpenAI، وتبث الصوت الناتج في جسم الاستجابة.

```bash
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` | لا | معرّف صوت من [دليل الأصوات](/ar/docs/voices). اتركه لاستخدام الصوت الافتراضي. |
| `response_format` | لا | `pcm` للصوت الخام، أو `wav` لتدفق WAV. |
| `sample_rate` | لا | معدل إخراج PCM المطلوب عند دعمه. |
| `enhance_pronunciation` | لا | قيمة منطقية (`true`/`false`). تطبيق التشكيل الآلي (الحركات) المكيّف حسب لهجة الصوت على النص العربي قبل التوليد لتحسين دقة النطق ومخارج الحروف. يُحافظ على تشكيلك الأصلي ويكمل الحروف المتبقية فقط. الافتراضي `false`. |

## إعداد النص

تتحقق الخدمة من الطلب قبل إرساله إلى عامل الكلام. قسّم المقاطع الطويلة جداً عند نهايات الجمل الطبيعية، ولا تقطع الكلمات. تتم تسوية النصوص تلقائياً بالافتراض، ويمكنك تفعيل `enhance_pronunciation: true` لتطبيق التشكيل الآلي المكيّف وضمان أعلى دقة في مخارج الحروف.

## استخدام صوت مخصص

أنشئ صوتاً خاصاً من خلال [استنساخ الصوت](/ar/docs/voice-cloning)، وانتظر حتى تصبح حالته جاهزة، ثم ضع معرّفه في `voice`. إذا لم يكن الصوت متاحاً للحساب الموثق، تعيد الواجهة خطأً بدلاً من الرجوع بصمت إلى صوت آخر.

لأخطاء الاستجابة وإعادة المحاولة، راجع [الأخطاء](/ar/docs/errors) و[حدود الطلبات](/ar/docs/limits).