For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Start buildingGet support
DocumentationAPI ReferenceChangelogDiscord
  • Voices
    • POSTCreate voice
    • GETList voices
    • DELDelete voice
  • Text-to-Speech (TTS)
    • WSSStream Input
    • STREAMText-to-Speech (Streamed JSON)
    • POSTText-to-Speech (Streamed File)
    • POSTText-to-Speech (Json)
    • POSTText-to-Speech (File)
    • POSTVoice Conversion (Streamed File)
    • STREAMVoice Conversion (Streamed JSON)
  • Speech-to-speech (EVI)
    • WSSChat
  • Expression Measurement API
Start buildingGet support
LogoLogo
LogoLogo
Voices

Create voice

POST
https://api.hume.ai/v0/tts/voices
POST
/v0/tts/voices
$curl -X POST https://api.hume.ai/v0/tts/voices \
>     -H "X-Hume-Api-Key: <apiKey>" \
>     -H "Content-Type: application/json" \
>     -d '{
>  "generation_id": "",
>  "name": "David Hume"
>}'
1{
2  "id": "c42352c0-4566-455d-b180-0f654b65b525",
3  "name": "David Hume",
4  "provider": "CUSTOM_VOICE"
5}

Saves a new custom voice to your account using the specified TTS generation ID.

Once saved, this voice can be reused in subsequent TTS requests, ensuring consistent speech style and prosody. For more details on voice creation, see the Voices Guide.

Was this page helpful?

List voices

Next
Built with

Authentication

X-Hume-Api-Keystring
API Key authentication via header

Request

This endpoint expects an object.
generation_idstringRequired
A unique ID associated with this TTS generation that can be used as context for generating consistent speech style and prosody across multiple requests.
namestringRequired

The name of a Voice.

Response

Successful Response
idstring or nullformat: "uuid4"

The unique ID associated with the Voice.

namestring

The name of a Voice.

providerenum

Specifies the source provider associated with the chosen voice.

  • HUME_AI: Select voices from Hume’s Voice Library, containing a variety of preset, shared voices.
  • CUSTOM_VOICE: Select from voices you’ve personally generated and saved in your account.

If no provider is explicitly set, the default provider is CUSTOM_VOICE. When using voices from Hume’s Voice Library, you must explicitly set the provider to HUME_AI.

Preset voices from Hume’s Voice Library are accessible by all users. In contrast, your custom voices are private and accessible only via requests authenticated with your API key.

Allowed values:

Errors

422
Unprocessable Entity Error