Voces

Voces de narración, sus vistas previas y el id a enviar. La voz es opcional: omítela y Sketchie narra con Nora.

El campo voice es opcional. Omítelo y Sketchie narra con Nora, la narradora cálida y polivalente por defecto. Fíjalo solo cuando quieras una voz distinta.

Descubre las voces

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

Llama al catálogo de voces para listar cada narrador. Cada voz vuelve con un name amigable para mostrar a tus usuarios, el id a pasar como voice, su language nativo, una bandera isDefault y un preview_url reproducible que puedes conectar directamente a un reproductor de audio.

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"
}

Pasa ?language=<code> para filtrar a voces nativas de un idioma. También puedes listar voces desde la CLI (sketchie voices) o el SDK (client.listVoices()). Muestra siempre el name amigable a tus usuarios y envía el id a la API.

El elenco de voces disponible

El catálogo actual contiene seis narradores cuidados: Nora, Miles, Dean, Clara, Piper y Wren. Estas voces son independientes del idioma, así que la misma voz elegida habla todos los idiomas listados por GET /v1/languages. Usa el id exacto que devuelve el catálogo de voces.

Usa el descubrimiento, no ids fijos. Lee el catálogo en tiempo de ejecución para que tu integración siga automáticamente las adiciones y cambios del elenco público.