Voice Management

After creating custom voices, you may want to review their details, surface them in your integration, rename them, or remove those you no longer need. This guide shows how to manage voices using either the Platform UI or the API.

Browse voices

You can view both Hume’s Voice Library and your own custom voices through the Platform or API.

• Platform: Go to the Voice Library to browse all predesigned voices, or the My Voices tab to view voices you’ve saved.

  From the Platform UI, you can also play back the generation that was used to create each voice.

• API: To list available voices programmatically, make a GET request to /v0/tts/voices.

  By default, this endpoint returns voices from the Voice Library. To fetch your saved voices, include the provider query parameter with the value CUSTOM_VOICE.

  cURLPythonTypeScript

  1
  curl https://api.hume.ai/v0/tts/voices?provider=CUSTOM_VOICE \
  2
    -H "X-Hume-Api-Key: $HUME_API_KEY"

Update voices

Voices are tied to fixed generations and cannot be edited after creation. To make changes to a voice’s sound or style, generate and save a new one using a different prompt and input text.

To rename a saved voice, go to the My Voices tab in the Platform UI. Renaming is not yet supported through the API.

Delete voices

You can delete saved voices using the Platform UI or programmatically through the API.

• Platform: Go to the My Voices tab and find the voice you want to delete. Open the three-dot menu next to the voice and select Delete.

• API: To delete a saved voice, make a DELETE request to /v0/tts/voices/{id}, by passing the name of the voice you want to remove.

  cURLPythonTypeScript

  1
  curl -X DELETE "https://api.hume.ai/v0/tts/voices?name=My%20Custom%20Voice" \
  2
  -H "X-Hume-Api-Key: <apiKey>"