Voci

Voci di narrazione, le loro anteprime e l’id da inviare. La voce è opzionale: omettila e Sketchie narra con Nora.

Il campo voice è opzionale. Omettilo e Sketchie narra con Nora, la narratrice calda e versatile predefinita. Impostalo solo quando vuoi una voce diversa.

Scopri le voci

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

Chiama il catalogo delle voci per elencare ogni narratore. Ogni voce torna con un name comodo da mostrare ai tuoi utenti, l’id da passare come voice, la sua language nativa, un flag isDefault e un preview_url riproducibile che colleghi direttamente a un player 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"
}

Passa ?language=<code> per filtrare le voci native di una lingua. Puoi anche elencare le voci dalla CLI (sketchie voices) o dall’SDK (client.listVoices()). Mostra sempre il name comodo ai tuoi utenti e invia l’id all’API.

Il cast di voci disponibile

Il catalogo attuale contiene sei narratori curati: Nora, Miles, Dean, Clara, Piper e Wren. Queste voci sono indipendenti dalla lingua, così la stessa voce scelta parla ogni lingua elencata da GET /v1/languages. Usa l’id esatto restituito dal catalogo delle voci.

Usa la discovery, non id fissi. Leggi il catalogo a runtime così la tua integrazione segue automaticamente aggiunte e modifiche del cast pubblico.