curl --request POST \
--url https://api.ultravox.ai/api/voices \
--header 'Content-Type: multipart/form-data' \
--header 'X-API-Key: <your-api-key>' \
--form 'file=@/path/to/voice.mp3' \
--form 'name=My Custom Voice' \
--form 'description=Voice recorded on Jan 1, 2024'
{
  "voiceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "description": "<string>",
  "primaryLanguage": "<string>",
  "previewUrl": "<string>",
  "ownership": "public",
  "billingStyle": "VOICE_BILLING_STYLE_INCLUDED",
  "definition": {
    "elevenLabs": {
      "voiceId": "<string>",
      "model": "<string>",
      "speed": 123,
      "useSpeakerBoost": true,
      "style": 123,
      "similarityBoost": 123,
      "stability": 123,
      "pronunciationDictionaries": [
        {
          "dictionaryId": "<string>",
          "versionId": "<string>"
        }
      ],
      "optimizeStreamingLatency": 123,
      "maxSampleRate": 123
    },
    "cartesia": {
      "voiceId": "<string>",
      "model": "<string>",
      "speed": 123,
      "emotion": "<string>",
      "emotions": [
        "<string>"
      ]
    },
    "lmnt": {
      "voiceId": "<string>",
      "model": "<string>",
      "speed": 123,
      "conversational": true
    },
    "generic": {
      "url": "<string>",
      "headers": {},
      "body": {},
      "responseSampleRate": 123,
      "responseWordsPerMinute": 123,
      "responseMimeType": "<string>",
      "jsonAudioFieldPath": "<string>"
    }
  }
}
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.
Currently, we support one cloned voice per account. If you need more cloned voices, please reach out.

Authorizations

​
X-API-Key
string
header
required

API key

Body

Response

201 - application/json

The response is of type object.