Voices

Create voice

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.

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](https://app.hume.ai/voices), 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