Voices API

Get available TTS Voices for use across the application, without tying the client to a specific provider.

Endpoints

1. Identify Available Voices

GET /api/v1/voices

Returns a list of voices currently available in the Sketchpen workspace regardless of the active TTS provider.

Response

json

{
  "voices": [
    {
      "id": "21m00Tcm4TlvDq8ikWAM",
      "name": "Rachel",
      "description": "American, Narration",
      "tags": ["female", "american"],
      "preview_url": "https://example.com/audio.mp3"
    }
  ]
}

Using Voices

When creating components that require voice mapping:

Characters

When creating a character (Object type character), provide a valid voice_id from the list.

Videos

When creating a new Video script that does not involve explicit characters, you can optionally provide a voice_id to establish the default narrator voice for the video content.