Voices

API Key Required

The Ultravox API requires an API key. For more details see Authentication.

Your AI can speak to your end users in different voices. At the moment we only support two voices but we have plans to build this out soon. Please let us know what types of voices you need for your apps.

List Voices

GET /voices

Lists all available voices. Includes voices that are provided by the Ultravox service along with any voices you have created.

Parameters

cursor	(Optional) Pagination cursor.

Request Body

None

Response

name	string	The name of the voice. This is the value to pass in for voice when creating a call.
description	string	Text description for the voice.
previewUrl	string	URL for an audio preview of the voice.

Create (Clone) Voice

POST /voices

Create a new cloned voice. Any created voices are private to your account.

Uses multipart/form-data encoding to provide the name of the voice along with an audio file containing the voice to be used for cloning.

Parameters

None

Request Body

file required	audio file	A file that contains the audio to use for creating the cloned voice.
name required	string	The name of the voice. Can contain letters, numbers, underscore, or hyphen. Maximum of 64 characters.
description	string	(Optional) Description for the voice.

Response

voice_id	string	UUID for the created voice. Pass in as voice when creating a new call to use this voice.
name	string	The name of the voice. This is the value to pass in for voice when creating a call.
description	string	Text description for the voice.
previewUrl	string	URL for an audio preview of the voice. Currently always null for cloned voices.

Examples

List All Available Voices

cURL

curl --request GET \
--url https://api.ultravox.ai/api/voices \
--header 'X-API-Key: aBCDef.123456'

JavaScript

fetch('https://api.ultravox.ai/api/voices', {
  method: 'GET',
  headers: {
    'X-API-Key': 'aBCDef.123456'
  }
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));

Response

cURL

{
  "next": null,
  "previous": null,
  "results": [
    {
        "voiceId": "8b79b46f-3b1c-4280-9521-2cac1b6eabd5",
        "name": "Maya-Chinese",
        "description": "",
        "previewUrl": "https://storage.googleapis.com/eleven-public-prod/database/user/9axODppOpDadFfxEDFYygFROdkh2/voices/GgmlugwQ4LYXBbEXENWm/AP0YhlW1zVxV5sXFTGF3.mp3"
    },
    {
        "voiceId": "91fa9bcf-93c8-467c-8b29-973720e3f167",
        "name": "Mark",
        "description": "",
        "previewUrl": "https://storage.googleapis.com/eleven-public-prod/database/user/y7Wmp2r8nCeGkLiXiwMOVWktro13/voices/UgBBYS2sOqTuMpoF3BR0/0Oc7jiXwWN9kRTXfQsmw.mp3"
    },
    ...
  ]
}

JavaScript

{
  "next": null,
  "previous": null,
  "results": [
    {
        "voiceId": "8b79b46f-3b1c-4280-9521-2cac1b6eabd5",
        "name": "Maya-Chinese",
        "description": "",
        "previewUrl": "https://storage.googleapis.com/eleven-public-prod/database/user/9axODppOpDadFfxEDFYygFROdkh2/voices/GgmlugwQ4LYXBbEXENWm/AP0YhlW1zVxV5sXFTGF3.mp3"
    },
    {
        "voiceId": "91fa9bcf-93c8-467c-8b29-973720e3f167",
        "name": "Mark",
        "description": "",
        "previewUrl": "https://storage.googleapis.com/eleven-public-prod/database/user/y7Wmp2r8nCeGkLiXiwMOVWktro13/voices/UgBBYS2sOqTuMpoF3BR0/0Oc7jiXwWN9kRTXfQsmw.mp3"
    },
    ...
  ]
}

Create (Clone) Voice

cURL

curl -X POST -F "file=@./myvoice.mp3;type=audio/mpeg" \
-F "name=My-Cloned-Voice" -F "description=I am now a robot." \
--url https://api.ultravox.ai/api/voices \
--header 'X-API-Key: aBCDef.123456'

Response

cURL

{
  "voiceId": "d90c9fff-5aad-1578-ced9-d8eg99aa4a0b",
  "name": "My-Cloned-Voice",
  "description": "I am now a robot.",
  "previewUrl": null
}