Голоси

Голоси озвучення, їхні превью та id для надсилання. Голос необов’язковий: пропустіть його, і 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, який повертає каталог голосів.

Використовуйте виявлення, а не жорстко закодовані id. Читайте каталог під час виконання, щоб ваша інтеграція автоматично враховувала додавання та зміни в публічному складі.