TextToSpeech

List voices

Inworld TTS API reference: list available voices. Deprecated; use List voices in the Voice API for new integrations.

GET/tts/v1/voices

Authorizations

Authorizationstringrequired

Your authentication credentials. For Basic authentication, please populate Basic $INWORLD_API_KEY. You can create a key in one command with the Inworld CLI: inworld workspace add-key.

Query Parameters

filterstring

A filter expression to filter the voices. Currently, only the following filter is supported:

language: Expects an ISO 639-1 language code. For example, language=en.

Response

200 - application/json

voicesobject[]

The list of voices.

Show child attributes

languagesstring[]

The language of the original voice audio.

Speech synthesis will work best when the text matches the language of the original voice audio.

voiceIdstring

The ID of the voice.

displayNamestring

The display name of the voice.

descriptionstring

The description of the voice.

tagsstring[]

Tags associated with the voice.

isCustomboolean

Whether this voice is a custom voice created in your workspace (for example, a cloned voice).

List voices

curl --location 'https://api.inworld.ai/tts/v1/voices?filter=language%3Den' \
--header "Authorization: Basic $INWORLD_API_KEY"

successful_response

{
  "voices": [
    {
      "languages": [
        "en"
      ],
      "voiceId": "Alex",
      "displayName": "Alex",
      "isCustom": false,
      "description": "Energetic and expressive mid-range male voice, with a mildly nasal quality",
      "tags": [
        "male",
        "energetic",
        "expressive",
        "mid-range"
      ]
    },
    {
      "languages": [
        "en"
      ],
      "voiceId": "Ashley",
      "displayName": "Ashley",
      "isCustom": false,
      "description": "A warm, natural female voice",
      "tags": [
        "female",
        "warm",
        "natural"
      ]
    },
    {
      "languages": [
        "en"
      ],
      "voiceId": "Dennis",
      "displayName": "Dennis",
      "isCustom": false,
      "description": "Middle-aged man with a smooth, calm and friendly voice",
      "tags": [
        "male",
        "middle-aged",
        "smooth",
        "calm",
        "friendly"
      ]
    }
  ]
}