Create custom voice
Creates a Custom Voice that can be added to an EVI configuration.
Refer to our voices guide for details on creating a custom voice.
Headers
X-Hume-Api-Key
Request
This endpoint expects an object.
name
The name of the Custom Voice. Maximum length of 75 characters. Will be converted to all-uppercase. (e.g., “sample voice” becomes “SAMPLE VOICE”)
base_voice
Specifies the base voice used to create the Custom Voice.
parameter_model
The name of the parameter model used to define which attributes are used by the parameters
field. Currently, only 20241004-11parameter
is supported as the parameter model.
Allowed values:
parameters
The specified attributes of a Custom Voice.
If no parameters are specified then all attributes will be set to their defaults, meaning no modfications will be made to the base voice.
Response
Created
id
Identifier for a Custom Voice. Formatted as a UUID.
version
Version number for a Custom Voice.
Custom Voices, Prompts, Configs, and Tools are versioned. This versioning system supports iterative development, allowing you to progressively refine configurations and revert to previous versions if needed.
Version numbers are integer values representing different iterations of the Custom Voice. Each update to the Custom Voice increments its version number.
name
The name of the Custom Voice. Maximum length of 75 characters.
created_on
Time at which the Custom Voice was created. Measured in seconds since the Unix epoch.
modified_on
Time at which the Custom Voice was last modified. Measured in seconds since the Unix epoch.
base_voice
The base voice used to create the Custom Voice.
parameter_model
The name of the parameter model used to define which attributes are used by the parameters
field. Currently, only 20241004-11parameter
is supported as the parameter model.
Allowed values:
parameters
The specified attributes of a Custom Voice. If a parameter’s value is 0
(default), it will not be included in the response.