وصفات

المشاعر وأسلوب الإلقاء

اجعل الصوت يبدو سعيدًا أو حزينًا، أو يهمس، أو يقرأ كمذيع أخبار، باستخدام وسوم في النص.

ضع وسمًا مثل [happy] قبل الكلمات. ترسل حزم SDK الحقل text دون تغيير، لذا تعمل الوسوم مع SDK الذي تستخدمه الآن. والوسم الذي لا يستطيع الصوت تطبيقه يُتخطى ولا يُنطق أبدًا.

تحقق من الصوت

في قائمة الأصوات، يسرد profile.emotions وprofile.styles ما يستطيعه كل صوت. وإذا غابا، فلا ترسل وسومًا. وتعيدهما حزم SDK في الإصدار 0.18.1، أو 0.19.0-beta.3 أو أحدث (في Python: الإصدار 0.18.1، أو 0.19.0b3 أو أحدث).

const [voice] = await client.listVoices({ timeoutSeconds: 5 });
const emotions = voice.profile?.emotions ?? [];
const styles = voice.profile?.styles ?? [];
console.log(voice.label, emotions, styles);

ضع الوسم في النص

غيّر text فقط في تشغيل الكلام أثناء البث:

const text = "[happy] I can't believe the results came in this morning.";

for await (const chunk of client.synthesizeStream(text, {
  voice_id: voice.id,
  model: TtsModel.Nebula,
  timeoutSeconds: 30,
})) {
  process.stdout.write(chunk.audio);
}

بدّل الأداء داخل طلب واحد

يسري كل وسم حتى الوسم التالي. وتُشغَّل الأجزاء واحدًا تلو الآخر في بث الصوت نفسه.

text
[news] Breaking news: the new terminal opens today. [storytelling] But for one traveller, it was the start of a long journey home. [happy] And she made it just in time!
[news] عاجل: افتتاح المبنى الجديد اليوم. [storytelling] لكن بالنسبة لمسافرة واحدة، كانت هذه بداية رحلة طويلة إلى الوطن. [happy] ووصلت في الوقت المناسب تماماً!

حدد أداءً ابتدائيًا (اختياري)

يحدد generation_config.emotion الأداء قبل الوسم الأول، وهو هنا news. ثم تبدّل الوسوم الأداء انطلاقًا منه.

طلب tts
{
  "id": "7f51f2c2-e7bc-41c8-a850-f848df2ddfc8",
  "model": "nebula",
  "voice_id": "42e38a63-849a-481a-b5bf-3c1b7a985de3",
  "text": "Good evening. [happy] And now, some good news.",
  "generation_config": { "emotion": "news" }
}

استمع إلى كل أداء

الصوت mul_nourah. تقرأ كل عاطفة الجملة نفسها: «لا أصدق أن النتائج وصلت هذا الصباح.» / «I can't believe the results came in this morning.»

العاطفةالوسماستمع
محايد (الافتراضي)لا يوجد
سعيد[happy]
حزين[sad]
غاضب[angry]
خائف[fearful]
متفاجئ[surprised]
همس[whisper]
الأسلوبالوسماستمع
نشرة أخبار · مساء الخير. استضافت الرياض اليوم القمة التقنية الإقليمية…[news]
سرد قصصي · في قديم الزمان، في قرية هادئة على شاطئ البحر…[storytelling]
إعلان · في نهاية هذا الأسبوع فقط، احصل على خصم عشرين بالمئة…[advertising]
مركز اتصال · شكراً لاتصالك. تم التحقق من حسابك…[call_center]
محادثة · بصراحة، ما كنت متأكد في البداية…[conversational]

قبل الإطلاق، راجع القواعد والقيود.

سيناريوهات

في هذه الصفحة