Voice List API

API to retrieve the full list of voices, both public and private, available to a user.

Last updated 15 days ago

Convai's Voice List API endpoint

GET https://api.convai.com/tts/get_available_voices

This endpoint is called to get the list of available voices for a user. The voice list includes information regarding all the public as well as users' private voices.

Request

The request body only requires the following header field :

Headers

Field Name

Type

Value / Description

Response

On success, the API will return a nested JSON object in the following format :

{
    "<Section Name#1>" : [
        {
            "<Voice Name #1>" : {
                "voice_value" : "voice_value_for_voice#1",
                "lang_codes"  : [<list of language codes, supported by the voice>],
                "gender"      : "<MALE/FEMALE>",
                "sample_link" : <link to the voice sample file>
            }
        },
        
        {
            "<Voice Name #2>" : {
                "voice_value" : "voice_value_for_voice#2",
                "lang_codes"  : [<list of language codes, supported by the voice>],
                "gender"      : "<MALE/FEMALE>",
                "sample_link" : <link to the voice sample file>
            }
        },
        ...
    ]
}

Response Field Descriptions

Section Name : The name of the section under which the voice is available (in the Convai Playground). Eg : Azure Voices , Elevenlabs Voices , GCP Voices , Convai Voices etc.
Voice Name : The name of the voice that is visible to the user on the Convai Playground.
voice_value : The unique id for the voice, uniquely identifying the voices. This is the value that needs to be sent to the backend while setting / updating the voice for the character.
lang_codes : List of languages supported by the voice.
gender : Gender of the voice (MALE/FEMALE).
sample_link : The link to the voice sample audio file.

Sample Code Snippet

import requests

# URL of the API endpoint
url = 'https://api.convai.com/tts/get_available_voices'

# creating the header
headers = {
     'CONVAI-API-KEY': '<your api key>',
}

# Make the request
response = requests.get(url, headers=headers)

# Check if the request was successful
if response.status_code == 200:
    # Print the response content
    print(response.json())
else:
    print(f"Failed to retrieve data. Status code: {response.status_code}")

Sample Response


{
  "Azure Voices": [
    {
      "Female Cantonese Voice": {
        "voice_value": "HiuManNeural2",
        "lang_codes": [
          "zh-HK"
        ],
        "gender": "FEMALE",
        "deployment_env": [
          "PRODUCTION",
          "DEVELOPMENT"
        ],
        "sample_link": "https://storage.googleapis.com/voice-samples-eg/HiuManNeuralzh_sampleVoice.wav"
      }
    },...
    ],
  "Elevenlabs Voices": [
      {
        "Elli (Middle-aged US Feminine Voice)": {
          "voice_value": "Elli-en",
          "lang_codes": [
            "en-US",
            "fi-FI",
            "sk-SK",
            "cs-CZ"
          ],
          "gender": "FEMALE",
          "deployment_env": [
            "PRODUCTION",
            "DEVELOPMENT"
          ],
          "sample_link": "https://storage.googleapis.com/voice-samples-eg/Elli-en-US_sampleVoice.wav"
        }
      },...
      ],
      ...
}

Voice Master List

List of currently available public voices :