TextToSpeech

List voices

List all available voices based on the provided filter. > **⚠️ Deprecation Notice**: This endpoint is deprecated and may be removed in a future release. Use the [Voices API's List Voices](../../../api-reference/voiceAPI/voiceservice/list-voices) instead for new features and better performance.

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.

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