Vozes

Vozes de narração, suas prévias e o id a enviar. A voz é opcional: omita e a Sketchie narra com a Nora.

O campo voice é opcional. Omita e a Sketchie narra com a Nora, a narradora calorosa e versátil padrão. Defina só quando quiser uma voz diferente.

Descubra as vozes

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

Chame o catálogo de vozes para listar cada narrador. Cada voz volta com um name amigável para mostrar aos seus usuários, o id para passar como voice, seu language nativo, uma flag isDefault e um preview_url reproduzível que você conecta direto num player de áudio.

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

Passe ?language=<code> para filtrar por vozes nativas de um idioma. Você também pode listar vozes pela CLI (sketchie voices) ou pelo SDK (client.listVoices()). Sempre mostre o name amigável aos seus usuários e envie o id para a API.

O elenco de vozes disponível

O catálogo atual contém seis narradores selecionados: Nora, Miles, Dean, Clara, Piper e Wren. Essas vozes são independentes de idioma, então a mesma voz escolhida fala todos os idiomas listados por GET /v1/languages. Use o id exato retornado pelo catálogo de vozes.

Use a descoberta, não ids fixos. Leia o catálogo em tempo de execução para que sua integração siga automaticamente as adições e mudanças do elenco público.