Skip to content

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. Currently only two voices are available: lily and terrence. Account scoped.

cursor(Optional) Pagination cursor.

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.

None

Examples

List All Available Voices

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

Response

Terminal window
{
"next": null,
"previous": null,
"results": [
{
"name": "lily",
"description": "Default Female",
"previewUrl": "https://zfmrfvimiaqahezndsse.supabase.co/storage/v1/object/public/ultravox-voice-previews/lily_preview.wav"
},
{
"name": "terrence",
"description": "Default Male",
"previewUrl": "https://zfmrfvimiaqahezndsse.supabase.co/storage/v1/object/public/ultravox-voice-previews/terrence_preview.wav"
}
]
}

Create (Clone) Voice

Terminal window
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

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