الأصوات

أصوات السرد ومعايناتها والمعرّف المطلوب إرساله. الصوت اختياري: احذفه ليسرد Sketchie بصوت Nora.

حقل voice اختياري. احذفه ليسرد Sketchie بصوت Nora، الراوية الافتراضية الدافئة والمتعددة الاستخدامات. لا تضبطه إلا عندما ترغب بصوت مختلف.

اكتشف الأصوات

GET https://sketchie.ai/api/v1/voices

استدعِ كتالوج الأصوات لعرض جميع الرواة. يعود كل صوت مصحوبًا بـname واضح لعرضه على مستخدميك، وid لتمريره في voice، وlanguage الأصلية، وعلامة isDefault، وpreview_url قابل للتشغيل يمكنك ربطه مباشرةً بمشغّل صوت.

200 OK

{
  "voices": [
    {
      "id": "sketchie:sulafat",
      "name": "Nora",
      "language": "en",
      "description": "Warm and natural, like a favorite teacher.",
      "isDefault": true,
      "preview_url": "https://sketchie.ai/media/voice-previews/sulafat.mp3"
    }
  ],
  "default": "sketchie:sulafat"
}

مرّر ?language=<code> لتصفية الأصوات الأصلية للغة معينة. يمكنك أيضًا عرض الأصوات من CLI (sketchie voices) أو SDK (client.listVoices()). اعرض دائمًا name الواضح على مستخدميك، وأرسل id إلى الـAPI.

قائمة الأصوات المتوفرة

يضم الكتالوج الحالي ستة رواة منتقين: Nora وMiles وDean وClara وPiper وWren. هذه الأصوات مستقلة عن اللغة، لذا ينطق الصوت نفسه المختار بكل لغة يدرجها GET /v1/languages. استخدم id الدقيق الذي يعيده كتالوج الأصوات.

استخدم الاكتشاف بدلاً من المعرّفات المضمّنة يدويًا. اقرأ الكتالوج أثناء التشغيل حتى يواكب تكاملك تلقائيًا الإضافات والتغييرات في القائمة العامة.