الانتقال إلى المحتوى الرئيسي
POST
إنشاء كلام صوتي

اختر صوتًا

اضبط voice في المستوى الأعلى للحصول على طلبات قابلة للنقل بين المزوّدين. يربطه Phaseo بصوت المزوّد الموجَّه إليه؛ وقيمة voice التي لا يقبلها المزوّد والنموذج الموجَّه إليهما تُرجع 400 invalid_request_error مع param: "voice". بالنسبة إلى eleven-labs/eleven-v4 وeleven-labs/eleven-v4-turbo، مرّر أي معرّف صوت من مكتبة أصوات ElevenLabs مكوّن من 20 حرفًا، بما في ذلك صوت مستنسخ مخصص. اضبط config.elevenlabs.voice_settings.stability وsimilarity_boost حسب الحاجة. لا يدعم Eleven v4 ‏speed ولا voice_settings.style.

مرّر صوتًا أصليًا خاصًا بالمزوّد

لاستخدام إعداد الصوت الخاص بالمزوّد بدلًا من voice:
  • ElevenLabs: ‏config.elevenlabs.voice_id أو config.elevenlabs.voice أو config.elevenlabs.voiceName.
  • Google: ‏config.google.voice_name أو config.google.voiceName.

التفويضات

Authorization
string
header
مطلوب

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

الجسم

application/json
model
string
مطلوب
input
string
مطلوب
models
string[]

نماذج احتياطية اختيارية ومرتبة تُجرَّب بعد model. الحقل model مطلوب وهو دائمًا النموذج الأساسي. عندما تفشل محاولة بالرمز 429 أو 500 أو 502 أو 503 أو 504، تُجرَّب الإدخالة التالية؛ وتُعاد الأخطاء الأخرى دون تغيير. يقبل ما يصل إلى 25 معرّف نموذج أو إعدادًا مسبقًا؛ وتُتجاهل الإدخالات المكررة والإدخالات المطابقة لـ model. يُتحقق من كل محاولة وتُسجَّل وتُحتسب تكلفتها كطلب مستقل، ويعرض الحقل model في الاستجابة وتتبّع التوجيه النموذج الذي خدم الطلب. لا تنتقل طلبات البث إلى نموذج احتياطي إلا قبل إرسال البايت الأول، ولا تنتقل مهام الفيديو والموسيقى إلا عند الإرسال. ترفض طلبات batch وrealtime وcouncil الحقل models. تكون الأولوية للنماذج الاحتياطية المحددة في مسار ديناميكي، ولا يمكن الجمع بين phaseo/auto وmodels.

Required array length: 1 - 25 elements
Minimum string length: 1
مثال:
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.

آخر تعديل في ١٦ نوفمبر ٢٠٢٦