Голоса

Голоса озвучивания, их превью и 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. Читайте каталог во время выполнения, чтобы ваша интеграция автоматически подхватывала дополнения и изменения в публичном списке.