تخطّي إلى المحتوى

xAI Text to Speech

التكامل

معرّف النموذج xai/tts/v1
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/xai/tts/v1?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Hello from Doitong. This is a short test sentence."
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

هذا الطلب: ⁨‏0.001 $⁩ 1 رصيد API تشغيله في هذه الصفحة

الحصول على مفتاح API

تحويل النص إلى كلام بأصوات مدمجة واختيار اللغة ووسوم الكلام التعبيرية المضمنة

xAI · صوت

ستظهر نتيجتك الأولى هنا

أنشئ طلبًا أدناه وشغّله باستخدام مفتاح API الخاص بك. تُنسخ المخرجات إلى تخزيننا، وتُحفظ إلى الأبد أو لمدة 7 أيام مجانًا.

إنشاء طلب

تُنشأ عناصر التحكم من مخطط النموذج. يتحدّث الرمز والسعر عند تغييرها.

•مطلوب 50 / 15000

نص توليد الكلام، مع التحكم في الأداء التعبيري باستخدام العلامات المضمّنة ([laugh]، [pause]، [sigh]) أو العلامات المحيطة (<whisper>text</whisper>، <slow>text</slow>). لا يمكن أن يتجاوز المدخل 15,000 حرف.

متقدم voice · language · enable_safety_checker · output_format
الافتراضي eve

الصوت المضمّن المحدد لتوليد الكلام.

الافتراضي auto

اختيار اللغة من رموز BCP-47 التالية: en، zh، fr، de، hi، id، it، ja، ko، pt-BR، pt-PT، ru، es-MX، es-ES، tr، vi، bn، ar-EG، ar-SA، ar-AE. للكشف التلقائي، أرسل 'auto'.

إعداد لصيغة الصوت المُولَّد؛ القيمة الافتراضية هي MP3 بمعدل أخذ عينات يبلغ 24 kHz ومعدل بت يبلغ 128 kbps.

POST /run/xai/tts/v1?wait=20 عرض السعر → ⁨‏0.001 $⁩
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/xai/tts/v1?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Hello from Doitong. This is a short test sentence."
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

تشغيل هذا الطلب

يبقى مفتاحك في هذا المتصفح: لا يُرسل إلا إلى Doitong API ويُحفظ في localStorage فقط إذا فعّلت خيار التذكّر. الحصول على مفتاح API

حول xAI Text to Speech

يحوّل ما يصل إلى 15,000 حرف من النص إلى كلام. اختر من 28 صوتًا مدمجًا ورمز لغة أو الكشف التلقائي. يمكن أن يتضمن النص وسومًا مثل [laugh] و[pause] و[sigh]، أو وسوم إحاطة مثل <whisper> و<slow>، لتقديم تعبيري. يضبط `output_format` ملف الصوت.

المعاملات

الاسمالنوع الافتراضيمسموح الوصف
textمطلوب
النوعstring
≤ 15,000 حرف
نص توليد الكلام، مع التحكم في الأداء التعبيري باستخدام العلامات المضمّنة ([laugh]، [pause]، [sigh]) أو العلامات المحيطة (<whisper>text</whisper>، <slow>text</slow>). لا يمكن أن يتجاوز المدخل 15,000 حرف.
voiceاختياري
النوعenum
الافتراضيeve
carinazaganhelixorionlunairisaltairzenithperseusheliosluxkeplerrigelcosmocelesteursa
+12 أخرىsiriuslumencastornakshatlasauroralioraaraeveleorexsal
الصوت المضمّن المحدد لتوليد الكلام.
languageاختياري
النوعenum
الافتراضيauto
autoenar-EGar-SAar-AEbnzhfrdehiiditjakopt-BRpt-PT
+5 أخرىrues-MXes-EStrvi
اختيار اللغة من رموز BCP-47 التالية: en، zh، fr، de، hi، id، it، ja، ko، pt-BR، pt-PT، ru، es-MX، es-ES، tr، vi، bn، ar-EG، ar-SA، ar-AE. للكشف التلقائي، أرسل 'auto'.
output_formatاختياري
النوعobject
إعداد لصيغة الصوت المُولَّد؛ القيمة الافتراضية هي MP3 بمعدل أخذ عينات يبلغ 24 kHz ومعدل بت يبلغ 128 kbps.
output_format.codecاختياري
النوعenum
الافتراضيmp3
mp3wavpcmmulawalaw
برنامج ترميز الصوت؛ الخيارات المتاحة هي mp3، wav، pcm، mulaw، alaw.
output_format.sample_rateاختياري
النوعenum
الافتراضي24000
80001600022050240004410048000
تردد أخذ عينات الصوت، مقاسًا بالهرتز.
output_format.bit_rateاختياري
النوعenum
320006400096000128000192000
معدل بت لمخرج MP3، قيمته الافتراضية 128000 ويُقاس بالبت في الثانية؛ ولا ينطبق على برامج الترميز الأخرى.
enable_safety_checkerاختياري
النوعboolean
الافتراضيtrue
يمكن تخفيف الفحص بضبط القيمة على false، شريطة أن يكون المستدعي مخولًا بذلك.
مطلوب

المخرجات

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "xai/tts/v1",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 1,
    "usd": "0.001",
    "charged": 1,
    "refunded": 0
  },
  "input": {
    "text": "Hello from Doitong. This is a short test sentence."
  },
  "output": {
    "audio": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp3",
      "content_type": "audio/mpeg",
      "file_name": "0-output.mp3",
      "file_size": 1843200
    }
  },
  "outputs": [
    {
      "type": "audio",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp3",
      "content_type": "audio/mpeg",
      "file_size": 1843200,
      "duration": 12,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
ملفاتك، خيارككل outputs[].url هو نسخة على تخزيننا: تُحفظ إلى الأبد (مع الدفع لكل غيغابايت-شهر) أو لمدة 7 أيام مجانًا، وفق إعداد حسابك أو ?storage=.
البنية نفسها في كل نموذجtype وurl وcontent_type وwidth وheight وduration للصور والفيديو والصوت على حد سواء. output هو كائن النتائج الخاص بالنموذج.
حقول المخرجات
audio
object {url, content_type, file_name, file_size}ملف الصوت الناتج عن التوليد.

لوكلاء الذكاء الاصطناعي: تتوفر هذه الصفحة بصيغة Markdown على https://doitong.com/ar/developers/models/xai/tts/v1.md. جميع النماذج والأدلة: https://doitong.com/developers/llms.txt