نص الطلب
مهلة الطلبات المتزامنة: ينتظر هذا الـ endpoint غير الخاص بالمحادثة حتى ينتهي النموذج الذي تم التوجيه إليه. قد تتجاوز المدخلات الكبيرة أو الصوت الطويل أو الدُفعات الكبيرة القيمة الافتراضية الشائعة للعميل وهي 30s، لذا اضبط مهلة عميل HTTP على120s على الأقل.
تختلف الحقول الاختيارية حسب عائلة النموذج. يتحقق TokenLab من مصفوفة الحقول قبل التوجيه: تقبل نماذج OpenAI TTS الحقول voice وinstructions وresponse_format وstream_format وspeed؛ وتقبل نماذج MiniMax speech الحقول voice وvoice_id وresponse_format وstream_format وspeed؛ وتقبل نماذج Gemini TTS الحقول prompt وlanguage_code وvoice وresponse_format وstream_format وspeed وtemperature؛ وقد تقبل مسارات TTS الأضيق من نوع Vidu/Kling الحقلين input وstream_format فقط. الحقول العلوية غير المعروفة، بما في ذلك user، ترجع 400 unsupported_parameter بدلًا من تجاهلها.
نموذج TTS. تشمل الأمثلة
tts-1 وgpt-4o-mini-tts وspeech-02-hd وgemini-2.5-flash-tts. استخدم GET /v1/models?recommended_for=tts للحصول على القائمة الحالية.النص المطلوب إنشاء صوت له. الحد الأقصى 4096 حرفًا.
محدد الصوت. مرر اسم صوت مدمج مثل
nova، أو صوت Gemini مثل Kore، أو كائنًا مثل { "id": "voice-id" } للأصوات المخصصة المتوافقة.محدد الصوت الأصلي للمزوّد لنماذج speech المتوافقة مع MiniMax.
تعليمات اختيارية للأسلوب أو الإلقاء لنماذج TTS المتوافقة مع OpenAI التي تدعمها.
Prompt اختياري لأسلوب الإلقاء في نماذج Gemini TTS.
رمز لغة اختياري، مثل
en-US، لمسارات Gemini وxAI وTTS المتوافقة.تنسيق الصوت. تشمل القيم الشائعة
mp3 وopus وaac وflac وwav وpcm؛ تختلف القيم المدعومة حسب عائلة النموذج.تنسيق التسليم في TokenLab:
audio أو sse. لا يدعم tts-1 وtts-1-hd القيمة stream_format=sse.سرعة الكلام لعائلات النماذج التي تدعمها (من 0.25 إلى 4.0).
درجة حرارة العينة لمسارات Gemini-compatible TTS (من 0 إلى 2).
الاستجابة
يعيد ملف الصوت بالتنسيق المطلوب.عينات الأصوات
| الصوت | الوصف |
|---|---|
alloy | محايد، متوازن |
ash | هادئ، متزن |
ballad | لحني، تعبيري |
coral | دافئ، جذاب |
echo | دافئ، حواري |
fable | تعبيري، سردي |
nova | ودود، واضح |
onyx | عميق، موثوق |
sage | حكيم، متأمل |
shimmer | ناعم، لطيف |
verse | ديناميكي، متعدد الاستخدامات |
مثال الاستجابة
حقول مهمة
نوع الحدث أو الرسالة الذي تعيده API.
جسم الاستجابة الخام. احفظه مباشرة ولا تحلله كـ JSON.