تحويل النص إلى كلام (TTS)

تحويل النص إلى كلام طبيعي

تحويل النص إلى كلام باستخدام توليف الصوت بالذكاء الاصطناعي. يرجع ملف صوتي بصيغة MP3.

المصادقة

قم بتضمين مفتاح API الخاص بك في ترويسة Authorization.

محتوى الطلب (Request Body)

صيغ المخرجات المدعومة

يمكن أن تكون معلمة output_format أيًا من القيم التالية:

• MP3: mp3_22050_32, mp3_24000_48, mp3_44100_32, mp3_44100_64, mp3_44100_96, mp3_44100_128, mp3_44100_192
• PCM: pcm_8000, pcm_16000, pcm_22050, pcm_24000, pcm_32000, pcm_44100, pcm_48000
• Opus: opus_48000_32, opus_48000_64, opus_48000_96, opus_48000_128, opus_48000_192

يعمل هذا القسم كمرجع، حتى يتمكن المستخدمون من اختيار الصيغة المناسبة دون إزدحام جدول الطلب الرئيسي.

كائن إعدادات الصوت

قواعد وقيود إعدادات الصوت

• عند ضبط enable_emotions على true، يجب عدم تضمين الحقول التالية في إعدادات الصوت (voice_settings):
  • voice_similarity
  • speed
  • fast_mode
• الطلبات التي تتضمن أيًا من هذه الحقول أثناء تفعيل العواطف سيتم رفضها بخطأ 400 INVALID_REQUEST.

مثال

curl -X POST "https://moknah.io/api/v1/tts/generate/" \
  -H "Authorization: "Bearer your_api_key"
  -d '{
    "text": "مرحبا بك في منصة مكنة",
    "voice_id": 1,
    "prerecording": 1,
    "voice_settings": {
        "speed": 1.0,
        "temperature": 25
    }
  }' \
  --output speech.mp3

import requests

response = requests.post(
    "https://moknah.io/api/v1/tts/generate/",
    headers={
        "Authorization": "Bearer your_api_key",
        "Content-Type": "application/json"
    },
    json={
        "text": "مرحبا بك في منصة مكنة",
        "voice_id": 1,
        "prerecording": 1,
        "voice_settings": {
            "speed": 1.0,
            "temperature": 25
        }
    }
)

with open("speech.mp3", "wb") as f:
    f.write(response.content)

const response = await fetch(
    'https://moknah.io/api/v1/tts/generate/',
    {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer your_api_key',
            'Content-Type': 'application/json'
        },
        body: JSON.stringify({
            text: 'مرحبا بك في منصة مكنة',
            voice_id: 1,
            prerecording: 1,
            voice_settings: {
                speed: 1.0,
                temperature: 25
            }
        })
    }
);

const blob = await response.blob();
// Save or play the audio

الاستجابة

يرجع بيانات صوتية ثنائية بصيغة MP3 مع هذه الترويسات:

أخطاء