Skip to main content

نص الطلب

مهلة الطلبات المتزامنة: ينتظر هذا الـ 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 بدلًا من تجاهلها.
string
افتراضي:"tts-1"
نموذج TTS. تشمل الأمثلة tts-1 وgpt-4o-mini-tts وspeech-02-hd وgemini-2.5-flash-tts. استخدم GET /v1/models?recommended_for=tts للحصول على القائمة الحالية.
string
مطلوب
النص المطلوب إنشاء صوت له. الحد الأقصى 4096 حرفًا.
string | object
محدد الصوت. مرر اسم صوت مدمج مثل nova، أو صوت Gemini مثل Kore، أو كائنًا مثل { "id": "voice-id" } للأصوات المخصصة المتوافقة.
string
محدد الصوت الأصلي للمزوّد لنماذج speech المتوافقة مع MiniMax.
string
تعليمات اختيارية للأسلوب أو الإلقاء لنماذج TTS المتوافقة مع OpenAI التي تدعمها.
string
Prompt اختياري لأسلوب الإلقاء في نماذج Gemini TTS.
string
رمز لغة اختياري، مثل en-US، لمسارات Gemini وxAI وTTS المتوافقة.
string
تنسيق الصوت. تشمل القيم الشائعة mp3 وopus وaac وflac وwav وpcm؛ تختلف القيم المدعومة حسب عائلة النموذج.
string
افتراضي:"audio"
تنسيق التسليم في TokenLab: audio أو sse. لا يدعم tts-1 وtts-1-hd القيمة stream_format=sse.
number
سرعة الكلام لعائلات النماذج التي تدعمها (من 0.25 إلى 4.0).
number
درجة حرارة العينة لمسارات Gemini-compatible TTS (من 0 إلى 2).

الاستجابة

يعيد ملف الصوت بالتنسيق المطلوب.

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

مثال الاستجابة

حقول مهمة

string
نوع الحدث أو الرسالة الذي تعيده API.
binary
جسم الاستجابة الخام. احفظه مباشرة ولا تحلله كـ JSON.