Voices

Narration voices, their previews, and the id to send. Voice is optional: leave it out and Sketchie narrates with Nora.

The voice field is optional. Leave it out and Sketchie narrates with Nora, the warm all-purpose default narrator. Set it only when you want a different voice.

Discover the voices

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

Call the voice catalog to list every narrator. Each voice comes back with a friendly name to show your users, the id to pass as voice, its native language, an isDefault flag, and a playable preview_url you can wire straight into an audio player.

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

Pass ?language=<code> to filter to voices native to a language. You can also list voices from the CLI (sketchie voices) or the SDK (client.listVoices()). Always show the friendly name to your users, and send the id to the API.

The shipped voice roster

The current catalog contains six curated narrators: Nora, Miles, Dean, Clara, Piper, and Wren. These voices are language-agnostic, so the same selected voice speaks every language listed by GET /v1/languages. Use the exact id returned by the voice catalog.

Use discovery, not hard-coded ids. Read the catalog at runtime so your integration automatically follows additions and changes to the public roster.