Skip to main content
POST
إنشاء كلام صوتي

مطابقة الأصوات

تُوحّد قيمة voice حسب المزوّد باستخدام خريطة أسماء بديلة داخلية:
  • openai: أصوات شائعة (مثل alloy, ash, ballad, coral, echo, fable, onyx, nova, sage, shimmer, verse, cedar, marin).
  • google (AI Studio / Gemini TTS): الأصوات الجاهزة المعتمدة: Zephyr, Puck, Charon, Kore, Fenrir, Leda, Orus, Aoede, Callirrhoe, Autonoe, Enceladus, Iapetus, Umbriel, Algieba, Despina, Erinome, Algenib, Rasalgethi, Laomedeia, Achernar, Alnilam, Schedar, Gacrux, Pulcherrima, Achird, Zubenelgenubi, Vindemiatrix, Sadachbia, Sadaltager, Sulafat.
  • elevenlabs: تُطابق أصوات البداية العامة الشائعة (مثل rachel, domi, bella, antoni, elli, josh, arnold, adam, sam).
مع eleven-labs/eleven-v4 وeleven-labs/eleven-v4-turbo، مرّر أي معرّف من 20 محرفًا من مكتبة أصوات ElevenLabs، بما في ذلك نسخة صوتية مخصصة. اضبط config.elevenlabs.voice_settings.stability وsimilarity_boost حسب الحاجة. لا يدعم Eleven v4 الحقلين speed وvoice_settings.style. إذا لم تكن قيمة voice صالحة لمزيج المزوّد والنموذج المحدد للمسار، فسيُرجع الطلب 400 invalid_request_error مع param: "voice".

تجاوزات المزوّد

يمكنك أيضًا تمرير إعدادات الصوت الخاصة بالمزوّد:
  • ElevenLabs: config.elevenlabs.voice_id / config.elevenlabs.voice / config.elevenlabs.voiceName
  • Google: config.google.voice_name / config.google.voiceName
اجعل voice في المستوى الأعلى هو القيمة الافتراضية لتسهيل النقل.

عينات الأصوات

التفويضات

Authorization
string
header
مطلوب

المصادقة باستخدام رمز Bearer

الجسم

application/json
model
string
مطلوب
input
string
مطلوب
voice
string
speed
number
النطاق المطلوب: 0.25 <= x <= 4
format
enum<string>
الخيارات المتاحة:
mp3,
wav,
ogg,
aac
provider
object

تفضيلات توجيه المزوّد لاختياره عبر البوابة.

config
object

الاستجابة

200 - audio/mpeg

ملف صوتي

The response is of type file.

آخر تعديل في ٢ أكتوبر ٢٠٢٦